Skip to main content
POST
cURL

使用说明

  • 源视频:video_urls 中必须且只能传 1 个 MP4/MOV 视频(3-15.5 秒),可附加最多 4 张参考图。输出时长与宽高比跟随源视频,因此不接受 duration 和 aspect_ratio。将 keep_original_sound 设为 true 可保留原声。
  • 引用输入:图片按顺序编号为 image_1..image_N,视频为 video_1。在 prompt 中用 @image_1 / @video_1 指向具体输入。
  • 不支持:negative_prompt(请把排除项写进 prompt)、audio_urls、video_url(请使用 video_urls)。

计费

按源视频时长(向上取整到整秒)逐秒计费,720p / 1080p 按增强档计费(4K 按 4K 档)。每秒费率分档: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-edit"
prompt
string
必填

必填的编辑指令,最多 2500 字。输入会自动编号:图片按顺序为 image_1..image_N,视频为 video_1;可在 prompt 中以 @image_1、@video_1 引用。

Maximum string length: 2500
video_urls
string[]
必填

仅 1 个待编辑的源视频 URL(MP4 或 MOV,3-15.5 秒)。输出时长与宽高比跟随该视频。

Required array length: 1 element
image_urls
string[]

可选的参考图 URL(最多 4 张)。

Maximum array length: 4
resolution
enum<string>
默认值:720p

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

可用选项:
720p,
1080p,
4k
keep_original_sound
boolean
默认值:false

是否保留源视频的音轨。默认 false(输出不保留原声)。

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
必填

响应消息。