Skip to main content
POST
cURL

使用说明

  • 参考输入:在 image_urls 中传 1-7 张参考图,或在 video_urls 中传 1 个运动参考视频并附加最多 4 张图片。带运动参考时 duration 限制为 3-10 秒,且不支持 generate_audio。
  • 引用输入:图片按顺序编号为 image_1..image_N,视频为 video_1。在 prompt 中用 @image_1 / @video_1 指向具体输入。
  • 多镜头:将 multi_shot 设为 true 且不传 multi_prompt 时由模型自动分镜;也可在 multi_prompt 中描述最多 6 个镜头({prompt, duration},每个最多 512 字),各镜头时长之和必须等于 duration。
  • 不支持:negative_prompt(请把排除项写进 prompt)、audio_urls、video_url(请使用 video_urls)。

计费

按输出视频时长逐秒计费,运动参考视频本身的时长不累加。每秒费率分档:720p 基础、720p 增强、1080p 基础、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-omni-r2v"
prompt
string

文本提示词,最多 2500 字;未使用 multi_prompt 时必填。输入会自动编号:图片按顺序为 image_1..image_N,视频为 video_1;可在 prompt 中以 @image_1、@video_1 引用。

Maximum string length: 2500
image_urls
string[]

参考图 URL:1-7 张;提供运动参考视频时最多 4 张。

Maximum array length: 7
video_urls
string[]

可选的运动参考视频(最多 1 个)。提供运动参考时 duration 限制为 3-10 秒,且不支持原生音频。

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

输出时长(秒),3-15(带运动参考视频时 3-10),默认 5。使用 multi_prompt 时各镜头时长之和必须等于该值。

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

输出分辨率,默认 720p。每秒费率取决于分辨率档位。

可用选项:
720p,
1080p,
4k
aspect_ratio
enum<string>
默认值:16:9

输出宽高比,默认 16:9。

可用选项:
16:9,
9:16,
1:1
generate_audio
boolean
默认值:false

是否生成原生音频(别名 audio),默认 false。video_urls 中提供运动参考视频时不支持。开启后按增强档计费。

multi_shot
boolean

开启多镜头生成(兼容 multi_shots)。不传 multi_prompt 时由模型自动分镜。

multi_prompt
Multi Prompt · object[]

多镜头分镜列表,最多 6 个镜头。每个镜头为 {prompt, duration},prompt 最多 512 字;各镜头时长之和必须等于 duration(3-15 秒)。

Maximum array length: 6
watermark
boolean
默认值:false

为 true 时额外生成带水印的副本,任务结果返回水印副本。

callback_url
string
默认值:""

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

响应

200 - application/json

任务已受理

Standard response for task submission

code
integer
必填

HTTP 状态码。

data
Task Submit Data · object
必填

响应数据。

message
string
必填

响应消息。