Kling 视频接口

Kling AI 视频/图像生成接口文档。

接口地址

提交任务

POST https://www.moyu.info/v1/video/generations

查询结果

GET https://www.moyu.info/v1/videos/{task_id}

获取视频内容

GET https://www.moyu.info/v1/videos/{task_id}/content

请求示例

文生视频 (Text-to-Video)

cURL

其他语言

图生视频 (Image-to-Video)

cURL

带完整参数的请求

cURL

提交任务响应格式

{
  "id": "848244325094924334",
  "task_id": "848244325094924334",
  "object": "video",
  "model": "MODEL_NAME",
  "status": "",
  "progress": 0,
  "created_at": 0
}

重要：Kling为异步接口，返回task_id后需要使用该ID查询生成结果。

查询结果

使用返回的task_id查询视频生成进度和结果。

查询请求示例

cURL

其他语言

查询响应格式

任务进行中

{
  "id": "848244325094924334",
  "object": "video",
  "model": "",
  "status": "queued",
  "progress": 20,
  "created_at": 1770265725
}

视频生成成功

{
  "id": "848244325094924334",
  "object": "video",
  "model": "MODEL_NAME",
  "status": "completed",
  "progress": 100,
  "seconds": 5,
  "created_at": 1770265725,
  "metadata": {
    "url": "https://example.com/video.mp4"
  }
}

任务失败

{
  "id": "848244325094924334",
  "object": "video",
  "model": "MODEL_NAME",
  "status": "failed",
  "progress": 0,
  "error": {
    "code": "invalid_parameters",
    "message": "Invalid duration parameter"
  },
  "created_at": 1770265725
}

获取视频内容

当任务状态为 completed 时，可以通过以下方式下载视频内容。

下载请求示例

cURL

其他语言

停止任务

在任务执行过程中，可以取消正在进行的任务。

停止请求示例

cURL

其他语言

停止任务响应格式

{
  "id": "848251142349520901",
  "object": "video",
  "model": "kling-v1",
  "status": "cancelled",
  "progress": 100,
  "created_at": 1770267350,
  "completed_at": 1770267360,
  "error": {
    "message": "Task cancelled by user",
    "code": "task_cancelled"
  }
}

注意：只能停止状态为queued或in_progress的任务。已完成（completed）或已失败（failed）的任务无法取消。

请求参数

提交任务参数

参数	类型	必填	说明
model	string	是	模型名称
prompt	string	是	描述提示词，详细描述想要生成的内容
duration	integer	否	视频时长（秒），支持 5 或 10，默认为 5
mode	string	否	生成模式：std(标准模式) 或 pro(专业模式)，默认为 pro
image	string	图生视频时需要	输入图片的URL地址或Base64编码
metadata	object	否	扩展参数对象，包含额外的视频生成配置
metadata.mode	string	否	生成模式，支持 "pro" 或 "std"（同 mode 参数）
metadata.cfg_scale	number	否	CFG Scale（提示词相关性），范围 0.1-1.0，默认 0.6
metadata.aspect_ratio	string	否	视频宽高比，支持 "16:9", "9:16", "1:1"
metadata.negative_prompt	string	否	负面提示词，描述不希望出现的内容
metadata.seed	integer	否	随机种子，用于可重复生成，范围 0-4294967295

duration 参数说明：

可选值：5（生成5秒视频）或 10（生成10秒视频）

默认值：5秒

使用其他值会导致任务失败

mode 参数说明：

std（标准模式）：成本较低，生成速度更快

pro（专业模式）：生成时长更长，视频质量更高

默认值：pro

提示词建议：

使用详细、具体的描述

包含场景、光线、动作、情绪等元素

支持中文和英文提示词

长度适中，避免过于简短或冗长

图生视频说明：

使用 image 参数提供输入图片

支持URL或Base64编码格式

prompt用于描述期望的动画效果

建议设置合适的duration参数

metadata 字段说明：

mode：生成模式，同顶层 mode 参数，可选 "pro"（专业模式）或 "std"（标准模式）

cfg_scale：CFG Scale（提示词相关性），控制生成结果与提示词的贴合度

范围：0.1 - 1.0

默认值：0.6

较高值会更严格遵循提示词，较低值允许更多创造性

aspect_ratio：视频宽高比

支持："16:9"（横屏）、"9:16"（竖屏）、"1:1"（方形）

常用于快速设置视频比例

negative_prompt：负面提示词

描述不希望在视频中出现的元素

例如："blurry, low quality, distorted, watermark"

seed：随机种子

范围：0 - 4294967295

相同的 seed 配合相同参数可以生成相似结果

用于可重复生成或细微调整

响应字段说明

提交任务响应字段

字段	类型	说明
id	string	任务唯一标识符
task_id	string	任务ID，用于查询生成结果
object	string	对象类型，固定为 "video"
model	string	使用的模型名称
status	string	提交时该字段为空字符串（异步任务尚无状态），需查询接口获取实际状态
progress	integer	进度百分比（0-100）
created_at	integer	创建时间戳

查询结果响应字段

字段	类型	说明
id	string	任务唯一标识符
object	string	对象类型，固定为 "video"
model	string	使用的模型名称
status	string	任务状态：queued(排队中)、in_progress(处理中)、completed(成功)、failed(失败)
progress	integer	进度百分比（0-100）
seconds	integer	视频时长（秒），成功时返回
metadata	object	扩展信息，成功时 `metadata.url` 为生成的视频URL
error	object	错误信息（仅在failed状态时返回）
created_at	integer	创建时间戳

接口地址#

提交任务#

查询结果#

获取视频内容#

请求示例#

文生视频 (Text-to-Video)#

cURL#

其他语言#

图生视频 (Image-to-Video)#

cURL#

带完整参数的请求#

cURL#

提交任务响应格式#

查询结果#

查询请求示例#

cURL#

其他语言#

查询响应格式#

任务进行中#

视频生成成功#

任务失败#

获取视频内容#

下载请求示例#

cURL#

其他语言#

停止任务#

停止请求示例#

cURL#

其他语言#

停止任务响应格式#

请求参数#

提交任务参数#

响应字段说明#

提交任务响应字段#

查询结果响应字段#

接口地址

提交任务

查询结果

获取视频内容

请求示例

文生视频 (Text-to-Video)

cURL

其他语言

图生视频 (Image-to-Video)

cURL

带完整参数的请求

cURL

提交任务响应格式

查询结果

查询请求示例

cURL

其他语言

查询响应格式

任务进行中

视频生成成功

任务失败

获取视频内容

下载请求示例

cURL

其他语言

停止任务

停止请求示例

cURL

其他语言

停止任务响应格式

请求参数

提交任务参数

响应字段说明

提交任务响应字段

查询结果响应字段