视频任务、参数与计费

创建与轮询

统一视频入口：POST /v1/video/generations。兼容入口：POST /v1/videos。通常创建返回本站 task_... ID，status:queued；创建成功不等于生成完成。

查询 GET /v1/video/generations/{task_id} 或 GET /v1/videos/{task_id}。常见响应字段：id、object、model、status、progress、created_at、seconds、size、metadata、error。标准状态为 queued、in_progress、completed、failed。成功结果可在 metadata.url 取得；可调用带认证的 GET /v1/videos/{task_id}/content 代理读取。推荐每3～5秒查询一次；不要把上游 ID 代替本站公开任务 ID。

视频参数白名单

统一根参数为 model、prompt、mode、image、images、input_reference、size、resolution、duration、seconds、video、video_url、metadata。实际接受能力按适配协议区分。上游扩展参数必须放入 metadata，并且是本站该协议已声明的字段；不支持任意参数透传，未声明字段返回400。

当前 Seedance 模型广场参数说明：resolution 默认展示720p，范围480p、720p、1080p，含义为“输出分辨率预设”；seconds 默认展示15，范围4～15秒。默认值是调用建议，不会自动填入请求。

视频计费矩阵必须显式提交分辨率，缺少时400；也可用协议支持的 size 对应分辨率。480p/480P/480 等大小写与数字别名归一化。

按秒及Token计费必须提交时长，缺少或无效时400；按次计费不靠时长计算单次价格，但模型生成本身仍受上游时长限制。

duration 是 seconds 的别名，同时提交时必须一致；seconds 接受整数或整数字符串。协议允许的metadata时长字段也必须一致。

自定义模型可配置额外分辨率价格档；不在该模型矩阵中的档位返回400。现存4k等自定义价格保留，不能因为另一个模型的默认范围而推断所有模型仅有三档。

URL 字段检查为 HTTP(S) 格式，不承诺本站已预先下载检查可达性；上游必须能访问，需自行处理签名有效期、防盗链、访问权限和文件格式限制。

参考视频自动识别

不允许传 video_input，即使值为 none/video 也会400。本站根据真实参考视频自动选择“无视频参考 / 有视频参考”价格，不接受调用方指定计费标记。

支持参考视频的豆包协议接受根 video_url 或别名 video，值为HTTP(S) URL字符串或 {"url":"https://..."}；也接受 metadata.video_url / metadata.video。转换为 metadata.content 的 video_url 项后转给上游。其他尚未实现参考视频输入的适配器会明确报错，不会仅为选择高价档而接收再丢弃。

{
  "model":"doubao-seedance-2-5-260628",
  "prompt":"参考视频的镜头节奏，生成海边日落",
  "resolution":"720p",
  "seconds":15,
  "video_url":"https://YOUR_MEDIA_HOST/reference.mp4"
}

豆包 content 方式：

{"model":"doubao-seedance-2-5-260628","prompt":"延续镜头运动","resolution":"720p","seconds":15,"metadata":{"content":[{"type":"video_url","video_url":{"url":"https://YOUR_MEDIA_HOST/reference.mp4"},"role":"reference_video"}],"ratio":"16:9","generate_audio":true}}

content 允许的声明字段：type、text、image_url、video_url、audio_url、role；媒体对象只接受url。type为text/image_url/audio_url/video_url。豆包 metadata 声明字段为 model、content、callback_url、return_last_frame、service_tier、execution_expires_after、generate_audio、draft、tools（元素仅type）、resolution、ratio、duration、frames、seed、camera_fixed、watermark。其他供应商使用各自已声明的metadata结构，不要混用豆包参数。

图片或callback_url不会被当作视频参考；任意深层对象里的伪造video_url不会触发参考计费。视频参考以URL提交，本站不把参考视频下载后长期转存。

计费与结果存储

矩阵按“分辨率 × 有无视频参考”选单价，支持：按次（单价×1）、按秒（单价×计费秒数）、Token（单价×实际结算Token/1,000,000）。分组倍率等配置会影响最终费用。Token任务提交时可按分辨率及时长估算预扣，完成后按任务可用usage结算；不要将预扣额度视为最终账单，实际以本站消费日志为准。

异步任务记录及状态保存在本站，媒体文件通常保存在上游；content端点按需代理读取，不提供永久存储或永久链接。完成后请客户端自行下载归档。

Sora兼容模型可使用 POST /v1/videos/{video_id}/remix，需原任务支持且在当前账户可见；传入新prompt。该能力不等于通用video/video_url参考输入。Kling和即梦另有供应商兼容入口，须使用对应协议及模型，不能将供应商原生字段直接塞入统一入口根节点。

视频任务与计费

视频任务、参数与计费#

创建与轮询#

视频参数白名单#

参考视频自动识别#

计费与结果存储#

视频任务、参数与计费

创建与轮询

视频参数白名单

参考视频自动识别

计费与结果存储