Opprett en Kling bilde-til-video-oppgave
Konverter ett enkelt bilde til en Kling-video via CometAPI POST /kling/v1/videos/image2video, med asynkron opprettelse av oppgave og sporing av fremdrift med task ID.
Før du kaller det
- Oppgi én offentlig bilde-URL eller én base64-kodet bildestreng
- Bruk et bilde som oppfyller Kling sine pikselkrav; svært små miniatyrbilder blir avvist av genereringsoppgaven
- Start med standardeksempelet
kling-v2-6, og velg deretter et annetmodel_namefra OpenAPI-enum når du trenger en annen modellvariant - Hold den første forespørselen enkel: ett inngangsbilde, én prompt, ingen sluttframe, ingen bevegelsesmasker
- Bruk
dynamic_maskssom en matrise med maske- og baneobjekter når du trenger kontrollert lokal bevegelse - Bruk
sound: offfor en deterministisk første forespørsel uten lyd på modellvarianter som støtter generert lyd
Navngiving av modeller
Bruk vanlige Kling video model ID-er på dette endepunktet. Behold Omni model ID-er for Omni Video.Oppgaveflyt
Send inn bilde-til-video-forespørselen
task_id.Poll oppgaven
Lagre resultatet
Autorisasjoner
Bearer token authentication. Use your CometAPI key.
Kropp
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