Multi-image vers vidéo

Créez des vidéos Kling à partir de plusieurs images via CometAPI POST /kling/v1/videos/multi-image2video, avec contrôle du mouvement et paramètres de sortie pour la génération.

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
  }
}

Utilisez cet endpoint lorsqu’une seule image source ne suffit pas et que vous souhaitez que Kling construise le mouvement à partir de plusieurs images de référence.

​

Avant de l’appeler

• Préparez 2 à 4 images dans image_list
• Commencez avec model_name: kling-v1-6 ou un autre modèle actuel que vous avez validé
• Gardez le premier test simple : un prompt court, aucun masque de mouvement, aucun paramètre de callback supplémentaire

​

Flux de tâche

1. Soumettre la requête multi-image

   Envoyez la liste d’images, le prompt et la durée, puis enregistrez le task_id Kling renvoyé.

2. Interroger la tâche

   Poursuivez avec Individual Queries jusqu’à ce que la tâche atteigne un état terminal.

3. Conserver le résultat

   Stockez la vidéo finalisée si vous avez besoin d’une conservation au-delà de l’URL de livraison du fournisseur.

La validation en direct du 2026-03-13 a confirmé qu’une requête minimale à deux images était acceptée et renvoyait task_status: submitted.

Pour la référence complète des paramètres, consultez la documentation officielle de Kling.

Autorisations

Authorization · string · header · requis

Bearer token authentication. Use your CometAPI key.

Corps

application/json

model_name · string · défaut: kling-v1-6 · requis

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

duration · string · défaut: 5 · requis

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

image_list · object[] · requis

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 · défaut: The cat turns its head and blinks. · requis

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.

Réponse

200 - application/json

Task accepted.

code · integer · requis

Error code; specifically define the error code

message · string · requis

error message

data · object · requis

Show child attributes