Guias de Integração
Preços e Faturamento
API Oficial
Recuperar Vídeo
Use o CometAPI GET /v1/videos/ para recuperar o status, o progresso e os metadados do vídeo Sora 2, como duração, dimensões, timestamps e expiração.
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
statuspara o estado do ciclo de vidaprogresspara um sinal aproximado de progressoerrorquando o provedor rejeita o job ou ocorre uma falhaexpires_atapós a conclusão, caso você precise saber quando os recursos temporários expiram
Faça polling até a conclusão
Crie ou remixe o vídeo primeiro
Comece com Create Video ou Remix Video.
Faça polling pelo id
Passe o
id retornado aqui e continue verificando até que o job chegue a completed ou failed.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
Bearer token authentication. Use your CometAPI key.
Parâmetros de caminho
Video id returned by the create or remix endpoint.
Resposta
200 - application/json
Current job state.
⌘I
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
}