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/text-to-video",
"input": {
"prompt": "A lighthouse keeper climbs the spiral stairs at night, lantern swinging, storm waves crashing outside, handheld camera, the wind howling",
"duration": 10,
"resolution": "720p",
"aspect_ratio": "16:9"
}
}
'{
"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/text-to-video",
"input": {
"prompt": "A lighthouse keeper climbs the spiral stairs at night, lantern swinging, storm waves crashing outside, handheld camera, the wind howling",
"duration": 10,
"resolution": "720p",
"aspect_ratio": "16:9"
}
}
'{
"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/text-to-video — Kling 4.0 文生视频，3–30 秒，支持单段或多镜头提示词，720p 或 1080p。
功能
- 一次生成最长 30 秒的文生视频。
- 通过
multi_prompt编写多镜头提示词，并为每个镜头设置时长。 - 输出 720p 或 1080p。
- 五种宽高比：
auto、16:9、9:16、1:1、21:9。 - 输出带音轨，可在提示词中描述对白、音效或环境声。
输入模式
- 单段提示词：传
prompt，可选传duration。 - 多镜头：传
multi_prompt，每个镜头一项。视频时长为各镜头时长之和；duration可省略，或设为该总和。
必填参数
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。aspect_ratio（string）：auto、16:9、9:16、1:1或21:9。默认auto。
输出
任务完成后，查询任务状态和回调内容的files 数组中会返回一个带音轨的 MP4 视频。
示例
- 单段提示词，10 秒：一段包含场景、镜头和声音描述的
prompt，16:9，720p。 - 三镜头 1080p 序列，带回调：
multi_prompt中三个镜头分别为 4、6、5 秒（共 15 秒），9:16，并提供callback_url。
注意事项
- 同时传
prompt和multi_prompt，或两者都不传，会返回 400。使用multi_prompt时，duration与镜头总时长不一致会返回 400。 - 本 ID 只接受文本。要从图片开始，请用 Kling 4.0 图生视频；要用图片、视频或主体引导生成，请用 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