视频生成

HopBase 在售六个视频模型系列。其中五个走同一套异步任务 API——提交到 POST /v1/video/generate，再用返回的任务 ID 轮询；万相与快乐马沿用阿里百炼 DashScope 的原生路径，Gemini Omni 则是同步返回视频。

全部视频模型

各系列分属不同套餐分组，能调通其中一个的密钥不代表能调通其他。Gemini Omni 视频是个例外：它与 Gemini 对话、生图共用 Gemini 分组，不需要另买视频套餐。请用实际要使用的密钥调 GET /v1/models，从返回结果里取完整模型 ID 再发付费请求。模型 ID 是精确匹配：没有登记任何别名或裸名，写错不会被就近路由，而是直接拒绝。

本页介绍 Seedance，其余每个系列都有独立页面,见上表链接。

Seedance 2.5 与 2.0 异步任务 API

国内与海外版本

存量客户从海外切换到国内时，只需更换国内分组 key，原有 base_url、API 路径、请求参数、轮询逻辑都不变。请使用新 key 调用 GET /v1/models，并选择返回的完整模型 ID。

Seedance 2.5 海外分组使用模型 ID dreamina-seedance-2-5-260628，国内分组使用 doubao-seedance-2-5-260628-a（国内版额外支持 1080p）。普通文生视频和参考素材生成中，duration 默认 -1，支持 4-30 秒的整数或 -1；resolution 默认 720p，支持 480p / 720p；ratio 支持 16:9、4:3、1:1、3:4、9:16、21:9、adaptive。部分任务模式有额外限制：视频编辑只能使用 duration: -1 与 ratio: adaptive，视频扩展及首帧/首尾帧模式要求 ratio: adaptive。默认生成音频、关闭水印并设置 return_last_frame: true。设置 return_last_frame: true 的完成任务会返回 last_frame_url。

1. 提交生成任务

curl https://api.hop-base.com/v1/video/generate \
  -H "Authorization: Bearer sk-你的密钥" \
  -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
  }'

响应中的 task.id 形如 vt...，用于后续查询。图生视频时在 content 中追加：

{
  "type": "image_url",
  "image_url": { "url": "https://example.com/reference.jpg" },
  "role": "reference_image"
}

其余支持的模型参数原样透传。

2. 轮询任务状态

# 单个任务，推荐每 5 秒查询一次
curl https://api.hop-base.com/v1/video/tasks/vt你的任务ID \
  -H "Authorization: Bearer sk-你的密钥"

# 任务列表，可追加 ?page=1&limit=20
curl https://api.hop-base.com/v1/video/tasks \
  -H "Authorization: Bearer sk-你的密钥"

status 为 pending / processing / completed / failed。完成时从 outputs 取视频地址，usage.completion_tokens 为本次计费 tokens。480p / 720p 通常 2-5 分钟出片，1080p 以及仅海外支持的 4K 更久。

3. 上传 Seedance 2.0 参考素材

curl https://api.hop-base.com/v1/sd/assets \
  -H "Authorization: Bearer sk-你的密钥" \
  -H "Content-Type: application/json" \
  -d '{
    "URL": "https://example.com/your-image.jpg",
    "Name": "avatar_front",
    "AssetType": "Image"
  }'

返回 data.Id 即素材 ID，在 Seedance 2.0 生成时以 asset://素材ID 引用；URL 必须是公网可访问地址。请根据参考项使用 AssetType: Image、Video 或 Audio，再通过 GET /v1/sd/assets/{素材ID} 查询到素材就绪。此上传流程适用于 Seedance 2.0；Seedance 2.5 参考素材必须在 content 中直接使用公网 HTTP(S) URL。上传接口只接受公网 URL，不接受 base64 或 multipart，本地文件需先自行托管。普通参考图可选走素材库，含真实人像的参考图则必须走素材库。

参考素材校验规则

所有参考素材在提交时同步校验,不符合会立即返回 400 与具体错误码(如 invalid_image_aspect_ratio),不产生任务费用。建议接入方在上传前按下表自查,可消除绝大多数无效调用:

素材 URL 必须是公网可访问的 http(s) 地址:不允许内网 / 回环 / 链路本地地址与带认证信息的 URL,重定向最多 3 次;图片与音频也支持 data: base64 直传。角色约束:首尾帧模式最多 2 张图片,仅 1 张时须为 first_frame,2 张时须恰好各为 first_frame / last_frame;多模态参考须显式声明 reference_image,不能与首尾帧模式混用。

价格

官方牌价见价格页。你的实际单价以登录后的模型广场为准,每次请求的实际扣费见用量记录。