POST
https://zx1.deepwl.net
/
v1
/
videos
Kling 视频生成
curl --request POST \
  --url https://zx1.deepwl.net/v1/videos \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "<string>",
  "prompt": "<string>",
  "seconds": "<string>",
  "size": "<string>",
  "image": "<string>",
  "metadata": {},
  "metadata.output_config": {},
  "metadata.scene_type": "<string>",
  "metadata.motion_level": "<string>",
  "metadata.offpeak": true,
  "metadata.last_frame_url": "<string>",
  "metadata.video_url": "<string>",
  "metadata.file_infos": "<string>",
  "metadata.ext_info": "<string>"
}
'
{
  "id": "video_123",
  "task_id": "video_123",
  "object": "video",
  "model": "kling-3.0-omni-720p-ref-audio",
  "status": "queued",
  "progress": 0,
  "created_at": 1712697600
}

​
Kling 视频生成

Kling 使用 POST /v1/videos 提交任务，并以 JSON 提交为主。
  • 路由入口是 POST /v1/videos。
  • 当前使用 JSON 提交。
  • 支持文生视频、图生视频、首尾帧生视频等多种场景。
  • 通过 metadata 字段传递扩展参数，包括输出配置、场景类型等。
  • 提交成功后返回任务 id 与 status，后续用 任务状态查询 轮询结果。

​
支持模型

  • Kling-3.0-Omni：Kling 3.0 全能版
  • Kling-2.6：Kling 2.6 版本
  • Kling-2.5：Kling 2.5 版本

​
方法与路径

POST /v1/videos

​
请求示例

curl -X POST https://zx1.deepwl.net/v1/videos \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "Kling-3.0-Omni",
    "prompt": "赛博朋克城市夜景，镜头慢慢推进",
    "seconds": "5",
    "metadata": {
      "output_config": {
        "resolution": "720P",
        "aspect_ratio": "16:9"
      }
    }
  }'

​
场景示例

​
文生视频

{
  "model": "Kling-3.0-Omni",
  "prompt": "赛博朋克城市夜景，镜头慢慢推进",
  "seconds": "5",
  "metadata": {
    "output_config": {
      "resolution": "720P",
      "aspect_ratio": "16:9"
    }
  }
}

​
图生视频

{
  "model": "Kling-3.0-Omni",
  "prompt": "让人物向前走并微笑",
  "image": "https://example.com/character.png",
  "seconds": "5",
  "metadata": {
    "output_config": {
      "resolution": "1080P",
      "aspect_ratio": "9:16"
    }
  }
}

​
首尾帧生视频

{
  "model": "Kling-3.0-Omni",
  "prompt": "死寂系统空间中，角色被蓝色面板照亮",
  "seconds": "15",
  "size": "720x1280",
  "metadata": {
    "output_config": {
      "duration": 15,
      "resolution": "720P",
      "aspect_ratio": "9:16",
      "audio_generation": "Enabled"
    },
    "last_frame_url": "https://example.com/last-frame.png"
  }
}

​
动作控制

{
  "model": "Kling-3.0-Omni",
  "prompt": "人物挥手打招呼",
  "image": "https://example.com/character.png",
  "seconds": "5",
  "metadata": {
    "scene_type": "motion_control",
    "motion_level": "pro",
    "output_config": {
      "resolution": "1080P",
      "aspect_ratio": "16:9"
    }
  }
}

​
响应示例

注意：响应中的 model 字段可能包含计费规格后缀（如 720p-ref-audio），与请求传入的模型名称不同。 
{
  "id": "video_123",
  "task_id": "video_123",
  "object": "video",
  "model": "kling-3.0-omni-720p-ref-audio",
  "status": "queued",
  "progress": 0,
  "created_at": 1712697600
}

​
认证

Authorization: Bearer YOUR_API_KEY

​
Body

​
model
string
必填
模型名称。例如 Kling-3.0-Omni、Kling-2.6、Kling-2.5。
​
prompt
string
必填
提示词。生成视频的文本描述,支持中文和英文。
​
seconds
string
视频时长。例如 5、10、15。
​
size
string
视频尺寸。快速尺寸输入,例如 720x1280。
​
image
string
参考图片。参考图片 URL。
​
metadata
object
元数据。扩展参数容器,建议把上游原生参数都放到 metadata 中。
​
metadata.output_config
object
输出配置。建议把原生参数都放到 output_config 中。
  • duration:时长(秒)
  • resolution:分辨率(720P、1080P)
  • aspect_ratio:画幅比例(16:9、9:16、1:1)
  • audio_generation:音频生成(Enabled、Disabled)
​
metadata.scene_type
string
场景类型。示例:motion_control(动作控制)、avatar_i2v(数字人生成)、lip_sync(对口型)、template_effect(模板特效)。
​
metadata.motion_level
string
运动等级。示例:std(标准)、pro(专业,用于动作控制计费分档)。
​
metadata.offpeak
boolean
是否错峰计费。true:错峰生成视频;false:即时生成视频。
​
metadata.last_frame_url
string
首尾帧中的尾帧。首尾帧生视频时指定尾帧图片 URL。
​
metadata.video_url
string
参考视频 URL。
​
metadata.file_infos
string
文件信息。原生 FileInfos 透传(高级用法)。
​
metadata.ext_info
string
扩展信息。原生 ExtInfo 字符串透传(高级用法)。

​
Response

​
id
string
任务 ID。
​
task_id
string
任务 ID（与 id 相同）。
​
object
string
固定为 video。
​
model
string
模型名称。
​
status
string
任务状态，常见值包括 queued、processing、completed、failed、cancelled。
​
progress
integer
进度百分比（0-100）。
​
created_at
integer
创建时间（Unix 时间戳）。

​
相关接口