Guias de Integração
Preços e Faturamento
xAI
Geração de Vídeo
Use o CometAPI POST /grok/v1/videos/generations para criar vídeos com Grok, animar uma imagem de entrada via prompt e consultar os resultados por meio de request_id.
POST
/
grok
/
v1
/
videos
/
generations
curl --request POST \
--url https://api.cometapi.com/grok/v1/videos/generations \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"prompt": "A candle flickers on a wooden table."
}
'{
"request_id": "4b2cd27e-0b0d-3dec-c31c-7572daf74bb3"
}Use este endpoint para iniciar um job de vídeo do Grok a partir de texto, ou de texto mais uma imagem de origem. Ele retorna um
request_id imediatamente, então trate-o como a primeira etapa de um fluxo assíncrono.
Comece com uma solicitação pequena
- Use
model: grok-imagine-video - Para um teste rápido, mantenha
durationem1eresolutionem480p - Adicione
image.urlsomente quando quiser image-to-video - Se enviar base64, mantenha a forma dos exemplos na documentação e no OpenAPI como
data:image/png;base64,<BASE64_IMAGE_DATA>
Fluxo da tarefa
Consultar a conclusão
Chame Get Video Generation Results até que o status aninhado do provider se torne
done.O que muda no CometAPI
A xAI documenta a geração de vídeo como um fluxo de duas etapas start -> poll. O CometAPI mantém o mesmo formato de solicitação e o mesmo id principal do model, mas você se autentica com sua chave do CometAPI e permanece na URL base do CometAPI. Uma solicitação real de 1 segundo em 480p foi concluída com sucesso em 2026-03-12 e retornou uma URL de resultado real.Autorizações
Bearer token authentication. Use your CometAPI key.
Corpo
application/json
Prompt for the video job.
Exemplo:
"A candle flickers on a wooden table."
Output aspect ratio.
Opções disponíveis:
1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3 Output duration in seconds. xAI documents a range of 1 to 15 seconds.
Optional source image for image-to-video.
Show child attributes
Show child attributes
xAI video model id.
Exemplo:
"grok-imagine-video"
Show child attributes
Show child attributes
Output resolution.
Opções disponíveis:
480p, 720p Deprecated size field. Prefer aspect_ratio and resolution.
Optional end-user identifier.
Resposta
200 - application/json
Request accepted.
Deferred request id used for polling.
⌘I
curl --request POST \
--url https://api.cometapi.com/grok/v1/videos/generations \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"prompt": "A candle flickers on a wooden table."
}
'{
"request_id": "4b2cd27e-0b0d-3dec-c31c-7572daf74bb3"
}