Guias de Integração
Preços e Faturamento
API Oficial
Criar Vídeo
Use POST /v1/videos para criar tarefas de geração de vídeo do Sora 2 a partir de prompts de texto ou imagens de referência e, em seguida, consultar o status pelo ID da tarefa para obter os resultados.
POST
/
v1
/
videos
Create a Sora video job
curl --request POST \
--url https://api.cometapi.com/v1/videos \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: multipart/form-data' \
--form 'prompt=A paper airplane glides across a desk.' \
--form input_reference='@example-file'{
"created_at": 1773296991,
"id": "video_69b25d5f467c81908733a56bc236b4df",
"model": "sora-2",
"object": "video",
"progress": 0,
"seconds": "4",
"size": "1280x720",
"status": "queued"
}Use este endpoint para iniciar um novo trabalho de renderização do Sora a partir de texto, ou de texto mais uma imagem de referência. A API retorna um ID de vídeo imediatamente e não espera a renderização terminar.
Comece com o menor trabalho útil
- Use
sora-2para iteração mais rápida ousora-2-proquando a qualidade da saída for mais importante do que a velocidade - Mantenha
secondsem4na sua primeira solicitação - Comece com
size: 1280x720, a menos que você precise especificamente de uma saída em retrato - Envie no máximo uma imagem de referência
Fluxo de ponta a ponta
Consultar até o trabalho terminar
Chame Retrieve Video até que o status se torne
completed ou failed.Baixar ou remixar o resultado
Quando a renderização estiver concluída, obtenha o arquivo com Retrieve Video Content. Se quiser uma variação direcionada, use Remix Video no resultado concluído.
Comportamento do Sora que ainda se aplica
A OpenAI documenta o mesmo fluxo de criação -> recuperação -> download na API de Vídeos. No CometAPI, você mantém o formato da solicitação do Sora, mas usa a URL base e a chave da CometAPI. As URLs de download finalizadas são temporárias, então copie os assets concluídos para o seu próprio armazenamento se precisar de retenção por longos períodos.Autorizações
Bearer token authentication. Use your CometAPI key.
Corpo
multipart/form-data
Text prompt that describes the video you want to create.
Exemplo:
"A paper airplane glides across a desk."
Sora model ID. Choose a current model from the Models page.
Exemplo:
"sora-2"
Clip duration in seconds.
Opções disponíveis:
4, 8, 12 Exemplo:
"4"
Output resolution formatted as width x height.
Opções disponíveis:
720x1280, 1280x720, 1024x1792, 1792x1024 Exemplo:
"1280x720"
Optional reference image uploaded as a file. The image should match the target size you request.
⌘I
Create a Sora video job
curl --request POST \
--url https://api.cometapi.com/v1/videos \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: multipart/form-data' \
--form 'prompt=A paper airplane glides across a desk.' \
--form input_reference='@example-file'{
"created_at": 1773296991,
"id": "video_69b25d5f467c81908733a56bc236b4df",
"model": "sora-2",
"object": "video",
"progress": 0,
"seconds": "4",
"size": "1280x720",
"status": "queued"
}