Лимиты

Частота запросов

100 запросов в минуту на API-ключ по умолчанию (token bucket: короткие всплески допускаются, средняя — 100/мин). Лимит — индивидуальный на каждый ключ: текущее значение видно в дашборде на странице ключей и в GET /v1/credits (rate_limit.requests_per_minute).

При превышении — 429 rate_limited с заголовком Retry-After (секунды до следующей попытки):

HTTP 429
Retry-After: 2
{ "error": { "code": "rate_limited", "message": "too many requests" } }

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

Загружаемые картинки (референсы и vision)

Принимаем PNG, JPEG, WEBP, HEIC — сервер сам конвертирует в формат, который понимает провайдер выбранной модели (фото с iPhone работают без танцев).

Что	Картиночные модели	Видео-модели
Макс. размер файла	до 50 МБ*	до 10 МБ
Промпт	до 32 000 символов*	до 5 000 символов
Кол-во референсов	по модели (до 14–16)	по модели (обычно 1–2)

* — точные значения зависят от модели: смотри limits у каждой модели в GET /v1/models (поля max_prompt_chars, max_image_mb, image_formats). Мы всегда показываем «минимальную планку» по самому строгому провайдеру модели — то, что точно пройдёт.

GIF и SVG не принимаются.

Чат

• Тело запроса — до 25 МБ (vision-картинки едут внутри JSON как data URL).
• Контекст и максимум токенов — по выбранной модели.

Джобы

• Потолок генерации картинок — 15 минут, видео — 90 минут (с большим запасом от реальных времён: обычная картинка — секунды, тяжёлая — до пары минут). Если провайдер завис — джоба завершается failed: model_unavailable с возвратом кредитов, бесконечного queued не бывает.
• Если апстрим-провайдер не отвечает, СОЮЗ сам переключается на резервного — клиент этого не видит и получает completed.
• Результаты хранятся ~24 часа — дальше 410 file_expired. Скачивай сразу.

Проверить лимиты модели

curl https://api.souz.ai/v1/models -H "Authorization: Bearer sk-souz-..."

{
  "id": "souz/kling-3",
  "modality": "video",
  "limits": { "max_prompt_chars": 5000, "max_image_mb": 10, "image_formats": ["png", "jpeg", "webp", "heic"] }
}