Creare un task Kling da immagine a video
Converti una singola immagine in un video Kling tramite CometAPI POST /kling/v1/videos/image2video, con creazione asincrona del task e monitoraggio dell’avanzamento tramite task ID.
Prima di chiamarlo
- Fornisci un URL pubblico di immagine oppure una stringa immagine base64
- Usa un’immagine che soddisfi i requisiti di pixel di Kling; le miniature molto piccole vengono rifiutate dal task di generazione
- Inizia con l’esempio predefinito
kling-v2-6, poi scegli un altromodel_namedall’enum OpenAPI quando ti serve un diverso percorso di modello - Mantieni semplice la prima richiesta: un’immagine di input, un prompt, nessun fotogramma finale, nessuna motion mask
- Usa
dynamic_maskscome array di oggetti mask-and-trajectory quando ti serve un movimento locale controllato - Usa
sound: offper una prima richiesta deterministica senza audio sui percorsi di modello che supportano il suono generato
Nomi dei modelli
Usa i normali model ID dei modelli video Kling su questo endpoint. Riserva i model ID dei modelli Omni per Omni Video.Flusso del task
Invia la richiesta da immagine a video
task_id di Kling restituito.Interroga il task
Salva il risultato
Autorizzazioni
Bearer token authentication. Use your CometAPI key.
Corpo
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