視頻生成

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,不能與首尾幀模式混用。

價格

官方牌價見價格頁。你的實際單價以登入後的模型廣場為準,每次請求的實際扣費見用量記錄。