Descripción general
Referencia de la API
Guías de integración
Errores
Precios y facturación
xAI
Edición de video
Usa POST /grok/v1/videos/edits para editar un video de origen con un prompt de texto, preservar el movimiento y obtener un request_id para consultar resultados asíncronos.
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"
}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.urlaccesible - 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
Enviar la solicitud de edición
Envía la URL del video de origen, el prompt de edición y
model: grok-imagine-video.Consultar el resultado final
Llama a Get Video Generation Results hasta que el trabajo haya terminado.
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
Bearer token authentication. Use your CometAPI key.
Cuerpo
application/json
Edit instruction describing the change you want.
Ejemplo:
"Add snow to the scene."
Source video to edit. xAI documents an input limit of about 8.7 seconds.
Show child attributes
Show child attributes
xAI video model id.
Ejemplo:
"grok-imagine-video"
Optional output delivery configuration.
Optional end-user identifier.
Respuesta
200 - application/json
Request accepted.
Deferred request id used for polling.
⌘I
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"
}