curl --request POST \
--url https://api.vidgo.ai/api/generate/submit \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"model": "kwaivgi/kling-v4.0/image-to-video",
"input": {
"image_urls": [
"https://example.com/dancer.png"
],
"prompt": "The dancer spins and her red dress flares out, the camera slowly circles her, soft piano music",
"duration": 5,
"resolution": "720p"
}
}
'
{
"code": 200,
"data": {
"task_id": "task-unified-1762160000-abc123",
"status": "not_started",
"created_time": "2026-11-03T10:30:00"
}
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}Request timeout{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}Kling
Kling 4.0 图生视频
Kling 4.0 图生视频 API 将起始帧（可选以第二张图片作为结束帧）生成 3–30 秒、720p 或 1080p 的视频。
POST
/
api
/
generate
/
submit
curl --request POST \
--url https://api.vidgo.ai/api/generate/submit \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"model": "kwaivgi/kling-v4.0/image-to-video",
"input": {
"image_urls": [
"https://example.com/dancer.png"
],
"prompt": "The dancer spins and her red dress flares out, the camera slowly circles her, soft piano music",
"duration": 5,
"resolution": "720p"
}
}
'
{
"code": 200,
"data": {
"task_id": "task-unified-1762160000-abc123",
"status": "not_started",
"created_time": "2026-11-03T10:30:00"
}
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}Request timeout{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}- 提交后会返回
task_id。如果提供了callback_url，当任务状态变为finished或failed时，系统会向callback_url发送 POST 请求。 - 无论是否提供
callback_url，都可以通过统一的查询任务状态接口获取结果。
模型
- kwaivgi/kling-v4.0/image-to-video — Kling 4.0 图生视频，使用起始帧和可选的结束帧。
功能
- 以一张起始帧生成最长 30 秒的图生视频。
- 用第二张图片实现首尾帧控制。
- 支持单段或多镜头提示词。
- 输出 720p 或 1080p，画面比例跟随输入图片。
- 输出带音轨。
输入模式
- 起始帧：
image_urls传一张图片。 - 起始帧加结束帧：
image_urls传两张图片，起始帧在前。
prompt 或 multi_prompt 镜头列表：
- 单段提示词：传
prompt，可选传duration。 - 多镜头：传
multi_prompt，每个镜头一项。视频时长为各镜头时长之和；duration可省略，或设为该总和。
必填参数
image_urls（string[]）：一到两个公开 HTTP(S) 图片 URL。第一张为起始帧，可选的第二张为结束帧。prompt（string）或multi_prompt（object[]）：必须且只能传一个。prompt：去除首尾空白后 1–26,000 个字符。multi_prompt：非空的镜头列表{prompt, duration?}。每个镜头的prompt为 1–512 个字符，duration为1–30的整数（默认5）。各镜头时长之和须为 3–30 秒。
可选参数
duration（integer）：输出时长，3–30秒。默认5；使用multi_prompt时默认为各镜头时长之和，显式传入的值必须与之相等。resolution（string）：720p或1080p。默认720p。
输出
任务完成后，查询任务状态和回调内容的files 数组中会返回一个带音轨的 MP4 视频。
示例
- 仅起始帧：一张舞者图片，配上动作和音乐描述，720p，5 秒。
- 起始帧加结束帧，1080p，带回调：以花苞和盛开的花作为首尾帧，生成 8 秒延时视频，并提供
callback_url。
注意事项
- 本 ID 的画面比例由输入图片决定，不支持
aspect_ratio，传入会返回 400。 - 要用更多参考图、参考视频或主体引导生成，请用 Kling 4.0 参考生视频。
- 上文未列出的字段会返回 400。
model和callback_url放在请求根级，不要放进input。 - 积分在提交时预扣，取决于
resolution和输出duration。任务失败会全额退还。当前费率见定价页。 - 仅支持 720p 或 1080p 输出；本模型没有 4K 或 HDR 档位，没有音频开关，也不支持
seed。
授权
所有 API 接口都需要 Bearer Token 认证
获取 API Key：
进入 仪表盘 → API 密钥（API Key 管理页面）获取你的 API Key
在请求头中添加：
Authorization: Bearer VIDGO_API_KEY
请求体
application/json