Skip to main content
POST
cURL
Usa este endpoint cuando una sola imagen de origen no sea suficiente y quieras que Kling construya el movimiento a partir de múltiples referencias de imagen.

Antes de llamarlo

  • Prepara de 1 a 4 imágenes en image_list
  • Usa imágenes que cumplan con los requisitos de píxeles de Kling; la tarea de generación rechaza las miniaturas diminutas
  • Omite model_name a menos que necesites específicamente seleccionar un modelo compatible con la ruta
  • Mantén simple la primera prueba: un prompt corto, duration: 5, sin configuraciones adicionales de callback
  • No envíes campos de máscara de image-to-video como static_mask o dynamic_masks en esta ruta

Flujo de la tarea

1

Enviar la solicitud multi-imagen

Envía la lista de imágenes, el prompt y la duración, y luego guarda el task_id de Kling devuelto.
2

Consultar la tarea

Continúa con Obtener una tarea de Kling hasta que la tarea alcance un estado terminal.
3

Persistir el resultado

Guarda el video finalizado si necesitas retención más allá de la URL de entrega del proveedor.
Para la referencia completa de parámetros, consulta la documentación oficial de Kling.

Autorizaciones

Authorization
string
header
requerido

Bearer token authentication. Use your CometAPI key.

Cuerpo

application/json
image_list
object[]
requerido

Input image references. Provide 1 to 4 items that meet Kling pixel requirements; very small thumbnails are rejected.

Required array length: 1 - 4 elements
model_name
enum<string>
predeterminado:kling-v1-6

Kling model variant for multi-image video. Omit to use kling-v1-6.

Opciones disponibles:
kling-v1-6
prompt
string

Text prompt describing the desired motion and scene.

negative_prompt
string

Elements to avoid in the generated video.

mode
enum<string>
predeterminado:std

Generation mode. Use std or pro; omitted requests use std.

Opciones disponibles:
std,
pro
duration
string
predeterminado:5

Output video length in seconds. Use 5 or 10; omitted requests use 5.

aspect_ratio
enum<string>

Requested frame aspect ratio when the model needs an explicit frame shape.

Opciones disponibles:
16:9,
9:16,
1:1
callback_url
string

Webhook URL to receive task status updates.

external_task_id
string

Custom task id for your own tracking. Must be unique per account.

Respuesta

200 - application/json

Task accepted.

code
integer
requerido

Error code; specifically define the error code

message
string
requerido

error message

data
object
requerido