Créer une tâche image-vers-vidéo Kling
Convertissez une image unique en vidéo Kling via CometAPI POST /kling/v1/videos/image2video, avec création de tâche asynchrone et suivi de progression par ID de tâche.
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 autremodel_namedepuis 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_maskscomme tableau d’objets masque-et-trajectoire lorsque vous avez besoin d’un mouvement local contrôlé - Utilisez
sound: offpour 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
Soumettre la requête image-vers-vidéo
task_id Kling renvoyé.Interroger la tâche
Stocker le résultat
Autorisations
Bearer token authentication. Use your CometAPI key.
Corps
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.
Text prompt describing the desired motion. Maximum 500 characters.
Elements to exclude from the video. Maximum 200 characters.
Webhook URL to receive task status updates when the task completes.
Generation mode. std for standard (faster), pro for professional (higher quality).
std, pro Model ID for this image-to-video request. Use kling-v3 for new requests. Use Omni model IDs only with the Omni Video endpoint.
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 Tail-frame reference image as a Base64 string or public URL. Same format requirements as image. Controls the last frame of the generated video.
Prompt adherence strength. Higher values follow the prompt more closely. Range: 0–1.
Output video length in seconds. Use 5 or 10; omit to use 5.
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.
Optional motion masks. Each entry contains a mask image and an ordered trajectory list.
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.
Optional generated-audio switch for models that support video sound. Use on or off, or omit the field for the model default.
on, off