Быстрый старт
1. Получите ключ
Войдите на souz.ai через Яндекс, GitHub, Google или Telegram: первый вход создаёт аккаунт с приветственным бонусом. Создайте ключ в разделе «API-ключи»:
Терминал
export SOUZ_API_KEY="sk_..."2. Отправьте запрос
curl https://api.souz.ai/v1/chat/completions \
-H "Authorization: Bearer $SOUZ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model": "gpt-5-nano", "messages": [{"role": "user", "content": "Привет!"}]}'import os
from openai import OpenAI
client = OpenAI(base_url="https://api.souz.ai/v1", api_key=os.environ["SOUZ_API_KEY"])
chat = client.chat.completions.create(
model="gpt-5-nano",
messages=[{"role": "user", "content": "Привет!"}],
)
print(chat.choices[0].message.content)import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.souz.ai/v1", apiKey: process.env.SOUZ_API_KEY });
const chat = await client.chat.completions.create({
model: "gpt-5-nano",
messages: [{ role: "user", content: "Привет!" }],
});
console.log(chat.choices[0].message.content);В ответе: usage.cost — списано (микроединицы usage.currency), channel — канал запроса.
3. Сгенерируйте картинку
Ответ — объект задачи со ссылкой на файл:
curl https://api.souz.ai/v1/images/generations \
-H "Authorization: Bearer $SOUZ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model": "nano-banana-pro", "prompt": "кот-космонавт на Луне", "aspect_ratio": "1:1"}'image = client.images.generate(model="nano-banana-pro", prompt="кот-космонавт на Луне", size="1024x1024")
print(image.data[0].url)const image = await client.images.generate({ model: "nano-banana-pro", prompt: "кот-космонавт на Луне", size: "1024x1024" });
console.log(image.data?.[0]?.url);JSON
{
"id": "job_1a2b3c4d5e6f",
"object": "job",
"created": 1758801600,
"created_at": "2026-09-25T12:00:00Z",
"completed_at": "2026-09-25T12:00:09Z",
"model": "nano-banana-pro",
"modality": "image",
"status": "completed",
"routing": "balanced",
"max_price_multiplier": null,
"routing_options": null,
"attempt_count": 1,
"price": 5000000,
"currency": "RUB",
"usage": null,
"data": [
{
"id": "file_9f8e7d6c5b4a",
"object": "file",
"kind": "result",
"type": "image",
"role": "result",
"url": "https://media.souz.ai/v1/files/file_9f8e7d6c5b4a/souz_nano-banana-pro_9f8e7d6c.jpg?exp=1759406409&sig=abc",
"content_type": "image/jpeg",
"bytes": 618240,
"width": 1024,
"height": 1024,
"filename": "souz_nano-banana-pro_9f8e7d6c.jpg",
"created_at": "2026-09-25T12:00:09Z",
"expires_at": "2026-10-02T12:00:09Z",
"expired": false
}
],
"error": null
}Ссылка живёт сутки (Файлы).
Что дальше
- Выбрать модель и узнать её поля — Модели и каталог.
- Видео и другие долгие генерации — Задачи и долгие операции.
- Управлять ценой и скоростью — Авто-роутинг и пресеты.
- Подключить агента — MCP-сервер.