Skip to main content
POST
cURL
Utilisez ce endpoint lorsqu’une seule image source ne suffit pas et que vous voulez que Kling construise le mouvement à partir de plusieurs images de référence.

Avant de l’appeler

  • Préparez 1 à 4 images dans image_list
  • Utilisez des images qui respectent les exigences de pixels de Kling ; les minuscules vignettes sont rejetées par la tâche de génération
  • Omettez model_name sauf si vous devez spécifiquement sélectionner un modèle compatible avec cette route
  • Gardez le premier test simple : un prompt court, duration: 5, sans paramètres de callback supplémentaires
  • N’envoyez pas de champs de masque image-vers-vidéo comme static_mask ou dynamic_masks sur cette route

Flux de tâche

1

Envoyer 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

Continuez avec Obtenir une tâche Kling jusqu’à ce que la tâche atteigne un état terminal.
3

Conserver le résultat

Stockez la vidéo terminée si vous avez besoin d’une conservation au-delà de l’URL de livraison du fournisseur.
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
image_list
object[]
requis

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>
défaut:kling-v1-6

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

Options 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>
défaut:std

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

Options disponibles:
std,
pro
duration
string
défaut: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.

Options 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.

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