xAI
Criar uma edição de vídeo xAI
Use POST /grok/v1/videos/edits para editar um vídeo de origem com um prompt de texto, preservar o movimento e obter um request_id para consultar resultados assíncronos.
POST
cURL
Use este endpoint para editar um MP4 existente com uma instrução de texto. A saída permanece mais próxima do timing e da composição do clipe de origem do que uma solicitação de geração do zero.
Antes de enviar a solicitação
- Forneça um
video.urlacessível - Mantenha o clipe de origem curto; a própria orientação da xAI limita edições a cerca de 8,7 segundos
- Use uma instrução objetiva que descreva uma única mudança clara
- Salve o
request_idretornado, porque as edições usam o mesmo fluxo de polling da geração
Fluxo de edição
1
Enviar a solicitação de edição
Envie a URL do vídeo de origem, o prompt de edição e
model: grok-imagine-video.2
Consultar o resultado final
Chame Get xAI video results até que o trabalho seja concluído.
3
Armazenar o recurso editado
Baixe a saída finalizada ou mova a URL retornada para o seu próprio pipeline de armazenamento.
O que muda no CometAPI
A xAI documenta a edição de vídeo com o mesmo ciclo de vida assíncrono da geração, apenas com um vídeo de origem em vez de uma imagem de origem opcional. O CometAPI mantém esse comportamento e o mesmo endpoint de polling, então seu fluxo de edição continua sendo iniciar -> consultar -> baixar.Autorizações
Bearer token authentication. Use your CometAPI key.
Corpo
application/json
Edit instruction describing the change you want.
Exemplo:
"Add snow to the scene."
Source video to edit. xAI documents an input limit of about 8.7 seconds.
xAI video model id.
Exemplo:
"grok-imagine-video"
Optional output delivery configuration.
Optional end-user identifier.
Resposta
200 - application/json
Request accepted.
Deferred request id used for polling.