跳至正文
上新Nano Banana 2.1 已上線：Google 新一代生圖模型，單張低至 $0.0336，原生 4K，約上一代半價查看模型
HopBase
← 返回博客

統一影片生成 API:Seedance、可靈、海螺一套介面 | HopBase

HopBase 2026年11月05日 12 分鐘閱讀

有。HopBase 用一套非同步任務 API 串接多個影片模型家族:Seedance(2.0 / 2.5)、可靈(含 4.0)、MiniMax 海螺(H3 / H3-Max)與 Grok Imagine 影片,都是 POST /v1/video/generate 提交、GET /v1/video/tasks/{task_id} 輪詢;阿里萬相 3.0 與 HappyHorse 1.1 保留官方原路徑(POST /api/v1/services/aigc/video-generation/video-synthesis,輪詢 GET /api/v1/tasks/{task_id})。一把 Key 最多含 10 個分組,可同時涵蓋這些家族,以美元計費。統一的是「提交 → 輪詢 → 下載」流程與帳戶、餘額;請求內容仍依各家族自己的欄位撰寫。失敗的影片任務不計費,結果連結自任務完成起 24 小時有效。

統一了什麼,沒統一什麼

先看各家族的最小請求與結果位置。這張表決定你的輪詢程式要處理哪些差異:

家族提交 / 輪詢最小請求提交回傳完成後讀取
Seedance/v1/video/generate / /v1/video/tasks/{task_id}model + 非空 content[]200,task.id(vt…)task.outputs
Grok Imagine 影片同上model + prompt 或 content + resolution200,task.id(vt…)task.outputs
MiniMax 海螺同上model + content + resolution + duration(純文字另需 ratio)202,id(mmt…)outputs
可靈同上model + prompt 或 images[] / videos[]202,id(kt…)outputs
萬相 3.0 / HappyHorse 1.1/api/v1/services/aigc/video-generation/video-synthesis / /api/v1/tasks/{task_id}model + input(parameters 可選)200,output.task_idoutput.video_url

提交成功碼不同(200 或 202),任何 2xx 都視為提交成功。Seedance 與 Grok 的回應包在 task 裡,可靈與海螺是頂層欄位。進行中的狀態值也不同(Seedance 為 pending / processing,可靈與海螺為 queued / processing),終態都是 completed 或 failed;萬相 / HappyHorse 讀 output.task_status,終態為 SUCCEEDED 或 FAILED。

各影片模型家族比較

下表參數全部取自 HopBase 文件,各變體以 GET /v1/models 回傳的完整 ID 為準:

家族與模型 ID解析度長度(秒)參考輸入聲音
Seedance 2.0:dreamina-seedance-2-0-260128(標準)、-fast-260128、-mini-260615;中國版 doubao-seedance-2-0-*-a標準版 480p / 720p / 1080p,海外標準版另有 4K;Fast、Mini 為 480p / 720p4–15 或 -1content:圖片 ≤9、影片 ≤3、音訊 ≤3generate_audio(2.0 需明確傳入)
Seedance 2.5:dreamina-seedance-2-5-260628;中國版 doubao-seedance-2-5-260628-a480p / 720p / 1080p(海外 1080p 視分組而定,無 4K)4–30 或 -1content:圖片 ≤30、影片 ≤10、音訊 ≤10generate_audio 預設 true
可靈 4.0:kling-v4720p / 1080p3–30僅文生影片與首幀圖生影片成片一律有聲,audio 不影響價格
可靈 3:kling-v3、kling-v3-omni、kling-v3-turbo720p / 1080p / 2k / 4k3–15images[] / videos[]、主體;v3 與 v3-omni 支援 shots 分鏡v3、v3-omni 可選有聲或無聲
海螺 H3:MiniMax-H3768P / 2K4–15content:圖片 ≤9、影片 ≤3、音訊 ≤3,合計 ≤12原生生成
海螺 H3-Max:MiniMax-H3-Max480P / 768P5–15僅文字或首尾幀,不收 reference_*原生生成
Grok Imagine:grok-imagine-video-1.5480p / 720p / 1080p(帶參考圖時僅 480p / 720p)1–15頂層 reference_images ≤14,僅公開 URL無聲音參數(generate_audio 會被拒絕)
萬相 3.0:wan3.0-video480P / 720P / 1080P2–30input.media[]:圖片 ≤10、影片 ≤5、音訊 ≤5,文件或網頁 ≤1audio 開關,同價
HappyHorse 1.1:happyhorse-1.1-t2v / -i2v / -r2v480P / 720P / 1080P3–15t2v 無;i2v 恰好 1 張首幀;r2v 1–9 張參考圖—

