視頻生成
使用 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 為準。