跳到正文

Seedance 超分版:1080p / 4K 影片 API

Seedance 2.0 / 2.5 超分版:低解析度生成後經 AI 超分到 1080p / 4K,按秒計費。型號、參數、計費與限制。

超分版先用 Seedance 以較低解析度生成,再經 AI 超分交付 1080p 或 4K。介面與 Seedance 相同:提交任務、按 ID 輪詢、下載成片。

項目值
Base URLhttps://api.hop-base.com/v1
提交任務POST /v1/video/generate
查詢任務GET /v1/video/tasks/{task_id}
密鑰分組「Seedance 超分版」

可用型號

型號 ID參數規則解析度時長(秒)官方價
dreamina-seedance-2-0-260128-srSeedance 2.01080p / 4k4-15 的整數或 -1$0.1588起/ 秒
dreamina-seedance-2-5-260628-srSeedance 2.51080p / 4k4-30 的整數或 -1$0.2324起/ 秒
  • 這兩個型號只在 Seedance 超分版 分組提供,該分組也只提供這兩個型號。把它加進密鑰後,用 GET /v1/models 確認。
  • 本分組呼叫原生 Seedance ID(不帶 -sr),或在其他 Seedance 分組呼叫 -sr ID,都會回傳 404 model_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 resolutionresolution 不是 1080p / 4k改為 1080p 或 4k
400 has no asset library使用了 asset:// 引用改傳公網 URL
400 follows the first-frame image's aspect ratio2.5 首幀任務傳了 ratio去掉 ratio 或傳 adaptive
任務失敗:may contain real person參考圖含真人改用原生 Seedance 2.0 + 素材庫
任務失敗:duration must be -12.5 參考影片被識別為編輯任務duration 改為 -1