本文へスキップ

Seedance 超解像版:1080p / 4K 動画 API

Seedance 2.0 / 2.5 超解像版:低い解像度で生成し AI で 1080p / 4K にアップスケール、秒単位課金。モデル、パラメーター、課金、制限。

超解像版は Seedance で低い解像度の動画を生成し、AI で 1080p または 4K にアップスケールして納品します。API は 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〜/ 秒
  • この 2 つのモデルは Seedance 超解像版 プランだけで提供され、このプランはこの 2 つだけを提供します。キーに追加したあと 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 を参照)。違いは次のとおりです。

項目超解像版
resolution1080p または 4k のみ、既定は 1080p。480p、720p、2k は 400
素材ライブラリありません。asset:// 参照と /v1/sd/assets は 400。参照素材は公開 URL で直接渡します(画像と音声は data: base64 も可)
実在人物の参照画像非対応です。タスクは may contain real person で失敗します。実在人物には通常版 Seedance 2.0 と素材ライブラリを使ってください
2.5 の先頭フレームタスクの ratiofirst_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
  }'

status が completed または failed になるまで GET /v1/video/tasks/{task_id} をポーリングします。1 本あたり約 2-5 分です。

レスポンス

レスポンスは Seedance と同じ task 形式です。task.id は vt で始まり、完了すると task.outputs に動画 URL、task.last_frame_url に最終フレーム(2.5 は既定で返却)が入ります。結果 URL の有効期間は完了から 24 時間なので、早めにダウンロードしてください。

エラー

エラー原因対処
404 model_not_foundキーのプランがこのモデルを提供していない「Seedance 超解像版」を含むキーを使う
400 does not support resolutionresolution が 1080p / 4k 以外1080p または 4k にする
400 has no asset libraryasset:// 参照を使った公開 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 にする