Ir al contenido principal
Español— Elegir un idioma
Menú

Edición de vídeo con /v1/videos/edits

Lección 7 de 12 Actualizado el 3 de noviembre de 2026 Intermedio
En esta página
  1. Editar un vídeo existente
  2. El endpoint POST /v1/videos/edits
  3. Qué pedir en una edición
  4. El ciclo asíncrono, idéntico al de la generación
  5. Especifica qué cambia y qué permanece
  6. Puntos clave

Actualizado el 3 de noviembre de 2026. Basado en la página Video Editing de xAI: el vídeo de origen tiene una duración máxima de 8,7 segundos; la salida mantiene su duración, relación de aspecto y resolución (máximo 720p), y la extensión utiliza el mismo objeto video que la edición. La afirmación anterior de que la edición no era fiable para elementos específicos contradice los ejemplos de xAI, que se centran precisamente en ediciones precisas. Fuentes: Video Editing · Video Overview.

Editar un vídeo existente

La generación es solo una parte del trabajo. La API de xAI también expone un endpoint de edición de vídeo que toma una secuencia existente y la modifica basándose en indicaciones de texto. Es el equivalente en vídeo de la edición de imágenes, pero con restricciones de formato más estrictas. Antes de escribir tu primera solicitud, ten en cuenta los cuatro límites que determinan qué puedes enviar.

8,7 s
Duración máxima del origen
720p
Resolución máxima
H.265
Códec aceptado (como H.264, AV1)
MP4
Formato obligatorio

El endpoint POST /v1/videos/edits

La solicitud empareja un vídeo de origen con una indicación que describe la modificación deseada.

{
  "model": "grok-imagine-video",
  "prompt": "Change the background to a sunset over the ocean",
  "video": {
    "url": "https://example.com/original-video.mp4"
  }
}

Bastan tres campos: model, que sigue siendo grok-imagine-video; prompt, que contiene la descripción de la modificación; y video.url, que apunta al archivo MP4 que se va a procesar. Observa que el vídeo está encapsulado en un objeto video, que acepta una url o el file_id de un archivo subido: el endpoint de extensión, en la siguiente lección, adopta la misma convención.

Las restricciones técnicas son aquí más estrictas que en la generación. El origen no debe superar los 8,7 segundos y el vídeo producido mantiene su duración; la página Video Generation menciona una duración «limitada a 8,7 segundos» sin detallar el manejo de un origen más largo: por tanto, recorta tus fuentes de antemano. La resolución tiene un límite de 720p. El archivo de entrada debe ser un MP4 con un códec compatible, como H.264, H.265 o AV1. El punto más confuso para quienes vienen de la generación: no tienes control sobre la duración, la relación de aspecto ni la resolución de la salida, ya que todas vienen determinadas por el vídeo de origen. La solicitud de edición no incluye ningún campo duration, aspect_ratio ni resolution.

Qué pedir en una edición

La sustitución del fondo es el caso de libro de texto: el sujeto permanece, el entorno cambia.

{
  "model": "grok-imagine-video",
  "prompt": "Replace the background with a space landscape with stars and nebulae. Keep the same subject and the same movement.",
  "video": {"url": "https://example.com/video.mp4"}
}

Los cambios de estilo afectan a toda la imagen y transforman el estilo del clip sin modificar su acción; resulta práctico para adaptar la misma secuencia a diferentes universos.

{
  "model": "grok-imagine-video",
  "prompt": "Transform this video into a Japanese cartoon style with vivid colors",
  "video": {"url": "https://example.com/video.mp4"}
}

Añadir elementos enriquece la escena con capas que no existían durante el rodaje, habitualmente atmosféricas.

{
  "model": "grok-imagine-video",
  "prompt": "Add falling snow and a frost effect on the edges",
  "video": {"url": "https://example.com/video.mp4"}
}

Por último, la modificación de la iluminación equivale a un etalonaje de la secuencia: mismos planos, ambiente radicalmente diferente.

{
  "model": "grok-imagine-video",
  "prompt": "Change the lighting to a night ambiance with blue and purple neon lights",
  "video": {"url": "https://example.com/video.mp4"}
}

El ciclo asíncrono, idéntico al de la generación

La edición sigue exactamente el mismo protocolo de cuatro pasos que la generación: envías la solicitud, recibes un request_id, sondeas GET /v1/videos/{request_id} a intervalos regulares y recuperas el vídeo editado cuando el estado cambia a done. En Python, los dos primeros pasos caben en unas pocas líneas.

import httpx

# 1. Enviar la edición
response = httpx.post(
    "https://api.x.ai/v1/videos/edits",
    headers={"Authorization": f"Bearer {api_key}"},
    json={
        "model": "grok-imagine-video",
        "prompt": "Add a rain effect over the entire scene",
        "video": {"url": "https://example.com/source.mp4"}
    }
)
request_id = response.json()["request_id"]

# 2. Sondear el estado (simplificado)
status = httpx.get(
    f"https://api.x.ai/v1/videos/{request_id}",
    headers={"Authorization": f"Bearer {api_key}"}
).json()

Especifica qué cambia y qué permanece

xAI describe el comportamiento del modelo en una frase: grok-imagine-video aplica el cambio solicitado y mantiene todo lo demás lo más cercano posible al origen. Su documentación deriva de esto una directriz: di también qué debe permanecer idéntico. Sus propios ejemplos se centran también en ediciones precisas de un único clip —añadir un collar de plata, cambiar un atuendo a rojo, poner un sombrero negro de ala ancha a un personaje—, ejecutados en paralelo sobre la misma fuente.

{
  "model": "grok-imagine-video",
  "prompt": "Change the woman's jacket to red. Keep the same face, the same setting, the same framing, and the same movement.",
  "video": {"url": "https://example.com/video.mp4"}
}

La guía de indicaciones de imagen de xAI, escrita para imágenes fijas, especifica el orden que funciona: primero la modificación, luego una frase que bloquee lo que permanece estático. Una edición que empieza con «mantener todo» apenas cambia nada, y una edición que copia una indicación de generación completa reinventa la escena.

Cuatro hábitos evitan la mayoría de las trampas: mantén tus fuentes por debajo de 8,7 segundos y en un códec compatible (H.264, H.265 o AV1); nombra lo que debe permanecer intacto; prueba una modificación en un clip corto antes de escalarla; y recuerda que la edición usa grok-imagine-video, cuya tabla de precios muestra una única tarifa, 0,050 $ por segundo: una ronda de pruebas cuesta lo mismo que la generación.

Puntos clave

  • El endpoint POST /v1/videos/edits modifica un vídeo existente basándose en una indicación, solo con grok-imagine-video
  • El origen dura como máximo 8,7 segundos; la salida mantiene su duración, proporción y resolución (máximo 720p)
  • El vídeo de origen debe ser un MP4 con un códec compatible (H.264, H.265, AV1)
  • La solicitud no tiene ningún campo duration, aspect_ratio ni resolution
  • Di qué debe cambiar y luego qué debe permanecer idéntico