API стал надёжнее: статус 50 задач за раз и понятные ошибки

Обновлено: 28 сентября 2026 г.

Ребят, мы серьёзно прокачали публичный API Genosai. Если вы генерируете фото, видео, озвучку или музыку через API, в своём боте, сервисе или через нашего MCP-агента, — вот что изменилось.

Статус 50 задач одним запросом

Новый POST /v1/tasksInfo: отправляете до 50 id задач и получаете статус всех сразу. Раньше, чтобы следить за пачкой генераций, приходилось дёргать taskInfo по каждой отдельно. Задачи, которых нет или которые не ваши, придут списком в notFound.

curl -X POST https://api.genosai.io/v1/tasksInfo \
  -H "Authorization: Bearer sdk_..." \
  -H "Content-Type: application/json" \
  -d '{"taskIds": ["TASK_ID_1", "TASK_ID_2"]}'

Понятная причина, если генерация не получилась

У упавшей задачи теперь есть машинный код причины errorCode и флаг retryable: есть ли смысл повторить тот же запрос.

errorCode	Что случилось	Что делать
`CONTENT_POLICY`	Запрос заблокирован модерацией (в том числе NSFW)	Изменить промпт или картинку
`INVALID_INPUT`	Не подошёл файл или параметр	Поправить вход
`PROVIDER_ERROR`	Сбой у провайдера модели	Повторить позже
`TIMEOUT`	Результат не пришёл вовремя	Повторить

Токены за упавшие задачи, как и раньше, возвращаются автоматически.

Неподдерживаемая пропорция — больше не ошибка

Если модель не умеет, скажем, 21:9, мы возьмём ближайшую допустимую (16:9) и честно напишем об этом в ответе, в поле adjustments. Длительность и разрешение сами не меняем — от них зависит цена, там по-прежнему будет ошибка со списком допустимых значений.

Вебхуки и лимиты

Уведомление на callBackUrl теперь приходит для всех упавших задач — раньше про упавшее видео вебхук мог не прийти.
Если отправляете запросы слишком часто, API отвечает RATE_LIMITED с заголовком Retry-After — видно, сколько подождать.

Всё подробно — в документации API.

Все статьи блога Genosai