Kling 视频接口

接口地址：https://fast.openpix.cc，也可使用本站兼容域名。API Key 需要选择「视频分组」。

当前按每次成功生成计费：普通用户其余型号 0.07 元/次，SVIP 其余型号 0.06 元/次；Kling 2.6 动作控制均为 0.08 元/次。每次请求生成一个视频，5 秒和 10 秒不重复按秒收费。当前通道为 720p，不支持请求 1080p、4K 或自定义分辨率。

API 型号功能时长音频普通用户SVIP
kling-v2.1图生视频，必须上传一张首帧5 / 10 秒支持0.07 元/次0.06 元/次
kling-v2.6文生视频、单首帧图生视频5 / 10 秒当前不支持0.07 元/次0.06 元/次
kling-v3.0文生视频、单首帧、首尾帧10 秒当前不支持0.07 元/次0.06 元/次
kling-v4.0文生视频、单首帧、首尾帧5 秒支持0.07 元/次0.06 元/次
kling-v4.0-flash文生视频、单首帧5 / 10 秒支持0.07 元/次0.06 元/次
kling-v2.6-motion-control一张角色图片＋一个动作参考视频跟随参考视频，2.5–13 秒默认保留参考视频原声0.08 元/次0.08 元/次

报价与能力可能更新，请同时查看本站模型广场。

当前本站可灵接口尚未开放 Omni 多参考图融合；单首帧、首尾帧与动作控制是不同用法，请按各型号支持的参数调用。

提交任务

POST /v1/videos，支持 JSON 和 multipart/form-data。鉴权头为 Authorization: Bearer <本站 API Key>。

curl https://fast.openpix.cc/v1/videos \
  -H "Authorization: Bearer $SITE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "kling-v4.0-flash",
    "prompt": "一只红色纸船在平静水面缓慢漂动，自然光，固定镜头",
    "seconds": "5",
    "size": "1280x720",
    "audio": true
  }'

返回本站任务编号 id。保存该编号，后续查询和下载都使用它，不要因为生成需要等待而重复提交。

字段说明
model上表中的完整型号
prompt必填，视频描述
seconds / duration普通视频按型号传 5 或 10；3.0 默认为 10，其余默认为 5。动作控制的实际时长由参考视频决定
size1280x720、720x1280 或 720x720
ratio / aspect_ratio可代替 size，取 16:9、9:16 或 1:1。同时传入时必须一致
resolution可选，只接受 720p
audio布尔值。2.6 和 3.0 不接受 true；支持音频的型号不另收音频费用
input_reference / image / first_frame_image单张首帧，HTTPS URL 或图片 Data URL；multipart 可直接上传文件
last_frame_image / end_frame只用于 3.0 / 4.0，必须同时有首帧
reference_video / video_url / motion_video动作控制的参考视频，HTTPS URL、Data URL 或 multipart 文件
orientation动作控制构图，FULL（默认，全身）或 HALF（上半身）
keep_sound动作控制是否保留原声，布尔值，默认 true

图片支持 PNG/JPEG/WebP，接口也接受 GIF，单张最多 20MB。动作视频支持 MP4/WebM，网页选取文件最多 50MB。参考视频须为 2.5–13 秒，建议使用清楚可辨的人物动作。一个任务只对应一个视频，不能把多张首帧作为批量生成传入；首尾帧两张图仍对应一个视频。

参考 URL 必须是可公开访问的 HTTPS 地址，不接受内网地址、需要登录才能下载的地址或带账号密码的 URL。

图生视频：Kling 2.6，10 秒

curl https://fast.openpix.cc/v1/videos \
  -H "Authorization: Bearer $SITE_API_KEY" \
  -F "model=kling-v2.6" \
  -F "prompt=镜头缓慢推进，保持主体与原图一致" \
  -F "seconds=10" \
  -F "size=1280x720" \
  -F "input_reference=@first.png;type=image/png"

首尾帧

使用 kling-v3.0（10 秒）或 kling-v4.0（5 秒），同时传 input_reference 和 last_frame_image。首尾帧与同型号单首帧同价：普通用户 0.07 元/次，SVIP 0.06 元/次。

{
  "model": "kling-v4.0",
  "prompt": "从首帧自然过渡到尾帧，镜头稳定",
  "seconds": "5",
  "ratio": "16:9",
  "input_reference": "https://your-storage.example/first.png",
  "last_frame_image": "https://your-storage.example/last.png"
}

动作控制

{
  "model": "kling-v2.6-motion-control",
  "prompt": "让图片中的角色自然复现参考视频的动作",
  "input_reference": "https://your-storage.example/character.png",
  "reference_video": "https://your-storage.example/motion.mp4",
  "orientation": "FULL",
  "keep_sound": true,
  "resolution": "720p"
}

动作控制不能同时传尾帧。不要用普通 kling-v2.6 型号传动作视频。网页会单列「Kling 2.6 · 动作控制」，时长显示为随参考视频。

查询任务

GET /v1/videos/{id}，使用提交任务时的同一个本站 API Key。

curl "https://fast.openpix.cc/v1/videos/$TASK_ID" \
  -H "Authorization: Bearer $SITE_API_KEY"

状态通常为 queued、in_progress、completed 或 failed。建议间隔 5–10 秒查询；排队、重试或人工核实阶段可能持续更久。客户端超时并不代表任务失败，应继续查询原编号。

若提交返回 HTTP 409 且含 submission_unconfirmed 和 data.task_id，保存该编号并核对原任务，不要重新生成。任务编号不存在或不属于当前账号时，本站可能返回 HTTP 400、task_not_exist。

下载结果

完成后通过 GET /v1/videos/{id}/content 下载，支持 HEAD 和单段字节 Range。该地址需要本站 Key 鉴权。

curl "https://fast.openpix.cc/v1/videos/$TASK_ID/content" \
  -H "Authorization: Bearer $SITE_API_KEY" \
  -o output.mp4

客户拿到的是本站任务编号和本站内容地址。不要把服务端 Key 写入网页代码或 URL 参数；浏览器播放请使用本站创作台，或由自己的后端携带 Key 下载后交付给前端。

常见错误