提交影片任務

非同步影片生成的統一提交端點：Seedance、MiniMax 海螺、可靈、Grok Imagine 共用，按 model 與金鑰分組分派。

POST/v1/video/generate

Seedance、MiniMax、可靈、Grok 影片共用這一個提交端點，HopBase 按請求的 model 與金鑰所屬分組交給對應系列處理——請求體與狀態值各系列不同，在下方選擇系列查看對應參數。提交後用查詢影片任務輪詢。

提交時按「可用餘額 − 進行中任務的預估費用 − 本次預估費用」判斷，不足回傳 402 insufficient_balance。失敗的任務一律不計費；任務不支援取消；Seedance 任務超過 24 小時未結束自動判失敗（The task did not finish within 24 hours and was terminated automatically）。提交成功後不要重複提交，每次重提都是另一個計費任務。

萬相 3.0 / 快樂馬使用原生影片路徑 POST /api/v1/services/aigc/video-generation/video-synthesis（前面不帶 /v1），見萬相與快樂馬；Gemini Omni 同步回傳，見 Gemini Omni 影片。

提交影片任務

curl https://api.hop-base.com/v1/video/generate \
  -H "Authorization: Bearer $HOPBASE_API_KEY" \
  -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
  }'

200application/json

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

請求標頭

Authorization:必填string

Bearer sk-…：主控台「API 金鑰」中建立的金鑰，所屬分組須包含請求的模型

請求主體參數JSON

系列

模型文件

型別嚴格：整數和布林值寫成字串會被拒。frames、seed、camera_fixed、draft、draft_task、service_tier 回傳 400；size、seconds、n、aspect_ratio 不是 Seedance 參數，不報錯但會被忽略。請求體上限 64 MB。

model:必填string

Seedance 模型 ID；國內分組另接受海外 dreamina-* ID 作為相容別名（4K 仍拒絕）

可選值doubao-seedance-2-0-260128-adoubao-seedance-2-0-fast-260128-adoubao-seedance-2-0-mini-260615-adoubao-seedance-2-5-260628-adreamina-seedance-2-0-260128dreamina-seedance-2-0-epdreamina-seedance-2-0-fast-260128dreamina-seedance-2-0-fast-epdreamina-seedance-2-0-fast-hcdreamina-seedance-2-0-hcdreamina-seedance-2-0-mini-260615dreamina-seedance-2-0-mini-epdreamina-seedance-2-0-mini-hcdreamina-seedance-2-5-260628

content:必填array of object

提示詞與參考素材。提示詞寫在 text 元素裡，只傳頂層 prompt 會被拒（missing content）

數量≥ 1 項上限參考圖 2.0 ≤ 9、2.5 ≤ 30；影片 2.0 ≤ 3、2.5 ≤ 10；音訊 2.0 ≤ 3（須搭配圖片或影片）、2.5 ≤ 10；首尾幀最多 2 張

duration:選填integer

2.0：4–15 或 -1（自動）；2.5：4–30 或 -1。預設 2.0 為 5、2.5 為 -1；-1 時按最長時長預留餘額

範圍-1–30

resolution:選填string

各型號可用檔不同（海外 2.0 標準版含 4K；Fast / Mini 僅 480p / 720p；2.5 不支援 4K）

可選值480p720p1080p4k

預設"720p"

ratio:選填string

畫幅

可選值16:94:31:13:49:1621:9adaptive

預設"adaptive"

generate_audio:選填boolean

2.5 預設 true；2.0 不代填，請明確傳

watermark:選填boolean

2.5 預設 false；2.0 不代填，請明確傳

return_last_frame:選填boolean

取得末幀時回傳 task.last_frame_url；2.5 預設 true，2.0 不保證

priority:選填integer

任務優先順序

範圍0–9

execution_expires_after:選填integer

秒；不改變 24 小時保底

範圍3600–259200

callback_url:選填string

HTTP(S) URL；不能替代輪詢

safety_identifier:選填string

1–64 個 ASCII 字元

長度1–64 字元

回傳

200Seedance / Grok 提交成功

202MiniMax / 可靈提交成功

系列

task:選填object

錯誤

400參數校驗失敗，同步回傳、不建任務、不計費；多數只有 error.message，沒有 code

402insufficient_balance：餘額不足以覆蓋在途預留 + 本條預估；成員額度不足時 message 以 Insufficient quota: 開頭

404模型不在這把金鑰的分組裡：The current group does not support the requested model: <模型 ID>

413請求體超過上限

503參考素材 2 分鐘內未下載解析完（upstream_timeout，media validation timed out, please retry later），稍後原樣重試

請求標頭

請求主體參數JSON

回傳

錯誤

相關頁面