功能介绍

输入文字生成视频。此入口采用可灵旧版原生格式：model_name、duration、mode等字段直接位于请求体顶层，不放metadata。

鉴权与操作步骤

所有请求发送到 https://top.qingyuntop.ai。在请求头填写 Authorization: Bearer YOUR_API_KEY，将 YOUR_API_KEY 替换为青云TOP API 控制台创建的 API Key；Bearer 与密钥之间保留一个空格。

  1. 携带鉴权请求头，按本页参数创建任务。
  2. 保存返回的任务标识，查询至成功后下载视频。创建成功仅表示任务已受理。

JSON 请求使用 Content-Type: application/json。示例中的占位密钥需替换为你的 API Key。实际业务请在服务端保存密钥，不要放进公开网页。

创建接口与参数

POST /kling/v1/videos/text2video，只接受 JSON。model_name（字符串）必填，建议精确使用 kling-v1、kling-v1-6 或 kling-v2-master；本入口兼容 model 字段，但不要同时填写两个不同名称。

  • prompt（字符串）：文生必填非空文字。
  • duration（字符串）：示例为 "5"，单位秒。这里不使用统一接口的 seconds 字段。
  • mode（字符串）：v1/v1-6用std或pro，v2-master仅pro。
  • aspect_ratio（字符串）：文生可选16:9、9:16、1:1；建议显式填写。
  • negative_prompt（字符串）、cfg_scale（数值，默认0.5）为可选控制项，只按具体型号支持使用。
  • callback_url、external_task_id（字符串）可选，见回调与ID说明。

请求鉴权始终使用本站 API Key。官方新版 contents/settings/options 结构不适用于本入口，请使用本页给出的地址和字段。

运行示例前

cURL 示例使用 Bash 换行语法；Python 需要安装 requests；Node.js 使用 20 或更高版本，将代码保存为 .mjs。带素材的示例必须把 https://example.com/... 替换为上游能直接读取的真实 HTTPS 文件地址，不是网页地址或本机文件路径。

代码示例

curl --fail-with-body "https://top.qingyuntop.ai/kling/v1/videos/text2video" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model_name": "kling-v1-6",
  "prompt": "主体自然运动，镜头缓慢拉近，柔和自然光。",
  "mode": "std",
  "duration": "5",
  "aspect_ratio": "16:9"
}'

返回与查询

同时检查 HTTP 状态与 JSON 中 code=0。成功示意：

{"code":0,"message":"SUCCEED","data":{"task_id":"YOUR_TASK_ID","task_status":"submitted"}}

data.task_id 已由本站转换为公开任务 ID，原样保存，按原生文生任务查询查询；submitted只表示受理，不表示已完成。