可靈另有動作控制(kling-v3-motion-control)、數位人(kling-avatar)與對嘴(kling-lip-sync),走同一個任務 API。

完整範例:Seedance 2.5 提交與輪詢

1. 提交任務。所有欄位都是頂層欄位,不要包進 parameters:

curl https://api.hop-base.com/v1/video/generate \
  -H "Authorization: Bearer sk-your-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "dreamina-seedance-2-5-260628",
    "content": [
      { "type": "text", "text": "An orange cat runs across sunlit grass as the camera follows" }
    ],
    "duration": 5,
    "resolution": "720p",
    "ratio": "16:9",
    "generate_audio": false,
    "watermark": false
  }'

2. 提交成功回傳 200,記下 task.id:

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

3. 每 5 秒輪詢一次,直到 task.status 為 completed 或 failed。輪詢不計費、不占並行數:

curl https://api.hop-base.com/v1/video/tasks/vt-your-task-id \
  -H "Authorization: Bearer sk-your-key"

4. 完成後從 task.outputs(字串陣列)取影片連結,頂層 usage.cost_usd 是此任務實際扣除的美元金額。連結自完成起 24 小時有效,過期回傳 410,請及時下載。480p 與 720p 通常 2–5 分鐘出片。

換到其他家族時,輪詢程式不用改,只換請求內容。例如可靈用 prompt + aspect_ratio,海螺用 MiniMax v2 的 content + resolution + duration。注意:Seedance 會靜默忽略 size、seconds、n、aspect_ratio,以預設長度與 720p 生成,所以務必傳 duration、resolution、ratio。

與分別使用各廠商主控台比較

面向分別串接各廠商統一任務 API(HopBase)
帳號每個平台各自註冊、驗證、儲值一個帳戶、一把 Key(最多 10 個分組)
請求格式各家不同仍依各家欄位,但提交與輪詢路徑統一(萬相 / HappyHorse 除外)
計費單位各家不同,需自行換算同樣不同:Seedance 以百萬影片 token 計,可靈、海螺、萬相、Grok 以秒計;都從同一美元餘額扣除
每任務成本看各家帳單任務結束後查詢回傳 usage.cost_usd
結果連結各家有效期不同統一 24 小時

價格與計費規則

  • 價格 = 各廠商官方牌價 × 分組倍率,見 價格頁。官方牌價舉例:MiniMax-H3-Max 480p $0.05 / 秒,kling-v4 720p $0.1471 / 秒,wan3.0-video 480p $0.04412 / 秒。
  • 失敗的影片任務不計費;提交時的 400 也不計費。
  • 提交時依「可用餘額 − 進行中任務預估 − 本任務預估」檢查,不足回傳 402 insufficient_balance。
  • 任務無法取消;提交成功後不要重複提交,每次重送都是一個新的計費任務。

延伸閱讀:在海外呼叫中國影片模型說明多家族的串接步驟;Seedance API 價格全解說明每秒成本換算;可靈 4.0 API 串接指南說明 kling-v4 的參數;完整欄位見 影片生成文件。想直接試用,註冊並建立 Key,勾選需要的影片分組。

常見問題

有沒有一個 API 同時支援 Seedance、可靈和海螺?

有。在 HopBase 上,這三家與 Grok Imagine 影片共用 POST /v1/video/generate 與 GET /v1/video/tasks/{task_id},一把 Key 加上對應分組即可。請求內容依各家族自己的欄位撰寫,輪詢迴圈可以共用。

影片生成失敗會扣費嗎?

不會。失敗的影片任務不計費,查詢時 usage.cost_usd 顯示 0;提交階段被拒(例如參數錯誤回傳 400)也不計費。

海外開發者呼叫中國影片模型要用中國版還是海外版 ID?

只有 Seedance 分兩套 ID:海外版 dreamina-seedance-*,中國版 doubao-seedance-*-a,各需對應分組的 Key;4K 只有海外 2.0 標準版。可靈、海螺、萬相、Grok 只有一套 ID。用 GET /v1/models 查看你的 Key 實際可用的 ID。

教學