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

## 1. Получите ключ

Войдите на [souz.ai](https://souz.ai) через Яндекс, GitHub, Google или Telegram: первый вход
создаёт аккаунт с приветственным бонусом. Создайте ключ в разделе «API-ключи»:

```bash
export SOUZ_API_KEY="sk_..."
```

## 2. Отправьте запрос

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

```python tab="Python"
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)
```

```ts tab="TypeScript"
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. Сгенерируйте картинку

Ответ — объект задачи со ссылкой на файл:

```bash tab="cURL"
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"}'
```

```python tab="Python"
image = client.images.generate(model="nano-banana-pro", prompt="кот-космонавт на Луне", size="1024x1024")
print(image.data[0].url)
```

```ts tab="TypeScript"
const image = await client.images.generate({ model: "nano-banana-pro", prompt: "кот-космонавт на Луне", size: "1024x1024" });
console.log(image.data?.[0]?.url);
```

<!-- openapi: #/components/schemas/Job -->
```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
}
```

Ссылка живёт сутки ([Файлы](https://souz.ai/docs/files.md)).

## Что дальше

- Выбрать модель и узнать её поля — [Модели и каталог](https://souz.ai/docs/models.md).
- Видео и другие долгие генерации — [Задачи и долгие операции](https://souz.ai/docs/jobs.md).
- Управлять ценой и скоростью — [Авто-роутинг и пресеты](https://souz.ai/docs/routing.md).
- Подключить агента — [MCP-сервер](https://souz.ai/docs/mcp.md).

---

Оглавление документации: https://souz.ai/llms.txt. Всё руководство одним файлом: https://souz.ai/llms-full.txt. Справочник методов: https://souz.ai/docs/api-reference.md.