Kling 视频生成

Kling 使用 OpenAI 兼容入口提交异步视频任务，以 JSON 为主，支持文生、图生、首尾帧与动作控制等场景，扩展参数通过 传递。

POST /v1/videos

任务提交成功返回 id 与 status，用 任务查询 轮询结果。

当前可用模型

请求头

名称	类型	必填	说明
	string	是	请求身份认证。使用 Bearer Token，示例：
	string	是	请求内容类型，必须设置为

请求体

名称	类型	必填	说明
	string	是	模型名称
	string	是	提示词，支持中文和英文
	string	否	视频时长（秒）
	string	否	快速尺寸输入，例如
	string	否	参考图片 URL（图生视频）
	object	否	扩展参数容器，建议把上游原生参数都放进去

metadata

名称	类型	说明
	object	输出配置：（时长秒）、（ / ）、（ / / ）、（ / ）
	string	场景类型：（动作控制）、（数字人生成）、（对口型）、（模板特效）
	string	运动等级： / （动作控制计费分档）
	boolean	错峰计费： 错峰生成 / 即时生成
	string	首尾帧中的尾帧图片 URL
	string	参考视频 URL
	string	原生 FileInfos 透传（高级用法）
	string	原生 ExtInfo 字符串透传（高级用法）

请求示例

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

响应示例

处理中

{
  "id": "task_ZOAIupBoCLMo3dmUGcrKUcUEUnCLctc6",
  "object": "video",
  "model": "Kling-3.0-Omni",
  "status": "processing",
  "progress": 50,
  "created_at": 1774494511
}

已完成

{
  "id": "task_ZOAIupBoCLMo3dmUGcrKUcUEUnCLctc6",
  "object": "video",
  "model": "Kling-3.0-Omni",
  "status": "completed",
  "progress": 100,
  "created_at": 1774494511,
  "completed_at": 1774494622,
  "metadata": {
    "url": "https://example.com/video/aigcVideoGenFile.mp4"
  },
  "video_url": "https://example.com/video/aigcVideoGenFile.mp4"
}

响应字段

名称	类型	说明
	string	任务 ID
	string	固定为
	string	模型名称
	string	任务状态：、、、、
	integer	进度百分比
	integer	创建时间戳
	integer	完成时间戳（完成时返回）
	string	视频地址（在 metadata 中）
	string	视频地址（与 相同）

相关接口

• 视频系列概览
• Kling 任务查询
• 错误码查询