Varias imágenes a video

Crea videos de Kling a partir de varias imágenes mediante CometAPI POST /kling/v1/videos/multi-image2video, con control de movimiento y ajustes de salida para la generación.

POST /kling/v1/videos/multi-image2video

Create a Kling multi-image-to-video task

cURL

curl --request POST \
  --url https://api.cometapi.com/kling/v1/videos/multi-image2video \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model_name": "kling-v1-6",
  "duration": "5",
  "image_list": [
    {
      "image": "https://h2.inkwai.com/bs2/upload-ylab-stunt/se/ai_portal_queue_mmu_image_upscale_aiweb/3214b798-e1b4-4b00-b7af-72b5b0417420_raw_image_0.jpg"
    },
    {
      "image": "https://h2.inkwai.com/bs2/upload-ylab-stunt/se/ai_portal_queue_mmu_image_upscale_aiweb/3214b798-e1b4-4b00-b7af-72b5b0417420_raw_image_0.jpg"
    },
    {
      "image": "https://filesystem.site/cdn/20250414/chxiLc2O45zoLT8BCrQ6WQlTvGDDnK.png"
    },
    {
      "image": "https://filesystem.site/cdn/20250414/chxiLc2O45zoLT8BCrQ6WQlTvGDDnK.png"
    }
  ],
  "prompt": "The astronauts got up and left."
}
'

200

{
  "code": 0,
  "message": "SUCCEED",
  "data": {
    "task_id": "861309198188019719",
    "task_status": "submitted",
    "task_info": {},
    "created_at": 1773380633979,
    "updated_at": 1773380633979
  }
}

Usa este endpoint cuando una sola imagen de origen no sea suficiente y quieras que Kling construya movimiento a partir de múltiples referencias de imagen.

​

Antes de llamarlo

• Prepara de 2 a 4 imágenes en image_list
• Empieza con model_name: kling-v1-6 u otro modelo actual que hayas validado
• Mantén simple la primera prueba: un Prompt corto, sin máscaras de movimiento ni configuraciones adicionales de callback

​

Flujo de la tarea

1. Enviar la solicitud de varias imágenes

   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 Consultas individuales hasta que la tarea alcance un estado terminal.

3. Persistir el resultado

   Guarda el video finalizado si necesitas conservarlo más allá de la URL de entrega del proveedor.

La validación en vivo del 2026-03-13 confirmó que se aceptó una solicitud mínima de dos imágenes y devolvió task_status: submitted.

Para consultar la referencia completa de parámetros, revisa la documentación oficial de Kling.

Autorizaciones

Authorization · string · header · requerido

Bearer token authentication. Use your CometAPI key.

Cuerpo

application/json

model_name · string · predeterminado: kling-v1-6 · requerido

Kling model variant to use. See the Models page for current options.

duration · string · predeterminado: 5 · requerido

Output video length in seconds. Options: 5, 10.

image_list · object[] · requerido

2 to 4 source images. Each item provides an image field as a public URL or Base64 string (without data: prefix). Accepted formats: JPG, JPEG, PNG. Maximum 10 MB per image, minimum 300×300 px, aspect ratio between 1:2.5 and 2.5:1.

Show child attributes

prompt · string · predeterminado: The cat turns its head and blinks. · requerido

Text prompt describing the desired motion. Maximum 500 characters.

negative_prompt · string

Elements to exclude from the video. Maximum 200 characters.

callback_url · string

Webhook URL to receive task status updates when the task completes.

mode · string

Generation mode. std for standard (faster), pro for professional (higher quality).

cfg_scale · number

Prompt adherence strength. Higher values follow the prompt more closely. Range: 0–1.

static_mask · string

Static brush mask image as a Base64 string or public URL. White areas are frozen in place during video generation. Must match the aspect ratio and resolution of the input image.

dynamic_masks · object

Dynamic brush configuration. Up to 6 groups, each containing a painted-area mask and a motion trajectory.

Show child attributes

external_task_id · string

Custom task id for your own tracking. Does not replace the system-generated task id but can be used to query tasks. Must be unique per user.

Respuesta

200 - application/json

Task accepted.

code · integer · requerido

Error code; specifically define the error code

message · string · requerido

error message

data · object · requerido

Show child attributes