Seedance 公式版 動画 API 仕様

このページは、Seedance 公式版の動画モデルの呼び出し仕様です。これらのモデルは、他の動画モデルと同じく POST /v1/videos で作成し、GET /v1/videos/{id} でポーリングします。認証、素材のアップロード、ポーリングのステータス、結果のダウンロード、エラー処理は動画 API 完全呼び出し仕様を参照してください。このページでは、このモデル群に固有のフィールドとルールだけを説明します。

2026-10-10 更新。このモデル群はポーリングのみに対応しています。作成時に callback_url を設定するとリクエストは拒否されます。SD クラウド版（SD2.0、SD2.5）と Seedance 公式中継 は、このモデル群とは機能が異なります。それぞれ SD クラウド版と Seedance 公式中継 を参照してください。

モデル一覧

モデル名は、官方版 の接尾辞も含めて、GET /v1/models が返す id と完全に一致させる必要があります。各シリーズのモデル名は 1 つだけで、resolution で出力解像度を選択し、その解像度で課金されます。今後解像度が追加されてもモデル名は変わりません。

共通ルール

• 解像度：resolution に上表の解像度を指定します。大文字・小文字は区別されません（720p と 720P は同じ扱いです）。省略すると最も低い解像度になります。そのシリーズが対応していない解像度を指定すると 400 が返され、自動的に解像度を下げることはありません。
• 長さ：duration（または文字列形式の seconds）に整数の秒数を指定します。省略すると上表のデフォルトの長さになります。
• アスペクト比：ratio（または aspect_ratio）に 16:9、9:16、1:1、4:3、3:4、21:9 を指定でき、デフォルトは 16:9 です。auto には対応していません。
• プロンプト：prompt は必須です。
• 音声：音声生成のスイッチはありません。generate_audio は送らないでください。
• 任意フィールド：negative_prompt（ネガティブプロンプト）、seed（整数）。

参照素材

• 参照画像はトップレベルの images 配列に指定します。
• 参照動画は metadata.referenceVideos、参照音声は metadata.referenceAudios に指定します。
• 同じ種類の素材は 1 つのフィールドだけで送ります。複数のエイリアスを同時に送った場合、採用されるのはそのうち 1 組だけで、マージはされません。
• 素材 URL の要件とローカルファイルのアップロード方法は、素材 URL の要件とローカル素材のアップロードを参照してください。

{
  "model": "seedance-2.5官方版",
  "resolution": "720p",
  "prompt": "参照画像の製品の外観、参照動画のカメラのテンポ、参照音声のサウンドの雰囲気を使ってテック系の広告を作る",
  "duration": 10,
  "ratio": "16:9",
  "images": [
    "https://cdn.example.com/product-front.jpg",
    "https://cdn.example.com/product-detail.jpg"
  ],
  "metadata": {
    "referenceVideos": ["https://cdn.example.com/motion-reference.mp4"],
    "referenceAudios": ["https://cdn.example.com/sound-reference.mp3"]
  }
}

開始・終了フレーム

開始フレームと終了フレームは metadata.firstFrame と metadata.lastFrame に指定します。lastFrame は必ず firstFrame と一緒に指定します。開始・終了フレームは、参照画像、参照動画、参照音声と併用できません。

{
  "model": "seedance-2.0官方版",
  "prompt": "早朝の誰もいない広場から、夜に明かりが灯った同じ構図へなめらかに移り変わる",
  "duration": 8,
  "ratio": "16:9",
  "metadata": {
    "firstFrame": "https://cdn.example.com/start.jpg",
    "lastFrame": "https://cdn.example.com/end.jpg"
  }
}

ファイルのアップロード

multipart/form-data でローカルの画像ファイル 1 つを直接アップロードすることもできます。フィールド名は input_reference で、この場合は images や image を同時に送れません。参照動画と参照音声はファイルとして送れないため、先にローカル素材のアップロードの手順で URL を取得してください。

旧モデル名

以前の解像度付きのモデル名 Seedance-2.5-720p官方版、Seedance-2.0-720p官方版、Seedance-2.0-fast-720p官方版、seedance-2.0-mini-480p、seedance-2.0-mini-720p も引き続き呼び出せますが、出力と課金は名前に含まれる解像度に固定され、resolution は無視されます。これらはモデルスクエアには表示されなくなりました。新規に接続する場合は、上表のシリーズ名と resolution を使用してください。