跳转到主要内容
POST
cURL

使用说明

  • 帧:image_urls[0] 为必填的首帧,可选的 image_urls[1] 为尾帧;中间帧按时间顺序放在 keyframe_urls(最多 8 张)。输出画幅跟随首帧,因此不接受 aspect_ratio。
  • 帧数上限:帧总数(首帧 + 中间帧 + 尾帧)受 duration 限制:3 秒 4 帧、4 秒 5 帧、5 秒 6 帧、6 秒 7 帧、7 秒 8 帧、8 秒 9 帧,9 秒及以上 10 帧。超出上限会在创建任务前直接返回 400。
  • 引用帧:在 prompt 中用 @first_frame、@keyframe_1..@keyframe_N、@last_frame 描述各帧发生的内容,只能引用实际提供的帧。
  • 音频:每段视频都带原生音频,因此没有 generate_audio 参数,传入会被拒绝。
  • 不支持:negative_prompt、multi_shot / multi_prompt、参考视频、kling_elements、voices 与 4K 输出。

计费

按输出视频时长逐秒计费,每秒费率按分辨率(720p / 1080p)区分,与帧数无关。具体价格以 模型页 展示为准。

任务流程

创建请求返回 data.task_id。使用查询视频任务轮询,直到 status 变为 completed(结果位于 data.result)或 failed;也可以传入 callback_url,在任务进入终态时接收通知。

授权

Authorization
string
header
必填

在 Authorization 请求头中使用 Bearer APIPod_API_KEY。

请求体

application/json
model
string
必填

APIPod 公开模型 ID。

Allowed value: "kling-4.0-i2v"
prompt
string
必填

必填,最多 8000 字。可用 @first_frame、@keyframe_1..@keyframe_N、@last_frame 引用已上传的帧;只能引用实际提供的帧,否则请求会被拒绝。

Required string length: 1 - 8000
image_urls
string[]
必填

必填。image_urls[0] 为首帧,可选的 image_urls[1] 为尾帧;中间帧请放在 keyframe_urls。输出画幅跟随首帧。也接受 first_frame_image / last_frame_image 别名。

Required array length: 1 - 2 elements
keyframe_urls
string[]

可选的中间帧,按时间顺序排列(最多 8 张),以 @keyframe_1..@keyframe_N 引用。需要先提供首帧;帧总数受 duration 限制。

Maximum array length: 8
duration
integer
默认值:5

输出时长(秒),3-30,默认 5。同时限制帧总数(首帧 + 中间帧 + 尾帧):3 秒 4 帧、4 秒 5 帧、5 秒 6 帧、6 秒 7 帧、7 秒 8 帧、8 秒 9 帧,9 秒及以上 10 帧。

必填范围: 3 <= x <= 30
resolution
enum<string>
默认值:720p

输出分辨率,默认 720p。Kling 4.0 不提供 4K。

可用选项:
720p,
1080p
callback_url
string
默认值:""

接收任务终态通知的 HTTPS 地址。

响应

200 - application/json

任务已受理

创建任务的标准响应

code
integer
必填
data
Task Submit Data · object
必填

创建任务的数据内容

message
string
必填