Ошибки

Коды ошибок и что с ними делать.

Ошибка запроса — JSON с кодом и понятным текстом:

json

{ "error": { "code": "invalid_request", "message": "Поле «duration» не больше 30.", "field": "duration" } }

Решения принимайте по code, текст — для людей.

HTTP	code	Что делать
400	`invalid_request`, `invalid_json`	Исправить запрос: поле указано в `field`.
401	`unauthorized`	Проверить ключ.
402	`insufficient_balance`	Пополнить баланс.
402	`key_limit_reached`	Поднять месячный лимит ключа или взять другой ключ.
403	`account_suspended`	Написать в поддержку.
404	`not_found`, `unknown_endpoint`	Проверить id или адрес режима.
409	`idempotency_conflict`, `draft_in_progress`	Повторить позже.
410	`draft_expired`	Срок доводки черновика истёк.
429	`concurrency_limit`	Дождаться завершения запросов в работе.
413	`invalid_request`	Тело запроса больше 1 МБ — файлы передавайте ссылками.
429	`rate_limited`	Повторить через `Retry-After` секунд.
500	`internal_error`	Повторить с тем же `Idempotency-Key`.
503	`model_unavailable`	Модель временно недоступна — позже или другая модель.

Ошибки генерации

Запрос, принятый в работу, может завершиться статусом failed или nsfw. Причина — в поле error:

code	Что значит
`content_policy`	Описание или файлы не прошли модерацию.
`input_rejected`	Модель не смогла работать с входными файлами.
`invalid_input`	Параметры не подошли модели.
`timeout`	Генерация не завершилась вовремя.
`generation_failed`	Сбой генерации — можно повторить.

Во всех этих случаях деньги за запрос возвращаются на баланс автоматически (price.refunded: true).

В каждом ответе есть заголовок X-Outsee-Trace-Id — приложите его и id запроса, если пишете в поддержку.