# Справочник API

Методы публичного API СОЮЗа по разделам. Контракт целиком — OpenAPI 2026-09-23: https://api.souz.ai/openapi.json (YAML — https://api.souz.ai/openapi.yaml). У каждого метода есть страница в Markdown: адрес, параметры, поля тела, пример запроса и ответы.

## Чат

Чат, совместимый с OpenAI Chat Completions.

- [POST /v1/chat/completions](https://souz.ai/docs/api-reference/create-chat-completion.md) — Ответ чат-модели

## Картинки

Картинки.

- [POST /v1/images/generations](https://souz.ai/docs/api-reference/create-image.md) — Сгенерировать картинку

## Видео

Видео.

- [POST /v1/videos](https://souz.ai/docs/api-reference/create-video.md) — Сгенерировать видео
- [GET /v1/videos/{id}](https://souz.ai/docs/api-reference/get-video.md) — Видео-задача по id

## Аудио

Транскрибация и синтез речи.

- [POST /v1/audio/generations](https://souz.ai/docs/api-reference/create-music.md) — Сгенерировать музыку
- [POST /v1/audio/speech](https://souz.ai/docs/api-reference/create-speech.md) — Озвучить текст
- [POST /v1/audio/transcriptions](https://souz.ai/docs/api-reference/create-transcription.md) — Расшифровать звук

## Задачи

Задачи — состояние, результат, поток событий.

- [GET /v1/jobs/{id}](https://souz.ai/docs/api-reference/get-job.md) — Задача по id
- [GET /v1/jobs/{id}/events](https://souz.ai/docs/api-reference/stream-job-events.md) — Поток событий задачи

## Файлы

Файлы — загрузка референсов и результаты со сроком жизни.

- [GET /v1/files](https://souz.ai/docs/api-reference/list-files.md) — Файлы аккаунта
- [POST /v1/files](https://souz.ai/docs/api-reference/upload-file.md) — Загрузить файл
- [GET /v1/files/{id}](https://souz.ai/docs/api-reference/get-file.md) — Файл по id
- [DELETE /v1/files/{id}](https://souz.ai/docs/api-reference/delete-file.md) — Удалить файл
- [GET /v1/files/{id}/{filename}](https://souz.ai/docs/api-reference/download-file.md) — Байты файла по подписанной ссылке

## Модели и каналы

Каталог моделей — без ключа.

- [GET /v1/channels](https://souz.ai/docs/api-reference/list-channel-palette.md) — Палитра цветов каналов
- [GET /v1/models](https://souz.ai/docs/api-reference/list-models.md) — Каталог моделей
- [GET /v1/models/{id}](https://souz.ai/docs/api-reference/get-model.md) — Карточка модели
- [GET /v1/models/{id}/channels](https://souz.ai/docs/api-reference/get-model-channels.md) — Цветовые каналы модели
- [POST /v1/models/{id}/routing/preview](https://souz.ai/docs/api-reference/preview-model-routing.md) — Предварительный выбор каналов
- [GET /v1/models/{id}/stats](https://souz.ai/docs/api-reference/get-model-stats.md) — Статистика модели за 7 дней

## Ключ

Ключ, которым сделан запрос.

- [GET /v1/key](https://souz.ai/docs/api-reference/get-key.md) — Ключ, которым сделан запрос

## status

Состояние сервиса и плановые работы — без ключа.

- [GET /v1/status](https://souz.ai/docs/api-reference/get-service-status.md) — Идут ли плановые работы

## Вебхуки

Секрет подписи вебхуков.

- [GET /v1/webhooks/secret](https://souz.ai/docs/api-reference/get-webhook-secret.md) — Секрет подписи вебхуков
- [POST /v1/webhooks/secret/rotate](https://souz.ai/docs/api-reference/rotate-webhook-secret.md) — Выпустить новый секрет

## Аккаунт

Аккаунт по ключу управления: кто я, баланс, история операций и запросов, расходы, обычные ключи, настройки аккаунта (в том числе закрепление каналов) — то же, что держатель ключа видит и может в кабинете.

- [GET /v1/auth/me](https://souz.ai/docs/api-reference/get-me.md) — Кто я
- [GET /v1/balance](https://souz.ai/docs/api-reference/get-balance.md) — Баланс аккаунта
- [GET /v1/balance/history](https://souz.ai/docs/api-reference/list-balance-history.md) — История операций по балансу
- [GET /v1/keys](https://souz.ai/docs/api-reference/list-api-keys.md) — Список своих API-ключей
- [POST /v1/keys](https://souz.ai/docs/api-reference/create-api-key.md) — Создать API-ключ
- [PATCH /v1/keys/{id}](https://souz.ai/docs/api-reference/update-api-key.md) — Изменить свой API-ключ
- [DELETE /v1/keys/{id}](https://souz.ai/docs/api-reference/revoke-api-key.md) — Отозвать свой API-ключ
- [GET /v1/keys/{id}/secret](https://souz.ai/docs/api-reference/reveal-api-key.md) — Секрет своего API-ключа
- [GET /v1/settings](https://souz.ai/docs/api-reference/get-settings.md) — Настройки аккаунта
- [PATCH /v1/settings](https://souz.ai/docs/api-reference/update-settings.md) — Изменить настройки аккаунта
- [GET /v1/usage](https://souz.ai/docs/api-reference/list-usage.md) — Свои запросы
- [GET /v1/usage/summary](https://souz.ai/docs/api-reference/list-usage-summary.md) — Сводная аналитика использования
- [GET /v1/usage/{id}](https://souz.ai/docs/api-reference/get-usage-job.md) — Детали своего запроса

## Документы

Документация для людей и агентов — без ключа.

- [GET /](https://souz.ai/docs/api-reference/get-index.md) — Где что лежит
- [GET /llms-full.txt](https://souz.ai/docs/api-reference/get-ll-ms-full-txt.md) — Руководство и эта спецификация одним файлом
- [GET /llms.txt](https://souz.ai/docs/api-reference/get-ll-ms-txt.md) — Короткий индекс для языковых моделей
- [GET /openapi.json](https://souz.ai/docs/api-reference/get-open-apijson.md) — Эта спецификация (JSON)
- [GET /openapi.yaml](https://souz.ai/docs/api-reference/get-open-apiyaml.md) — Эта спецификация (YAML)

## MCP

Сервер Model Context Protocol для агентов: те же ручки API инструментами — каталог, каналы и их сравнение, превью выбора, закрепление канала, чат и задачи.

- [POST /mcp](https://souz.ai/docs/api-reference/send-mcp-message.md) — Сообщение MCP-серверу

## Входящие вебхуки

- [POST job.completed](https://souz.ai/docs/api-reference/webhook-job-completed.md) — Задача завершилась
- [POST job.failed](https://souz.ai/docs/api-reference/webhook-job-failed.md) — Задача не удалась

---

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