Saltar para o conteúdo principal
GET
/
v1
/
videos
/
{video_id}
Retrieve a Sora video job
curl --request GET \
  --url https://api.cometapi.com/v1/videos/{video_id} \
  --header 'Authorization: Bearer <token>'
{
  "id": "video_69b25d5f467c81908733a56bc236b4df",
  "size": "1280x720",
  "error": null,
  "model": "sora-2",
  "object": "video",
  "prompt": "A paper airplane glides across a desk.",
  "status": "in_progress",
  "seconds": "4",
  "progress": 0,
  "created_at": 1773296991,
  "expires_at": null,
  "completed_at": null,
  "remixed_from_video_id": null
}
Use este endpoint depois de iniciar um job do Sora. Ele informa o estado atual do job, o tamanho e a duração configurados, além de qualquer erro retornado pelo provedor.

​
Observe estes campos

  • status para o estado do ciclo de vida
  • progress para um sinal aproximado de progresso
  • error quando o provedor rejeita o job ou ocorre uma falha
  • expires_at após a conclusão, caso você precise saber quando os recursos temporários expiram

​
Faça polling até a conclusão

1

Crie ou remixe o vídeo primeiro

Comece com Create Video ou Remix Video.
2

Faça polling pelo id

Passe o id retornado aqui e continue verificando até que o job chegue a completed ou failed.
3

Baixe o arquivo

Quando o job estiver completed, siga para Retrieve Video Content.

​
Formato da resposta no CometAPI

Esta etapa corresponde de perto ao fluxo de polling do Sora. O CometAPI mantém o formato de objeto no estilo OpenAI para que você possa conectar verificações de status com o mínimo de adaptação.

Autorizações

​
Authorization
string
header
obrigatório

Bearer token authentication. Use your CometAPI key.

Parâmetros de caminho

​
video_id
string
obrigatório

Video id returned by the create or remix endpoint.

Resposta

200 - application/json

Current job state.

​
id
string
obrigatório
​
size
string
obrigatório
​
model
string
obrigatório
​
object
string
obrigatório
​
status
string
obrigatório
​
seconds
string
obrigatório
​
progress
integer
obrigatório
​
created_at
integer
obrigatório
​
error
object
​
prompt
string
​
expires_at
integer | null
​
completed_at
integer | null
​
remixed_from_video_id
string | null