SD クラウド版動画 API 仕様

SD2.0 と SD2.5 の解像度別課金による呼び出し方法と、長さ、アスペクト比、参照素材、開始・終了フレーム、音声のルール。

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

2026-10-10 更新。このモデル群はポーリングのみに対応しています。作成時に callback_url を設定するとリクエストは拒否されます。SD クラウド版は Seedance 公式版や Seedance 公式中継とは別のモデル群で、パラメーターや機能は共通ではありません。

モデル一覧

モデル	選択可能な解像度	長さ	アスペクト比	画像／動画／音声の上限	開始・終了フレーム	音声生成
`SD2.5`	`480p`（デフォルト）、`720p`、`1080p`	4–30 秒、デフォルト 5 秒	指定必須（後述）	30 / 10 / 10	対応、通常の参照素材とは排他	`generate_audio` で設定可
`SD2.0`	`480p`（デフォルト）、`720p`、`1080p`、`4k`	4–15 秒、デフォルト 5 秒	デフォルト `1:1`	9 / 3 / 3、3 種類の合計は最大 12	対応、通常の参照素材とは排他	設定不可

各シリーズのモデル名は 1 つだけで、resolution で出力解像度を選択し、その解像度で課金されます。例："model": "SD2.5", "resolution": "720p"、"model": "SD2.0", "resolution": "4k"。

共通ルール

解像度：resolution に上表の解像度を指定します。大文字・小文字は区別されません（4k と 4K は同じ扱いです）。省略すると最も低い 480p になります。そのシリーズが対応していない解像度を指定すると 400 が返され、自動的に解像度を下げることはありません。
長さ：duration（または文字列形式の seconds）に整数の秒数を指定します。省略すると 5 秒です。
アスペクト比：ratio（または aspect_ratio）に 16:9、9:16、1:1、4:3、3:4、21:9 を指定できます。
- SD2.5：アスペクト比の明示が必須で、auto には対応していません。省略するか auto を送ると 400 が返されます。
- SD2.0：省略すると 1:1 になります。
プロンプト：
- SD2.5：prompt は必須です。
- SD2.0：参照素材または開始・終了フレームを指定した場合は省略できますが、動きやカメラワークを書くことを推奨します。
音声生成：SD2.5 は generate_audio（ブール値）に対応しています。SD2.0 にはこのスイッチがなく、送ると 400 が返されます。
任意フィールド：negative_prompt（ネガティブプロンプト）、seed（整数）。

参照素材

参照画像はトップレベルの images 配列に指定します。
参照動画は metadata.referenceVideos、参照音声は metadata.referenceAudios に指定します。
SD2.0 は 3 種類の素材の合計が最大 12 個です。
SD2.5 の参照動画は 1 本あたり 2–30 秒で、参照動画の合計は 30 秒以内です。
同じ種類の素材は 1 つのフィールドだけで送ります。複数のエイリアスを同時に送った場合、採用されるのはそのうち 1 組だけで、マージはされません。

{
  "model": "SD2.5",
  "resolution": "1080p",
  "prompt": "参照画像の人物の顔と服装を保ち、参照動画のカメラワークで雨の夜の街を走る",
  "duration": 10,
  "ratio": "9:16",
  "generate_audio": true,
  "images": ["https://cdn.example.com/character.jpg"],
  "metadata": {
    "referenceVideos": ["https://cdn.example.com/camera-motion.mp4"]
  }
}

開始・終了フレーム

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

{
  "model": "SD2.0",
  "resolution": "720p",
  "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 を取得してください。

旧モデル名

以前の解像度接尾辞付きのモデル名（SD2.5 720P、SD2.0 4K など）も引き続き呼び出せますが、出力と課金は名前に含まれる解像度に固定され、resolution は無視されます。これらはモデルスクエアには表示されなくなりました。新規に接続する場合は SD2.5、SD2.0 と resolution を使用してください。