Introducción
Kling 4.0 Edición de video cambia un video que ya tienes en lugar de crear uno desde cero. Sube un clip de 3 a 30 segundos y escribe qué debe cambiar: un sujeto, el escenario, el clima, la hora del día o el estilo. La escena, el sujeto y el movimiento se mantienen como se grabaron. Puedes añadir hasta 10 imágenes de referencia para traer una persona, un objeto o un look. Los resultados salen a 720p o 1080p, con sonido.
Elige un modo de Kling 4.0 según el material de partida
| Lo que tienes al inicio | Modo |
|---|---|
| una escena o guion escrito | Kling 4.0 Texto a video |
| un cuadro de apertura, y opcionalmente un cuadro de cierre y cuadros intermedios | Kling 4.0 Imagen a video |
| fotos, clips o muestras de voz para armar el reparto | Kling 4.0 Referencia a video |
| un clip que quieres cambiar | Kling 4.0 Edición de video (estás aquí) |
| un clip que quieres continuar | Kling 4.0 Extensión de video |
Funciones y aspectos destacados
Conserva la escena y el movimiento
El modelo sigue tu clip original, así que el movimiento de cámara, la pose y el ritmo se mantienen. En nuestra prueba, un hombre apoyado en un convertible antiguo en una gasolinera del desierto se convirtió en una nevada intensa: la nieve se posó sobre el cofre y el toldo, y su pose, el mapa de carreteras, el auto y el lento travelling coincidieron con el original.
Cambia a una persona con una imagen de referencia
Da un retrato como @Image1 y di a quién reemplaza. En nuestra prueba, la astrónoma de nuestro clip del observatorio se convirtió en la mujer del retrato de referencia (cabello, rostro y chaqueta de pana), mientras su mano en la rueda, el giro de la cabeza y la subida de la grúa se mantuvieron cuadro por cuadro.
Menciona tus archivos en el prompt
Llama al clip @Video1 y a las imágenes de referencia @Image1, @Image2 y así sucesivamente, en el orden en que los subiste. Di cuál es cuál y luego qué cambiar.
El sonido puede quedarse o ser nuevo
keep_original_audio viene activado por defecto y conserva el sonido propio del clip original. Si lo desactivas, el modelo genera un audio nuevo y sincronizado.
La duración sigue al original, o la fijas tú
Si dejas la duración en “Match source”, el resultado dura lo mismo que tu clip, redondeado al segundo entero. O elige cualquier número entero de 3 a 30 segundos.
Parámetros de la solicitud
| Parámetro | Obligatorio | Descripción |
|---|---|---|
prompt | Sí | Describe la edición. Llama al clip original @Video1 y a las imágenes de referencia @Image1, @Image2 y así sucesivamente, en el orden de subida. mínimo 1 caracteres |
video_url | Sí | El clip a editar, en MP4 o WebM, de 3 a 30 segundos. Se conservan la escena, el sujeto y el movimiento. mínimo 1 caracteres |
reference_image_urls | No | Opcional, hasta 10 imágenes de una persona, un objeto o un estilo que quieras traer, de 10 MB cada una. Cítalas como @Image1, @Image2 en el orden de subida. mínimo 1 elementos · máximo 10 elementos |
aspect_ratio | No | auto (por defecto) sigue al clip original; 16:9, 9:16, 1:1 o 21:9 lo fijan tú. No cambia el precio. |
resolution | No | 720p (por defecto) o 1080p. 1080p cuesta más por segundo. |
keep_original_audio | No | Activado por defecto, lo que conserva el sonido propio del clip original. Si lo desactivas, el modelo genera un audio nuevo y sincronizado. Valor predeterminado: |
duration_seconds | No | Duración del resultado: un número entero de 3 a 30 segundos, o -1 para “Match source” (por defecto), que sigue al clip original redondeado al segundo entero. |
Precios
Se cobra por segundo a la tarifa de edición, sobre los segundos de salida más los segundos del clip original. El original se cuenta como mínimo tan largo como la salida, en segundos enteros, hasta 30 segundos. 1080p cuesta más por segundo que 720p. Las imágenes de referencia y el ajuste de sonido no cambian el precio. Una solicitud rechazada o fallida no se cobra.
| Especificación | Precio |
|---|---|
| $0.1128 / segundo |
| $0.1692 / segundo |
Casos de uso
Cambia el clima o la hora del día
Conserva una toma que ya te gusta y convierte una tarde soleada en nieve, lluvia o anochecer sin volver a grabarla.
Cambia el escenario o el estilo
Lleva la misma actuación a otro lugar, o cambia el estilo de un clip mientras el movimiento se mantiene igual.
Trae una persona o un objeto
Añade imágenes de referencia cuando la edición necesite algo que el original nunca mostró, como una chaqueta específica, un auto o un personaje.
Guía de prompts y consejos prácticos
Di qué debe quedar igual
Nombra las partes que quieres proteger: “mantén al hombre, sus movimientos y el movimiento de cámara tal como están”. Luego describe el cambio. Así el modelo no rehace más de lo que pediste.
Espera un clip un poco más largo con “Match source”
Con la duración en “Match source”, el resultado es la duración del original redondeada al segundo entero, y el modelo prolonga el movimiento durante esa última fracción. En nuestra prueba, un original de 5,04 segundos salió como un clip de 6,04 segundos. El sonido propio del original termina un momento antes que la imagen.
Usa referencias solo para lo nuevo
Las imágenes de referencia son para algo que el clip todavía no contiene. Para un cambio como el clima o la hora del día, el prompt solo suele bastar.
Elige 1080p según el trabajo
Haz un borrador a 720p para revisar el cambio y luego renderiza a 1080p cuando el resultado sea el correcto. 1080p cuesta más por segundo.
Inicio rápido de la API
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "kling/4.0/video-edit",
"input": {
"aspect_ratio": "auto",
"duration_seconds": -1,
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"resolution": "720p",
"video_url": "https://example.com/reference.mp4"
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
Consulta la referencia de la API para autenticación, el esquema completo, sondeo y gestión de errores.
