Consulta trabajos de generación de Rivya API por ID público de tarea, lee estados queued, processing, succeeded y failed, y consume URL de resultado.

Usa GET /api/v1/generations/{taskId} para comprobar un trabajo de generación asíncrono.

Endpoint

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

Header requerido:

Authorization: Bearer rvya_sk_...

Ejemplo curl

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

Valores de estado

Valores públicos de estado:

queued: tarea aceptada, no completada
processing: la generación está en curso
succeeded: el resultado está disponible
failed: la tarea falló y puede incluir un objeto público de error

Respuesta succeeded

{
  "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 es la primera URL de resultado para comodidad. urls contiene la lista pública de URL de resultado cuando está disponible.

Respuesta failed

{
  "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."
  }
}

Guía de polling

Empieza con una demora breve y luego aumenta los intervalos de consulta. Evita bucles cerrados.

Patrón recomendado:

espera 2-3 segundos después del envío
consulta cada 5-10 segundos para trabajos normales
reduce la frecuencia en trabajos largos de video y audio
deja de consultar cuando el estado sea succeeded o failed

Límite de propiedad

La tarea debe pertenecer a la misma cuenta de Rivya detrás de la clave API. Si no se encuentra o no pertenece a la cuenta, el endpoint devuelve not_found.

Estado de generación