Detalhe da task

Retorna o detalhe de uma task de geração pelo ID. É o endpoint usado para acompanhar (polling) o resultado de uma geração assíncrona. Responde 200 OK.

Escopo necessário: read:tasks (ver Escopos).

Exemplo de request

curl https://avatrix.io/api/v1/tasks/tsk_xxxxxxxx \
  -H "Authorization: Bearer av_xxxxxxxxxxxxxxxx"

Resposta — 200

O detalhe da task vem dentro do envelope padrão:

{
  "success": true,
  "data": {
    "id": "tsk_xxxxxxxx",
    "toolId": "image-generator",
    "taskType": "image",
    "modelName": "flux-pro",
    "prompt": "um gato astronauta",
    "status": "completed",
    "progress": 100,
    "resultUrl": "https://cdn.avatrix.com.br/results/...",
    "creditsUsed": 10,
    "errorMessage": null,
    "referenceUrls": ["https://cdn.avatrix.com.br/uploads/..."],
    "submittedAt": "2026-06-16T12:00:05.000Z",
    "completedAt": "2026-06-16T12:01:30.000Z"
  }
}

referenceUrls reúne as imagens e o vídeo enviados como referência (vazio quando não houver). resultUrl é preenchido quando completed; errorMessage quando failed. O campo de status segue o Ciclo de vida da task:

• pending → submitted → processing: trate qualquer um destes como "em andamento".
• completed: a resposta traz o resultUrl com o arquivo gerado.
• failed: a resposta traz o errorMessage com o motivo da falha.

O status: "queued" retornado na criação da task (resposta 202 dos endpoints de geração) é apenas o rótulo do contrato público de "task aceita e enfileirada"; ele não reaparece no polling.

Erros relevantes

Ver Erros.