Skip to main content
POST
cURL

使用说明

  • 首尾帧:image_urls 为必填项,需提供 1-2 张图片。multi_shot 为 false 时,2 张图依次为首帧(image_urls[0])与尾帧(image_urls[1]),1 张图作为首帧;multi_shot 为 true 时仅支持首帧。输出画幅跟随首帧。
  • 多镜头:将 multi_shot 设为 true,并在 multi_prompt 中描述最多 5 个镜头({prompt, duration},每个 1-12 秒、最多 500 字)。镜头总时长不得超过 duration;省略 duration 时取各镜头时长之和,此时 prompt 也可省略。
  • 音频:generate_audio 单镜头默认 false,多镜头默认 true。
  • 提示词:单镜头请求必填;多镜头模式下请把每个镜头的描述写进 multi_prompt。
  • 不支持:kling_elements、aspect_ratio(画幅跟随首帧)、negative_prompt(请把排除项写进 prompt)、顶层 audio_urls、video_url。

计费

按输出视频时长逐秒计费。每秒费率分五档:720p / 1080p 各自区分是否开启原生音频,另有 4K 一档(有无音频同价)。具体价格以 模型页 展示为准。

任务流程

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

授权

Authorization
string
header
必填

在 Authorization 请求头中以 Bearer Token 形式传入 APIPod API Key。

请求体

application/json
model
string
必填

APIPod 公开模型 ID。

Allowed value: "kling-3.0-i2v"
image_urls
string[]
必填

首尾帧图片(必填)。multi_shot 为 false 时,2 张图依次为首帧(下标 0)与尾帧(下标 1),1 张图作为首帧;multi_shot 为 true 时仅支持首帧。也接受 first_frame_image / last_frame_image。输出宽高比跟随首帧。

Required array length: 1 - 2 elements
prompt
string

描述画面运动的文本提示词,最多 2500 字。未提供 multi_prompt 时必填。

Maximum string length: 2500
duration
integer
默认值:5

输出时长(秒),3-15,默认 5;多镜头模式下省略时取各镜头时长之和。

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

输出分辨率(最高 4K),默认 720p。每秒费率取决于分辨率;720p / 1080p 还区分是否开启原生音频。

可用选项:
720p,
1080p,
4k
generate_audio
boolean

是否生成原生音频(别名 audio)。单镜头默认 false,多镜头默认 true。

multi_shot
boolean

开启多镜头生成(兼容 multi_shots)。配合 multi_prompt 定义每个镜头。

multi_prompt
Multi Prompt · object[]

多镜头分镜列表,最多 5 个镜头。每个镜头为 {prompt, duration},prompt 最多 500 字,时长 1-12 秒;总时长不得超过 duration。

Maximum array length: 5
callback_url
string
默认值:""

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

响应

200 - application/json

任务已受理

Standard response for task submission

code
integer
必填

HTTP 状态码。

data
Task Submit Data · object
必填

响应数据。

message
string
必填

响应消息。