Статус генерации

Используйте GET /api/v1/generations/{taskId}, чтобы проверить асинхронную задачу генерации.

Конечная точка

GET https://rivya.ai/api/v1/generations/{taskId}

Обязательный заголовок:

Authorization: Bearer rvya_sk_...

Пример curl

curl https://rivya.ai/api/v1/generations/task_public_id \
  -H "Authorization: Bearer rvya_sk_..."

Значения статуса

Публичные значения статуса:

• queued: задача принята, но еще не завершена

• processing: генерация выполняется

• succeeded: результат доступен

• failed: задача завершилась ошибкой и может включать публичный объект ошибки

Успешный ответ

{
  "id": "task_public_id",
  "status": "succeeded",
  "model": "z-image",
  "reserved_credits": 1,
  "final_credits": 1,
  "created_at": "2026-05-10T00:00:00.000Z",
  "updated_at": "2026-05-10T00:01:00.000Z",
  "result": {
    "primary_url": "https://media.example/result.png",
    "urls": ["https://media.example/result.png"]
  },
  "error": null
}

primary_url - первый URL результата для удобства. urls содержит список публичных URL результата, когда он доступен.

Ответ с ошибкой

{
  "id": "task_public_id",
  "status": "failed",
  "model": "z-image",
  "reserved_credits": 1,
  "final_credits": 0,
  "created_at": "2026-05-10T00:00:00.000Z",
  "updated_at": "2026-05-10T00:01:00.000Z",
  "result": null,
  "error": {
    "code": "generation_failed",
    "message": "The generation failed."
  }
}

Рекомендации по опросу

Начните с короткой задержки, затем увеличивайте интервалы опроса. Избегайте плотных циклов.

Рекомендуемый шаблон:

• подождите 2-3 секунды после отправки

• опрашивайте обычные задачи каждые 5-10 секунд

• замедляйтесь для долгих видео- и аудиозадач

• прекращайте опрос, когда статус становится succeeded или failed

Граница владения

Задача должна принадлежать тому же аккаунту Rivya, который стоит за API-ключом. Если задача не найдена или не принадлежит аккаунту, конечная точка возвращает not_found.

Связанные страницы

• Создание генерации

• Кредиты API

• Жизненный цикл задачи в Rivya

• Неудачные задачи и возвраты кредитов