Быстрый старт

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": "Привет!"}]}'

В ответе: 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"}'
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
}

Ссылка живёт сутки (Файлы).

Что дальше