Skip to main content
POST
cURL
Utilisez ce endpoint pour animer une image source en vidéo Kling.

Avant de l’appeler

  • Fournissez une URL d’image publique ou une chaîne d’image base64
  • Utilisez une image qui respecte les exigences de pixels de Kling ; les minuscules miniatures sont rejetées par la tâche de génération
  • Commencez avec l’exemple par défaut kling-v2-6, puis choisissez un autre model_name depuis l’enum OpenAPI lorsque vous avez besoin d’une autre variante de modèle
  • Gardez la première requête simple : une image d’entrée, un prompt, pas de frame de fin, pas de masques de mouvement
  • Utilisez dynamic_masks comme tableau d’objets masque-et-trajectoire lorsque vous avez besoin d’un mouvement local contrôlé
  • Utilisez sound: off pour une première requête déterministe sans audio sur les variantes de modèle qui prennent en charge le son généré

Nommage des modèles

Utilisez les model ID vidéo Kling ordinaires sur ce endpoint. Réservez les model ID Omni à Omni Video.

Flux de tâche

1

Soumettre la requête image-vers-vidéo

Créez la tâche et stockez le task_id Kling renvoyé.
2

Interroger la tâche

Poursuivez avec Obtenir une tâche Kling pour suivre l’état de la tâche jusqu’à ce que la sortie soit prête.
3

Stocker le résultat

Persistez l’asset terminé 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 le document officiel de Kling.

Autorisations

Authorization
string
header
requis

Bearer token authentication. Use your CometAPI key.

Corps

application/json
image
string
requis

Source image URL or base64 image string. Use an image that meets Kling pixel requirements; very small thumbnails are rejected. For base64 input, send the encoded image string as the field value.

prompt
string

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

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

Options disponibles:
std,
pro
model_name
enum<string>
défaut:kling-v1

Model ID for this image-to-video request. Use kling-v3 for new requests. Use Omni model IDs only with the Omni Video endpoint.

Options disponibles:
kling-v1,
kling-v1-5,
kling-v1-6,
kling-v2-master,
kling-v2-1,
kling-v2-1-master,
kling-v2-5-turbo,
kling-v2-6,
kling-v3
image_tail
string

Tail-frame reference image as a Base64 string or public URL. Same format requirements as image. Controls the last frame of the generated video.

cfg_scale
number

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

duration
string
défaut:5

Output video length in seconds. Use 5 or 10; omit to use 5.

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[]

Optional motion masks. Each entry contains a mask image and an ordered trajectory list.

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.

sound
enum<string>

Optional generated-audio switch for models that support video sound. Use on or off, or omit the field for the model default.

Options disponibles:
on,
off

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