ListenHubDocs
API リファレンスAI 動画

Seedance

Seedance 2.0・2.5 のモデル、素材の制限、Draft 生成と課金。

POST /v1/video-generation/generate を使います。2.5 は追加モデルで、2.0 Pro と Fast も引き続き選べます。model を省略すると 2.0 Fast になります。

認証、ポーリング、一覧、エラーは AI 動画の概要.

モデル別の制限

ModelRPM
doubao-seedance-2-pro5
doubao-seedance-2-fast5
doubao-seedance-2-55
項目2.0 Pro / Fast2.5
プロンプト文字数30005000
出力秒数4–154–30 / -1
参照画像930
参照動画3 本、各 2–15 秒、合計 ≤15 秒10 本、各 2–30 秒、合計 ≤30 秒。編集時は各 ≥4 秒
参照音声3 件。画像または動画も必要10 件、各 2–30 秒、合計 ≤30 秒。音声のみも可
ResolutionPro: 480p / 720p / 1080p; Fast: 480p / 720p480p / 720p / 1080p; Draft: 480p
アスペクト比16:9, 4:3, 1:1, 3:4, 9:16, 21:916:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive

2.5 のデフォルト:resolution: "720p"、ratio: "adaptive"、duration: 5、omniReferenceTaskType: "auto"、draft: false。

2.5 のモードと素材メタデータ

omniReferenceTaskType は auto(デフォルト)、reference、edit、extend です。編集と延長には動画入力と ratio: "adaptive" が必要です。編集には duration: -1 も必要です。先頭フレーム、先頭・末尾フレーム生成も adaptive を使います。adaptive は出力サイズ、-1 は長さをプロバイダーに任せる明示的な値です。複数動画を使う編集ではプロンプトで対象を指定してください。

first_frame は 1 枚、last_frame は任意で 1 枚です。フレームと参照画像・動画・音声は混在できません。参照用の役割は reference_image、reference_video、reference_audio です。

各素材のメタデータは image_url、video_url、audio_url オブジェクトの url と同じ階層に指定します。動画と音声はそれぞれ duration(秒)が必須です。実際の width、height、size(バイト)、動画の fps も分かる場合は指定してください。合計時間だけでは各素材のメタデータを代用できません。

画像:各辺 300–6000 ピクセル、比率 0.4–2.5(境界を含む)、30 MiB 未満。動画:各辺 300–6000、比率 0.4–2.5、面積 407,696–8,295,044 ピクセル、24–60 fps、最大 200 MiB。音声は最大 15 MiB。動画と音声の合計時間は、それぞれ 30 秒以内です。

2.5 の参照生成リクエスト

{
  "model": "doubao-seedance-2-5",
  "content": [
    { "type": "text", "text": "Use Video 1 motion and Audio 1 rhythm" },
    {
      "type": "video_url",
      "role": "reference_video",
      "video_url": {
        "url": "https://example.com/reference.mp4",
        "width": 1280,
        "height": 720,
        "duration": 5,
        "fps": 24,
        "size": 8000000
      }
    },
    {
      "type": "audio_url",
      "role": "reference_audio",
      "audio_url": {
        "url": "https://example.com/reference.wav",
        "duration": 4,
        "size": 800000
      }
    }
  ],
  "omniReferenceTaskType": "reference",
  "resolution": "720p",
  "ratio": "16:9",
  "duration": 10,
  "requestId": "reference-request-unique-id"
}

Draft → 本生成

draft: true と resolution: "480p" で再生可能な草稿を作り、success までポーリングします。作成から 14 日以内に ListenHub の taskId を draftTaskId として指定し、新しい 1080p 本生成タスクを作れます。草稿は同じユーザーとアプリ/API ID の範囲に属する必要があります。元の入力とチャネルはサーバーが復元するため、本生成では内容や他の生成設定を省略します。

{
  "model": "doubao-seedance-2-5",
  "draftTaskId": "507f1f77bcf86cd799439011",
  "requestId": "final-request-unique-id"
}

新しい生成ごとに新しい requestId(8–128 文字)を使い、同じ送信のネットワーク再試行では再利用します。UUID が使えます。タスク詳細には任意の draft、draftTaskId、finalTaskIds があり、閲覧可能な生成結果の draftEpisodeId、finalEpisodeIds が含まれる場合もあります。

見積もりと精算

草稿と本生成は別タスクとして個別に課金されます。草稿代金の差し引きや、草稿出力の参照動画への加算はありません。本生成が失敗した場合、そのタスクの仮引き落としだけが返還され、成功済みの草稿は残ります。

POST /v1/video-generation/estimate-credits に生成と同じモデル、解像度、比率、長さ、omniReferenceTaskType、draft を渡します。referenceImages、referenceVideos、referenceAudios は role と各素材のメタデータを持つ配列で、URL は含めません。本生成の見積もりは model と draftTaskId だけで行います。

動画の見積もりは入力動画の合計秒数と出力秒数、出力サイズ、24 fps を使い、最小トークン規則を適用します。入力動画のサイズは各素材の検証に使い、その画素面積ごとに個別課金するわけではありません。音声のみの場合は動画入力なしの単価を使い、音声秒数は動画秒数に加算しません。自動設定では保守的に見積もり、完了後に実際のトークン使用量で精算します。見積もりは上限保証ではありません。

2.5 は独立した単価表を使います。2.0 Pro と比べて、480p / 720p の単価は動画入力なしで 52.86%、ありで 48.84% 上がります。1080p はそれぞれ 51.95%、48.94% です。すべてのタスクの増額率や一定の利益率を示す値ではありません。

OpenAPI の見積もりは tokens と estimatedCostUsd を返し、内部クレジットは返しません。送信時に仮引き落としし、実際のトークン使用量との差額を返還または追加請求します。タスク ID を保存し、再試行前に状態を確認してください。

失敗と再試行

素材ごとの長さの欠落、フレームと参照役割の混在、モードと比率・長さの不一致はリクエスト検証で失敗します。例えば edit と duration: 5 は無効です。adaptive と -1 を使います。

草稿が存在しない、またはアクセスできない場合は 32001、未成功・期限切れ・条件不一致の場合は 32004 です。例えば作成から 14 日を過ぎた草稿は本生成できないため、新しく作り直します。

プロバイダーの審査拒否や失敗はタスクの失敗状態と既存のエラーフィールドで返ります。5000 文字は製品上限であり、プロバイダーの受理を保証しません。送信のタイムアウト時は新規作成せず、既存タスクを確認するか同じリクエスト ID で再試行してください。

このページの内容