Skip to main content
POST
创建视频生成任务
本端点使用火山方舟的视频任务方言。按 ark.cn-beijing.volces.com 文档开发的代码可以原样运行:把 base URL 指向 https://api.apipod.ai/api/v3,换成 APIPod API Key,请求体保持不变。鉴权同样使用 Authorization: Bearer <key> 请求头。

一个模型名,全部场景

与火山控制台不同,你不需要为每种能力挑选不同的 Endpoint ID。seedance-2.5seedance-2.0-fast 等 all-in-one 模型 ID 覆盖全部场景:任务类型由 content 内容自动推断——仅文本即文生视频;1-2 张帧图即图生视频(首帧或首尾帧);参考图片、参考视频或参考音频即全模态参考生视频。三种场景互斥;首尾帧图片与参考媒体混用会被 400 拒绝。无 role 的图片按首尾帧处理,因此超过 2 张无 role 图片会按参考图处理。

模型命名

model 字段不区分大小写,接受以下三类写法:

参数说明

resolution、ratio、duration、seed、generate_audio、camera_fixed、watermark、return_last_frame 以及 tools: [{"type": "web_search"}] 会透传给模型。可选值随模型而定;不支持的组合与原生 /v1/videos/generations 端点的校验行为一致。 部分方舟参数被接受但忽略(平台不映射):service_tierpriorityexecution_expires_aftersafety_identifieroutput_formatdraftomni_reference_task_typeframes 参数会返回 400 错误,请改用 duration

回调

设置 callback_url 后,任务到达终态时会收到一次 POST 推送。回调体与查询接口的响应完全同构,同一套解析代码即可处理两者。其他端点使用的原生回调格式与重试策略见 Webhooks 创建任务后,使用返回的 id 轮询 查询视频任务(方舟兼容)

授权

Authorization
string
header
必填

在 Authorization 头中以 Bearer 方式携带 APIPod API Key。

请求体

application/json
model
string
必填

模型名。接受 APIPod 公开名(seedance-2.5、seedance-2.0、 seedance-2.0-fast、seedance-2.0-mini 及特价版本)、火山 原生名(含尾部版本号,如 doubao-seedance-2-5-260128), 以及已带场景后缀的名(seedance-2.5-i2v)。

示例:

"seedance-2.5"

content
object[]
必填

输入内容列表。文本即提示词;无 role 或 role 为 first_frame/last_frame 的图片(最多 2 张)走图生视频; role 为 reference_image 的图片、参考视频与参考音频走全 模态参考生视频。三种场景互斥,不可混用。

示例:
resolution
enum<string>

视频分辨率。可选值随模型而定。

可用选项:
480p,
720p,
1080p,
4k
ratio
enum<string>

生成视频的宽高比。

可用选项:
16:9,
4:3,
1:1,
3:4,
9:16,
21:9,
adaptive
duration
integer

视频时长(秒)。支持智能选择的模型可传 -1。

seed
integer

随机种子。部分模型支持。

generate_audio
boolean

是否生成与画面同步的音频。部分模型支持。

camera_fixed
boolean

是否固定摄像头。部分模型支持。

watermark
boolean

是否添加 AI 生成水印。部分模型支持。

return_last_frame
boolean

是否同时返回尾帧图片。

callback_url
string

回调地址。任务到达终态时,APIPod 会 POST 与查询接口响应 同构的任务对象。

tools
object[]

工具配置。当前仅识别 web_search,且仅对支持的模型生效。

响应

任务创建成功

id
string
必填

异步任务 ID。使用该值调用查询接口轮询任务。

model
string
必填

本任务使用的公开模型系列名。