提交视频任务

异步视频生成的统一提交端点：Seedance、MiniMax 海螺、可灵、Grok Imagine 共用，按 model 与密钥分组分派。

POST/v1/video/generate

Seedance、MiniMax、可灵、Grok 视频共用这一个提交端点，HopBase 按请求的 model 与密钥所属分组交给对应系列处理——请求体与状态值各系列不同，在下方选择系列查看对应参数。提交后用查询视频任务轮询。

提交时按「可用余额 − 进行中任务的预估费用 − 本次预估费用」判断，不足返回 402 insufficient_balance。失败的任务一律不计费；任务不支持取消；Seedance 任务超过 24 小时未结束自动判失败（The task did not finish within 24 hours and was terminated automatically）。提交成功后不要重复提交，每次重提都是另一个计费任务。

万相 3.0 / 快乐马使用原生视频路径 POST /api/v1/services/aigc/video-generation/video-synthesis（前面不带 /v1），见万相与快乐马；Gemini Omni 同步返回，见 Gemini Omni 视频。

提交视频任务

curl https://api.hop-base.com/v1/video/generate \
  -H "Authorization: Bearer $HOPBASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "dreamina-seedance-2-5-260628",
    "content": [
      {
        "type": "text",
        "text": "一只橘猫在阳光下的草地上奔跑，镜头跟随"
      }
    ],
    "duration": 5,
    "resolution": "720p",
    "ratio": "16:9",
    "generate_audio": false,
    "watermark": false
  }'

200application/json

{
  "task": {
    "id": "vtEXAMPLE",
    "model": "dreamina-seedance-2-5-260628",
    "status": "pending",
    "outputs": [],
    "error": null,
    "created_at": "2026-09-23T08:00:00Z",
    "completed_at": null
  }
}

请求头

Authorization:必填string

Bearer sk-…：控制台「API 密钥」里创建的密钥，所属分组须包含请求的模型

请求体参数JSON

系列

模型文档

类型严格：整数和布尔值写成字符串会被拒。frames、seed、camera_fixed、draft、draft_task、service_tier 返回 400；size、seconds、n、aspect_ratio 不是 Seedance 参数，不报错但会被忽略。请求体上限 64 MB。

model:必填string

Seedance 模型 ID；国内分组另接受海外 dreamina-* ID 作为兼容别名（4K 仍拒绝）

可选值doubao-seedance-2-0-260128-adoubao-seedance-2-0-fast-260128-adoubao-seedance-2-0-mini-260615-adoubao-seedance-2-5-260628-adreamina-seedance-2-0-260128dreamina-seedance-2-0-epdreamina-seedance-2-0-fast-260128dreamina-seedance-2-0-fast-epdreamina-seedance-2-0-fast-hcdreamina-seedance-2-0-hcdreamina-seedance-2-0-mini-260615dreamina-seedance-2-0-mini-epdreamina-seedance-2-0-mini-hcdreamina-seedance-2-5-260628

content:必填array of object

提示词与参考素材。提示词写在 text 元素里，只传顶层 prompt 会被拒（missing content）

数量≥ 1 项上限参考图 2.0 ≤ 9、2.5 ≤ 30；视频 2.0 ≤ 3、2.5 ≤ 10；音频 2.0 ≤ 3（须搭配图片或视频）、2.5 ≤ 10；首尾帧最多 2 张

duration:可选integer

2.0：4–15 或 -1（自动）；2.5：4–30 或 -1。默认 2.0 为 5、2.5 为 -1；-1 时按最长时长预留余额

范围-1–30

resolution:可选string

各型号可用档不同（海外 2.0 标准版含 4K；Fast / Mini 仅 480p / 720p；2.5 不支持 4K）

可选值480p720p1080p4k

默认"720p"

ratio:可选string

画幅

可选值16:94:31:13:49:1621:9adaptive

默认"adaptive"

generate_audio:可选boolean

2.5 默认 true；2.0 不代填，请显式传

watermark:可选boolean

2.5 默认 false；2.0 不代填，请显式传

return_last_frame:可选boolean

取得末帧时返回 task.last_frame_url；2.5 默认 true，2.0 不保证

priority:可选integer

任务优先级

范围0–9

execution_expires_after:可选integer

秒；不改变 24 小时兜底

范围3600–259200

callback_url:可选string

HTTP(S) URL；不能替代轮询

safety_identifier:可选string

1–64 个 ASCII 字符

长度1–64 字符

200Seedance / Grok 提交成功

202MiniMax / 可灵提交成功

系列

task:可选object

错误

400参数校验失败，同步返回、不建任务、不计费；多数只有 error.message，没有 code

402insufficient_balance：余额不足以覆盖在途预留 + 本条预估；成员额度不足时 message 以 Insufficient quota: 开头

404模型不在这把密钥的分组里：The current group does not support the requested model: <模型 ID>

413请求体超过上限

503参考素材 2 分钟内未下载解析完（upstream_timeout，media validation timed out, please retry later），稍后原样重试

请求头

请求体参数JSON

返回

错误

相关页面