创建一个 Kling 图生视频任务
通过 CometAPI POST /kling/v1/videos/image2video 将单张图片转换为 Kling 视频,支持异步任务创建和通过任务 ID 跟踪进度。
调用前准备
- 提供一个公开图片 URL 或一个 base64 图片字符串
- 使用符合 Kling 像素要求的图片;过小的缩略图会被生成任务拒绝
- 先从默认的
kling-v2-6示例开始,然后在需要不同模型路线时,从 OpenAPI 枚举中选择另一个model_name - 首次请求尽量保持简单:一张输入图片、一个 prompt、无尾帧、无运动蒙版
- 当你需要可控的局部运动时,使用
dynamic_masks作为由蒙版和轨迹对象组成的数组 - 对于支持生成声音的模型路线,首次请求可使用
sound: off以获得确定性的无音频结果
模型命名
在此端点上使用常规的 Kling 视频 model ID。Omni model ID 请保留给 Omni Video。任务流程
提交图生视频请求
task_id。轮询任务
保存结果
授权
Bearer token authentication. Use your CometAPI key.
请求体
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