Seedance 超解像版:1080p / 4K 動画 API
Seedance 2.0 / 2.5 超解像版:低い解像度で生成し AI で 1080p / 4K にアップスケール、秒単位課金。モデル、パラメーター、課金、制限。
超解像版は Seedance で低い解像度の動画を生成し、AI で 1080p または 4K にアップスケールして納品します。API は 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〜/ 秒 |
- この 2 つのモデルは Seedance 超解像版 プランだけで提供され、このプランはこの 2 つだけを提供します。キーに追加したあと
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
}'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 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 にする |