Introducción
Kling 4.0 Flash edición de video parte de un clip existente y una instrucción obligatoria sobre el cambio que quieres hacer. Envía un original de 3–20 segundos y, si hace falta, hasta 10 imágenes de referencia. El resultado a 720p aplica la edición descrita y conserva la escena, el sujeto, la acción y el movimiento de cámara del original.
La duración de salida sigue la del original; si este supera los 20 segundos, se recorta en ese punto. En nuestras pruebas, la edición de vestuario del observatorio mantuvo los 5,04 segundos del original. El sonido original se conserva por defecto; establece keep_original_audio en false para generar audio sincronizado nuevo.
Funciones y aspectos destacados
- Crea una variación visual a partir de una actuación y un movimiento de cámara existentes.
- Incorpora hasta 10 imágenes cuando la edición requiera una referencia visual concreta.
- Conserva los tiempos del original en la salida, con un límite de 20 segundos para el material de origen.
- Mantén la pista de sonido original por defecto o genera audio sincronizado nuevo.
- Obtén una salida a 720p con encuadre auto o una de las cuatro relaciones de aspecto disponibles.
Parámetros de la solicitud
| Parámetro | Obligatorio | Descripción |
|---|---|---|
prompt | Sí | Instrucciones de edición obligatorias, sin texto predefinido; describe el cambio y la escena, el sujeto, la acción y el movimiento de cámara que deben mantenerse. mínimo 1 caracteres |
video_url | Sí | URL obligatoria de un clip original de 3–20 segundos, sin original predefinido; las entradas más largas se recortan a 20 segundos. mínimo 1 caracteres |
reference_image_urls | No | Añade opcionalmente hasta 10 URL de imágenes para orientar la edición e identifícalas como @Image1, @Image2 y así sucesivamente según el orden de subida. mínimo 1 elementos · máximo 10 elementos |
aspect_ratio | No | Usa auto para seguir el video original o establece 16:9, 9:16, 1:1 o 21:9 como forma de salida. Este ajuste no modifica el costo de edición. |
keep_original_audio | No | El valor predeterminado es true y conserva el sonido original; false genera una pista de sonido sincronizada nueva. Cambiar este valor no suma cargos aparte. Valor predeterminado: |
Precios
$0.151 / segundo
La edición se cobra por segundo del original, redondeado al segundo entero superior, con un máximo de 20 segundos facturados. Un original de 5,04 segundos cuenta como 6 segundos facturados aunque la salida siga durando 5,04 segundos. El prompt, las imágenes de referencia, la relación de aspecto y la elección de audio no suman cargos aparte. Los rechazos de la moderación de Kling no se facturan.
Casos de uso
- Prueba un vestido de noche esmeralda en un clip de observatorio conservando la acción.
- Compara distintos colores de abrigo entre versiones de una escena breve para redes.
- Prepara variaciones visuales de un movimiento grabado y conserva la pista de sonido original.
Guía de prompts y consejos prácticos
- Empieza por lo que debe mantenerse, por ejemplo, “conserva la escena y el movimiento de cámara”, para fijar los elementos de la edición.
- Define un cambio concreto, como “cambia el abrigo a gris carbón”, antes de pedir varias variaciones.
- Asigna una función a cada imagen añadida, por ejemplo, “usa la chaqueta que aparece en @Image1”, para vincular la referencia con el cambio.
- Describe material y color juntos, como “un vestido de terciopelo esmeralda”, si el objetivo es editar el vestuario.
- Para una pista de sonido nueva, desactiva
keep_original_audioe incluye una indicación como “Sonido: un zumbido grave de motor y viento al atardecer”.
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-flash/video-edit",
"input": {
"aspect_ratio": "auto",
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"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.
