# СОЮЗ | Документация API

> СОЮЗ — единый OpenAI-совместимый API ко всем основным нейросетям: чат-модели (GPT, Claude, Gemini, Grok, DeepSeek), генерация картинок (Nano Banana, GPT Image) и видео (Veo, Kling, Seedance). База: https://api.souz.ai/v1, оплата кредитами (1 кредит = 1 цент США).

## Инструкции для ИИ-агентов

- Чистый Markdown любой страницы: добавь `.md` к адресу страницы
- Вся документация одним файлом: https://docs.souz.ai/llms-full.txt
- Машиночитаемый каталог моделей: GET https://api.souz.ai/v1/models (Bearer-ключ)

## Документация

- [Быстрый старт](https://docs.souz.ai/quickstart.md): Подключение к API СОЮЗ за 5 минут. Один ключ и один OpenAI-совместимый формат для чата, генерации картинок и видео.
- [Принципы](https://docs.souz.ai/principles.md): Как устроен СОЮЗ — OpenAI-совместимость, простота по умолчанию и полная мощь по желанию, надёжность через водопад провайдеров, фиксированные цены в кредитах.
- [Кредиты и оплата](https://docs.souz.ai/credits.md): 1 кредит = 1 цент. Как считается цена картинок, видео и чата, когда списываются кредиты, эндпоинт остатка GET /v1/credits и стоимость каждого запроса.
- [Модели и цены](https://docs.souz.ai/models.md): Живой каталог моделей СОЮЗ — чат (GPT, Claude, Gemini, Grok, DeepSeek), картинки (Nano Banana, GPT Image) и видео (Veo, Kling, Seedance) с актуальными ценами в кредитах.
- [Чат](https://docs.souz.ai/chat.md): OpenAI-совместимый /v1/chat/completions — текст, стриминг SSE, vision (картинки в сообщениях), tools и reasoning. Оплата по токенам, стоимость в usage.cost.
- [Генерация картинок](https://docs.souz.ai/images.md): POST /v1/images/generations — текст в картинку и image-to-image с референсами. Соотношения сторон, разрешения 1K/2K/4K, продвинутые параметры моделей.
- [Генерация видео](https://docs.souz.ai/videos.md): POST /v1/videos/generations — текст или картинка в видео. Veo, Kling, Seedance. Длительность, режимы качества, звук, оживление картинок.
- [Джобы и результаты](https://docs.souz.ai/jobs.md): Жизненный цикл асинхронных задач — статусы queued/in_progress/completed/failed, опрос GET /v1/jobs/{id}, подписанные ссылки на файлы, хранение ~24 часа.
- [Вебхуки](https://docs.souz.ai/webhooks.md): Получай результаты генерации без опроса — POST на твой URL при завершении джобы. HMAC-подпись Souz-Signature, повторы доставки, callback_url на один запрос.
- [Ошибки](https://docs.souz.ai/errors.md): Единый формат ошибок API СОЮЗ — JSON с code/message/type, таблица HTTP-статусов и кодов, терминальные ошибки джоб, что ретраить, а что нет.
- [Лимиты](https://docs.souz.ai/limits.md): Лимиты API СОЮЗ — частота запросов 100/мин на ключ (повышается по запросу), размеры и форматы загружаемых картинок, длина промптов, лимиты тела запроса.
- [Справочник API](https://docs.souz.ai/api-reference.md): Все эндпоинты API СОЮЗ на одной странице — аутентификация, модели, чат, картинки, видео, джобы, файлы, вебхуки. Параметры, форматы ответов, коды ошибок.