Saltar al contenido 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.

Usa este endpoint para editar un MP4 existente con una instrucción de texto. La salida se mantiene más cercana al timing y la composición del clip de origen que una solicitud de generación nueva.

​
Antes de enviar la solicitud

  • Proporciona una video.url accesible
  • Mantén el clip de origen corto; la propia guía de xAI limita las ediciones a aproximadamente 8.7 segundos
  • Usa una instrucción precisa que describa un solo cambio claro
  • Guarda el request_id, porque las ediciones usan el mismo flujo de consulta que la generación

​
Flujo de edición

1

Enviar la solicitud de edición

Envía la URL del video de origen, el prompt de edición y model: grok-imagine-video.
2

Consultar el resultado final

Llama a Get Video Generation Results hasta que el trabajo haya terminado.
3

Guardar el recurso editado

Descarga la salida final o mueve la URL devuelta a tu propio pipeline de almacenamiento.

​
Qué cambia en CometAPI

xAI documenta la edición de video con el mismo ciclo de vida asíncrono que la generación, solo que con un video de origen en lugar de una imagen de origen opcional. CometAPI mantiene ese comportamiento y el mismo endpoint de consulta, por lo que tu flujo de trabajo de edición sigue siendo iniciar -> consultar -> descargar.

Autorizaciones

​
Authorization
string
header
requerido

Bearer token authentication. Use your CometAPI key.

Cuerpo

application/json
​
prompt
string
requerido

Edit instruction describing the change you want.

Ejemplo:

"Add snow to the scene."

​
video
object
requerido

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

​
model
string
predeterminado:grok-imagine-video

xAI video model id.

Ejemplo:

"grok-imagine-video"

​
output
object

Optional output delivery configuration.

​
user
string

Optional end-user identifier.

Respuesta

200 - application/json

Request accepted.

​
request_id
string
requerido

Deferred request id used for polling.