xAI
Crear una edición de video con xAI
Usa POST /grok/v1/videos/edits para editar un video de origen con un prompt de texto, conservar el movimiento y obtener un request_id para consultar resultados asíncronos.
POST
cURL
Usa este endpoint para editar un MP4 existente con una instrucción de texto. La salida se mantiene más cercana al ritmo y la composición del clip de origen que una solicitud de generación desde cero.
Antes de enviar la solicitud
- Proporciona un
video.urlaccesible - Mantén el clip de origen corto; la propia guía de xAI limita las ediciones a unos 8.7 segundos
- Usa una instrucción precisa que describa un único cambio claro
- Guarda el
request_iddevuelto, porque las ediciones usan el mismo flujo de consulta que la generación
Flujo de edición
1
Envía la solicitud de edición
Envía la URL del video de origen, el prompt de edición y
model: grok-imagine-video.2
Consulta el resultado final
Llama a Get xAI video results hasta que el trabajo haya finalizado.
3
Almacena el recurso editado
Descarga la salida terminada o mueve la URL devuelta a tu propio flujo 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, así que tu flujo de edición sigue siendo start -> poll -> download.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.
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.