Skip to main content
视频是异步的。提交任务,轮询到终态,再读取 outputs[].url。
  1. POST /v2/videos — 创建任务
  2. GET /v2/videos/{id} — 查询状态
  3. status 为 completed 时下载 outputs[].url
  4. 可选:DELETE /v2/videos/{id} — 取消进行中的任务
公开任务 ID 形如 gen-...。查询和取消会固定回到创建该任务的平台。

支持的 V2 模型

以下四款模型统一使用 POST /v2/videos,查询和取消使用 /v2/videos/{id}。模型名必须按表填写;“Flash”对应这里的 Fast。 默认参数均为 duration: 5、resolution: "480p"、aspect_ratio: "16:9"、audio: false。标准版、Fast 和 2.5 最多接受 9 张图片,不接受视频或音频参考。四款模型均不开放 provider_options。这是 PipeLLM 当前开放范围,不能直接套用上游的全部能力。

创建任务

创建接口返回的任务信封与查询相同。任务完成前 outputs 为空。

Seedance 2.0 Mini

该模型配置不支持 provider_options。未知 JSON 字段会被拒绝。

文生视频

参考图

状态

建议每隔几秒轮询一次。生成通常需要几十秒到几分钟。

计费

GET 和 DELETE 请求不额外计费。所有任务创建时固定价格规则;具体扣费时间取决于模型。Mini 和标准版 2.0 在任务成功接受时按秒计费,任务失败、取消或过期后由后台退费。Fast 和 2.5 在任务完成后,按上游实际 completion_tokens 结算;失败任务不收费。 Mini 按美元/秒计费: 4 秒 480p 文生视频约为 $0.24。当前价格以 控制台 为准。 标准版 2.0 保留现有售价 $0.48 / 输出秒。Fast 为 $4.080882 / 百万视频 Token;2.5 的 480p / 720p 为 $10.294118 / 百万视频 Token,1080p 为 $11.323529 / 百万视频 Token。这两款 Token 价格按 1 美元 = 6.8 人民币换算。视频 Token 不等于时长或文本 Token,最终以实际生成用量结算。

API 参考

创建

POST /v2/videos

查询

GET /v2/videos/{id}

取消

DELETE /v2/videos/{id}