可灵 Responses 创建视频

功能介绍

通过 POST /v1/responses 生成视频，适用于已使用 Responses 结构的应用。推荐 background=true，先获得响应 ID，再查询结果。

鉴权与操作步骤

所有请求发送到 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。实际业务请在服务端保存密钥，不要放进公开网页。

请求参数

model（字符串，必填）为本目录模型表中的精确名称。input 为字符串或消息数组：文本项用 {"type":"input_text","text":"..."}，图片项用 {"type":"input_image","image_url":"https://..."}。这里是视频输入，不是普通聊天回复或任意工具调用。

seconds 为时长，优先于兼容字段 duration；metadata 为对象，放置模型专属参数。background、stream 为布尔值。模型限制仍与统一视频一致；换一种协议不会增加模型能力。

input 文本优先于顶层兼容字段 prompt；多个文本项用换行合并。图片按顶层 image → input_reference → images → input 内图片的顺序合并去重，建议统一使用一种输入位置。

可灵以提取到的第一张图片进入图生分支，第二张补为 metadata.image_tail，后续图片不构成多图参考。首尾帧字段能够转发不代表当前三个型号的所有模式都支持，应先确认上游模型能力。仅把图片放在 metadata.image / image_tail 不会触发 Responses 的图生分支；必须使用 input_image 或顶层 image / input_reference。

可灵 Responses 顶层 mode 优先于 metadata.mode；size 只用于比例映射。完整模型字段见统一参数。

运行示例前

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

文生视频示例

curl --fail-with-body "https://top.qingyuntop.ai/v1/responses" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "kling-v1-6",
  "input": "一只小猫在窗边缓慢转头，阳光柔和，镜头平稳。",
  "seconds": 5,
  "background": true,
  "metadata": {
    "mode": "std",
    "aspect_ratio": "16:9"
  }
}'

首帧图生示例

curl --fail-with-body "https://top.qingyuntop.ai/v1/responses" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "kling-v1-6",
  "input": [
    {
      "role": "user",
      "content": [
        {
          "type": "input_text",
          "text": "让画面中的主体自然运动，保持外观一致。"
        },
        {
          "type": "input_image",
          "image_url": "https://example.com/first-frame.png"
        }
      ]
    }
  ],
  "seconds": 5,
  "background": true,
  "metadata": {
    "mode": "std",
    "aspect_ratio": "16:9"
  }
}'

返回结果

保存返回的 id（response ID），然后打开Responses 查询与下载。任务 ID 从返回的 metadata.task_id 读取，不要手动修改 ID 前缀。