Jobs de mídia (assíncrono)

O modo assíncrono de /v1/images, /v1/videos e /v1/audio/speech: "async": true devolve um job na hora; o resultado sai em GET /v1/media/jobs/{id}.

Atualizado em 01 de set. de 2026

Gerar um vídeo leva minutos — e nenhuma conexão HTTP (nem o card Webhook de um agente) deveria ficar pendurada esperando. Com "async": true no corpo, qualquer chamada de /v1/images, /v1/videos ou /v1/audio/speech responde em milissegundos com um job_id, e o trabalho continua no servidor.

A cobrança, o armazenamento e o resultado são idênticos ao modo síncrono — o job só embrulha a espera.

1. iniciarbash

curl -X POST https://api.hinow.ai/v1/videos \
  -H "Authorization: Bearer hi_SUA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "bytedance/seedance-2.0-mini", "prompt": "...", "duration": 5, "async": true}'
# → 202 {"data": {"job_id": "8370e7b8-...", "status": "queued",
#        "poll_url": "/v1/media/jobs/8370e7b8-..."}}

GEThttps://api.hinow.ai/v1/media/jobs/{job_id}Bearer

Consulta o andamento e o resultado de um job de mídia. Só a conta que criou o job o enxerga.

Parâmetros

job_idstring· pathobrigatório
O id devolvido no `202` da chamada assíncrona.

Respostas

200`status`: `queued` → `running` → `succeeded` | `failed`

{
  "success": true,
  "data": {
    "job_id": "8370e7b8-...",
    "endpoint": "/v1/videos",
    "model": "bytedance/seedance-2.0-mini",
    "status": "succeeded",
    "result": {
      "urls": ["https://s3.us1-stlouis.hinow.ai/.../clip.mp4"],
      "cost": { "amount": 0.575, "currency": "USD" }
    }
  }
}

404Job inexistente, expirado (24h) ou de outra conta

Detalhe	Comportamento
Resultado	O `result` é exatamente o `data` que o endpoint síncrono devolveria — nada novo para aprender.
Cobrança	Acontece uma vez, no pipeline normal, quando a geração termina. Job que falha não cobra a geração.
Retenção	O job fica consultável por 24 horas; o arquivo gerado continua no storage normalmente.
Deadline	Job que não termina em 35 minutos é dado como `failed`.
Escopo	Por conta — `job_id` de outra conta responde 404.

Em agentes, async é obrigatório para vídeo

O card Webhook não deve segurar uma request por minutos. O padrão — rota que inicia + rota que consulta + o agente avisando o progresso — está montado e testado no fluxo Diretor de cena.

Esta página foi útil?