Consulte jobs de geração da Rivya API por ID público de tarefa, leia estados queued, processing, succeeded e failed, e consuma URLs de resultado.

Use GET /api/v1/generations/{taskId} para verificar um job de geração assíncrono.

Endpoint

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

Header obrigatório:

Authorization: Bearer rvya_sk_...

Exemplo com curl

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

Valores de Status

Valores públicos de status:

queued: tarefa aceita, ainda não concluída
processing: a geração está em execução
succeeded: o resultado está disponível
failed: a tarefa falhou e pode incluir um objeto público de erro

Resposta com Sucesso

{
  "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 é a primeira URL de resultado por conveniência. urls contém a lista pública de URLs de resultado quando disponível.

Resposta com Falha

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

Orientação de Polling

Comece com um pequeno atraso e depois aumente os intervalos de consulta. Evite loops apertados.

Padrão recomendado:

aguarde 2 a 3 segundos após o envio
consulte a cada 5 a 10 segundos para jobs normais
diminua o ritmo para jobs longos de vídeo e áudio
pare de consultar quando o status for succeeded ou failed

Limite de Propriedade

A tarefa deve pertencer à mesma conta Rivya por trás da chave de API. Se não for encontrada ou não pertencer à conta, o endpoint retornará not_found.

Status de Geração