视频生成
使用 Gemini Omni 同步生成视频，或通过 Seedance 2.0 异步任务 API 生成视频。
HopBase 提供两种视频能力：Gemini Omni 通过 POST /v1/interactions 同步输出 3-10 秒、720p、24 FPS 的 base64 MP4；Seedance 2.0 使用下面的异步任务 API，支持更多分辨率、时长和参考图配置。请使用对应分组密钥，并先检查 GET /v1/models。
Seedance 2.0 异步任务 API
1. 提交生成任务
curl https://api.hop-base.com/v1/video/generate \
-H "Authorization: Bearer sk-你的密钥" \
-H "Content-Type: application/json" \
-d '{
"model": "dreamina-seedance-2-0-hc",
"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": "asset://素材ID" },
"role": "reference_image"
}| 参数 | 说明 |
|---|---|
model | 视频模型，见下方模型表（必填） |
content | 输入数组：text 提示词与 image_url 参考图；参考图用 role 声明角色 |
duration | 视频时长（秒），如 5 / 10 / 15 |
resolution | 480p / 720p / 1080p / 4k，1080p 和 4k 仅标准档支持 |
ratio | 16:9 / 9:16 / 1:1 / 4:3 等 |
generate_audio | 是否同时生成音频 |
watermark | 是否添加水印 |
其余模型参数原样透传，无需等待网关升级。
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 更久。
视频地址有效期
outputs 返回 api.hop-base.com 域名下的视频直链，支持浏览器直接播放与 Range 拖动。视频本体不在 HopBase 长期存储，直链自生成起 24 小时内有效，请及时下载留存。
3. 上传参考图素材（可选）
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，生成时以 asset://素材ID 引用；URL 必须是公网可访问地址。素材查询使用 GET /v1/sd/assets/{素材ID}。
模型与当前标准价
价格单位为 USD / 100 万 video tokens。
| 档位 | 模型 ID | 分辨率 | 文生视频 | 图生视频（带参考图） |
|---|---|---|---|---|
| 标准 | dreamina-seedance-2-0-hcdreamina-seedance-2-0-epdreamina-seedance-2-0-260128 | 480p / 720p | $6.30 | $3.87 |
| 标准 | 同上 | 1080p | $6.93 | $4.23 |
| 标准 | 同上 | 4k | $3.60 | $2.16 |
| 快速 | dreamina-seedance-2-0-fast-hcdreamina-seedance-2-0-fast-epdreamina-seedance-2-0-fast-260128 | 480p / 720p | $5.04 | $2.97 |
| 迷你 | dreamina-seedance-2-0-mini-hcdreamina-seedance-2-0-mini-epdreamina-seedance-2-0-mini-260615 | 480p / 720p | $3.15 | $1.89 |
当前标准价为官方基准价的 9 折（分组倍率 6.12 / 参考汇率 6.8）。计费 tokens 随分辨率与时长增长，约等于像素 x 帧率 x 时长 / 1024；4k 单价低但 tokens 远多。迷你档 480p / 5 秒约 48,400 tokens，约 $0.15。最终以登录后模型广场和任务完成时的实际 tokens 为准。