Seedance 超分版:1080p / 4K 影片 API
Seedance 2.0 / 2.5 超分版:低解析度生成後經 AI 超分到 1080p / 4K,按秒計費。型號、參數、計費與限制。
超分版先用 Seedance 以較低解析度生成,再經 AI 超分交付 1080p 或 4K。介面與 Seedance 相同:提交任務、按 ID 輪詢、下載成片。
| 項目 | 值 |
|---|---|
| Base URL | https://api.hop-base.com/v1 |
| 提交任務 | POST /v1/video/generate |
| 查詢任務 | GET /v1/video/tasks/{task_id} |
| 密鑰分組 | 「Seedance 超分版」 |
可用型號
| 型號 ID | 參數規則 | 解析度 | 時長(秒) | 官方價 |
|---|---|---|---|---|
dreamina-seedance-2-0-260128-sr | Seedance 2.0 | 1080p / 4k | 4-15 的整數或 -1 | $0.1588起/ 秒 |
dreamina-seedance-2-5-260628-sr | Seedance 2.5 | 1080p / 4k | 4-30 的整數或 -1 | $0.2324起/ 秒 |
- 這兩個型號只在 Seedance 超分版 分組提供,該分組也只提供這兩個型號。把它加進密鑰後,用
GET /v1/models確認。 - 本分組呼叫原生 Seedance ID(不帶
-sr),或在其他 Seedance 分組呼叫-srID,都會回傳 404model_not_found。 - 想以低於原生 1080p / 4K 的價格交付 1080p / 4K 時選超分版。像素級細節由超分補出;要最清晰的原生畫質,用原生 Seedance。
請求參數
請求體與 Seedance 相同:model、content(text、image_url、video_url、audio_url 元素,帶 role)、resolution、ratio、duration、generate_audio、watermark、return_last_frame。時長、參考素材數量與素材限制分別沿用 Seedance 2.0 / 2.5 的規則,見 Seedance。不同之處:
| 項目 | 超分版 |
|---|---|
resolution | 只支援 1080p 或 4k,預設 1080p;480p、720p、2k 回傳 400 |
| 素材庫 | 不提供。asset:// 引用與 /v1/sd/assets 回傳 400;參考素材直接傳公網 URL(圖片與音訊也支援 data: base64) |
| 真人參考圖 | 不支援,任務失敗並提示 may contain real person;真人請用原生 Seedance 2.0 + 素材庫 |
2.5 首幀任務的 ratio | 帶 first_frame / last_frame 圖時,dreamina-seedance-2-5-260628-sr 畫幅跟隨圖片:不傳 ratio 或傳 adaptive,否則 400 |
| 影片編輯(2.5) | 參考影片被識別為編輯任務時,duration 必須為 -1,輸出時長與畫幅跟隨輸入影片 |
duration: -1 | 由模型決定時長,按成片實際時長計費 |
seed、frames、camera_fixed、draft、service_tier 與 Seedance 一樣回傳 400。
計費
- 按輸出秒數與解析度檔計費,價格見模型卡:dreamina-seedance-2-0-260128-sr、dreamina-seedance-2-5-260628-sr。
- 帶參考影片時按更低的「有影片輸入」單價,輸入影片秒數也按同一單價另計(不足輸出時長的 2/3 按 2/3 計)。
- 參考圖與參考音訊不單獨計費。
- 失敗任務與提交時 400 不計費。
範例
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-sr",
"content": [
{"type": "text", "text": "鏡頭緩緩推近畫面"},
{"type": "image_url", "image_url": {"url": "https://example.com/first.png"}, "role": "first_frame"}
],
"resolution": "4k",
"duration": 5
}'輪詢 GET /v1/video/tasks/{task_id},直到 status 為 completed 或 failed,每條約 2-5 分鐘。
回傳
回傳與 Seedance 相同的 task 包裹。task.id 以 vt 開頭;完成後 task.outputs 為影片連結,task.last_frame_url 為末幀(2.5 預設回傳)。結果連結自完成起 24 小時內有效,請及時下載。
報錯
| 報錯 | 原因 | 處理 |
|---|---|---|
404 model_not_found | 密鑰分組不提供該型號 | 換用包含「Seedance 超分版」的密鑰 |
400 does not support resolution | resolution 不是 1080p / 4k | 改為 1080p 或 4k |
400 has no asset library | 使用了 asset:// 引用 | 改傳公網 URL |
400 follows the first-frame image's aspect ratio | 2.5 首幀任務傳了 ratio | 去掉 ratio 或傳 adaptive |
任務失敗:may contain real person | 參考圖含真人 | 改用原生 Seedance 2.0 + 素材庫 |
任務失敗:duration must be -1 | 2.5 參考影片被識別為編輯任務 | duration 改為 -1 |