OneGate
开始使用

视频生成

基于 Seedance 模型的文生视频接口。任务异步执行：提交后返回任务 ID，轮询状态直到 succeeded 拿到视频 URL。按上游返回的输出计费单位结算，0 加价。

Seedance 视频模型是按客户单独开通的。未开通的账户调用会返回 403。开通后，模型会出现在你的 /v1/models 返回中。

创建生成任务

http
POST https://onegate.club/v1/videos/generations

请求体

字段类型说明
modelstring视频模型 ID（必填），见下方列表
promptstring描述要生成的画面（必填）
resolutionstring480p / 720p / 1080p / 4k，默认 720p
ratiostring16:9 / 9:16 / 1:1 / 4:3 / 3:4 / 21:9，默认 16:9
durationinteger秒数，1–30，默认 5（受模型上限约束）
watermarkboolean是否带水印，默认 false

示例请求

bash
curl https://onegate.club/v1/videos/generations \
  -H "Authorization: Bearer $ONEGATE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "doubao-seedance-2-0-mini-260615",
    "prompt": "一只橘猫在夕阳下的屋顶上伸懒腰，电影感镜头，4K",
    "resolution": "720p",
    "ratio": "16:9",
    "duration": 5,
    "watermark": false
  }'

返回结构

json
{
  "id": "a1b2c3d4-...",
  "object": "video.generation",
  "model": "doubao-seedance-2-0-mini-260615",
  "status": "pending",
  "upstream_id": "7848...",
  "created_at": "2026-08-04T09:00:00.000Z"
}

任务创建成功即返回 <InlineCode>pending</InlineCode>。视频生成是异步的，接下来用返回的 <InlineCode>id</InlineCode> 轮询状态。

查询任务状态

http
GET https://onegate.club/v1/videos/generations/{id}

额度准入只应用于创建任务的 POST，不会阻止已有任务的 GET 轮询，以便任务继续完成并结算。

bash
curl https://onegate.club/v1/videos/generations/a1b2c3d4-... \
  -H "Authorization: Bearer $ONEGATE_API_KEY"

返回结构

json
{
  "id": "a1b2c3d4-...",
  "object": "video.generation",
  "model": "doubao-seedance-2-0-mini-260615",
  "status": "succeeded",
  "prompt": "一只橘猫在夕阳下的屋顶上伸懒腰…",
  "resolution": "720p",
  "ratio": "16:9",
  "duration": 5,
  "watermark": false,
  "video_url": "https://..." ,
  "error": null,
  "created_at": "2026-08-04T09:00:00.000Z"
}

状态说明

  • pending · 已提交，排队中
  • queued · 上游排队中
  • running · 正在生成
  • succeeded · 完成，video_url 可用
  • failed · 失败，error 字段含原因

建议每 5–10 秒轮询一次，直到 <InlineCode>succeeded</InlineCode> 或 <InlineCode>failed</InlineCode>。轮询接口不会重复扣费——每个任务只在首次成功时计费一次。

可用模型与价格

视频模型按上游返回的 completion_tokens 结算，以人民币按官网输出单价计费，0 加价。任务认领与账本扣费原子完成，同一任务只扣费一次。

Seedance 上游仅提供 API Key，OneGate 统一按火山方舟公开官网默认刊例价结算，不应用账号协议价、资源包或免费额度；官网调价后将发布新的价格版本。
模型 ID能力输出价格（CNY / 1M 计费单位）
doubao-seedance-2-0-260128标准 · 15s/1080p¥46
doubao-seedance-2-0-fast-260128快速 · 15s/720p¥37
doubao-seedance-2-0-mini-260615经济 · 15s/720p¥23
← 上一页 · 流式输出下一页 · 错误码 →