Saltar para o conteúdo principal
POST
/
grok
/
v1
/
videos
/
edits
Create an xAI video edit job
curl --request POST \
  --url https://api.cometapi.com/grok/v1/videos/edits \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "prompt": "Add snow to the scene.",
  "video": {
    "url": "https://example.com/source.mp4"
  }
}
'
{
  "request_id": "e55813f7-911f-cfa8-208c-9c8e693b4d38"
}

Documentation Index

Fetch the complete documentation index at: https://apidoc.cometapi.com/llms.txt

Use this file to discover all available pages before exploring further.

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 em uma solicitação de geração do zero.

​
Antes de enviar a solicitação

  • Forneça um video.url acessí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_id retornado, porque as edições usam o mesmo fluxo de consulta 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 Video Generation Results até que o trabalho seja concluído.
3

Armazenar o recurso editado

Faça o download da 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, mas 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 consulta, então seu fluxo de edição continua sendo iniciar -> consultar -> baixar.

Autorizações

​
Authorization
string
header
obrigatório

Bearer token authentication. Use your CometAPI key.

Corpo

application/json
​
prompt
string
obrigatório

Edit instruction describing the change you want.

Exemplo:

"Add snow to the scene."

​
video
object
obrigatório

Source video to edit. xAI documents an input limit of about 8.7 seconds.

​
model
string
padrão:grok-imagine-video

xAI video model id.

Exemplo:

"grok-imagine-video"

​
output
object

Optional output delivery configuration.

​
user
string

Optional end-user identifier.

Resposta

200 - application/json

Request accepted.

​
request_id
string
obrigatório

Deferred request id used for polling.