Skip to main content
POST
cURL

使用说明

  • 多镜头:在 multi_prompt 中描述最多 6 个镜头({prompt, duration},每个最多 512 字),各镜头时长之和必须等于 duration(3-15 秒)。不接受 multi_shot 字段。
  • 音频:始终生成原生音频,传 generate_audio: false 会被拒绝。
  • 不支持:negative_prompt(请把排除项写进 prompt)、audio_urls、video_url(请使用 video_urls)。

计费

按输出视频时长逐秒计费。每秒费率按分辨率(720p 或 1080p)区分,原生音频已包含在内。具体价格以 模型页 展示为准。

任务流程

创建请求返回 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-turbo-t2v"
prompt
string

文本提示词,最多 2500 字。未提供 multi_prompt 时必填。

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

输出时长(秒),3-15,默认 5。使用 multi_prompt 时各镜头时长之和必须等于该值;省略时取各镜头时长之和。

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

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

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

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

可用选项:
16:9,
9:16,
1:1
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
必填

响应消息。