Skip to main content
POST

認証

string
必須
すべてのAPIエンドポイントはBearer Token認証が必要ですAPIキーの取得:APIキー管理ページにアクセスしてAPIキーを取得してくださいリクエストヘッダーに追加:

リクエストパラメータ

string
必須
動画生成モデル名サポートされるモデル:
  • seedance-2.0 - スタンダード版、テキストから動画、画像から動画、最初/最後のフレーム動画、参照動画、参照音声、音声付き動画をサポート
  • seedance-2.0-fast - 高速版、スタンダード版と同じ機能で、生成速度がより高速
  • seedance-2.0-mini - ミニ版、スタンダード版と同じ機能
boolean
デフォルト:"false"
動画タスクを送信する前にコンテンツモデレーションを実行するかどうかを指定します。
  • trueomni-moderation-latest でプロンプトと入力画像を審査
  • false または省略:審査リクエストを行わず、審査コストや遅延を追加しない(デフォルト)
審査対象:
  • テキスト:promptnegative_prompt
  • 画像:image_urlsimage_with_roles[].urlfirst_frame_imagelast_frame_image
  • 画像形式の非公開 asset:// 素材:元の公開 URL を解決して審査
  • Base64 画像:公開 URL に変換後に審査
video_urlsaudio_urls、動画/音声形式の非公開素材は、審査モデルが動画と音声に対応していないため審査されません対応モデル ID:seedance-2.0seedance-2.0-fastseedance-2.0-miniseedance-2.0-faceseedance-2.0-fast-faceseedance-2-0(旧名)、seedance-2.5審査呼び出し自体は、動画リクエストを送信したユーザーには課金されません。
  • 検出時は HTTP 400(nsfw_content_detected)を同期的に返します。タスクと task_id は作成されず、動画生成枠も消費されません
  • 審査サービスが利用できない、タイムアウトする、または応答が不正な場合は fail-open となり、生成リクエストは続行されます。このオプションを絶対的な安全保証として使用しないでください
  • 公開画像 URL に解決できない入力はスキップされます。対象外モデルの nsfw_check: true は通知なく無視されます
使用例:
検出時の応答:
string
動画コンテンツの説明テキストから動画の場合は必須、画像から動画/動画参照生成の場合はオプション主題、アクション、カメラワーク、スタイルを明確に記述すると、より良い生成結果が得られます
  • プロンプトは 4000 文字まで入力できますが、500 文字程度を推奨します。
  • モデル seedance-2.0-mini には文字数制限がありません。推奨:中国語のプロンプトは500文字以内、英語のプロンプトは1000語以内にしてください。文字数が多すぎると情報が分散しやすく、モデルが細部を見落として要点のみに注目し、動画に一部の要素が欠ける可能性があります。
例:"子猫がカメラに向かってあくびをする"
integer
デフォルト:"5"
動画の長さ(秒)サポート範囲:4 ~ 15デフォルト:5
string
デフォルト:"16:9"
動画のアスペクト比アスペクト比は 0.5〜2.5 の範囲である必要がありますオプション:
  • 16:9 - 横画面
  • 9:16 - 縦画面
  • 1:1 - 正方形
  • 4:3 - 従来の比率
  • 3:4 - 縦向き従来の比率
  • 21:9 - ウルトラワイド
  • adaptive - 自適応(入力画像/動画に応じて自動的にマッチング)
デフォルト:16:9
string
デフォルト:"720p"
動画の解像度オプション:
  • 480p - 標準画質
  • 720p - 高画質
  • 1080p - フルHD(seedance-2.0 のみ対応)
  • 4k - 超高画質(seedance-2.0 のみ対応)
デフォルト:720p
integer
ランダムシード、生成コンテンツのランダム性を制御するために使用
  • 同じリクエストで異なる seed 値を受け取ると、異なる結果が生成されます
  • 同じリクエストで同じ seed 値を受け取ると、類似の結果が生成されますが、完全に一致することは保証されません
boolean
デフォルト:"true"
音声を生成するかどうか(音声付き動画)true に設定すると、動画にAI生成の音声が含まれますfalse に設定すると、動画に音声は含まれません(無音動画)デフォルト:true
boolean
デフォルト:"false"
最後のフレーム画像を返すかどうかtrue に設定すると、タスク結果に動画の最後のフレームの画像URLが追加で返されます。連続動画生成に使用できますデフォルト:false
array<object>
ツールリスト、ウェブ検索などの拡張機能に使用例:[{"type": "web_search"}]
array<string>
画像URL配列、画像から動画に使用2種類の形式をサポート:
  • 通常の画像URL:https://example.com/cat.jpg
  • Asset URL(審査済み素材):asset://asset_a
例:["https://example.com/cat.jpg"] または ["asset://asset_a"]
Asset URL は、seedance-2.0seedance-2.0-fastseedance-2.0-mini のすべての Seedance 2.0 モデルで使用できます。
  • image_urlsimage_with_roles は同時に使用できません
  • 最大9枚の参照画像
array
ロール付き画像配列、最初のフレーム/最後のフレームの指定をサポート
url フィールドに Asset URL を使用する場合、seedance-2.0seedance-2.0-fastseedance-2.0-mini のすべての Seedance 2.0 モデルに対応します。
例:
Asset URL の書き方:
  • image_urlsimage_with_roles は同時に使用できません
  • 最初/最後のフレーム画像を使用する場合、video_urlsaudio_urls は使用できません
array<string>
参照動画URL配列2種類の形式をサポート:
  • 通常の動画URL:https://example.com/reference.mp4
  • Asset URL(審査済み素材):asset://asset_a
例:["https://example.com/reference.mp4"] または ["asset://asset_a"]
Asset URL は、seedance-2.0seedance-2.0-fastseedance-2.0-mini のすべての Seedance 2.0 モデルで使用できます。
  • 最初/最後のフレーム画像(image_with_roles)を使用する場合、参照動画は使用できません
  • 最大3つの参照動画、1.8s < 合計時間 < 15.2s
  • 参照動画の解像度は 480P ~ 720P の範囲である必要があります
array<string>
参照音声URL配列2種類の形式をサポート:
  • 通常の音声URL:https://example.com/speech.wav
  • Asset URL(審査済み素材):asset://asset_a
例:["https://example.com/speech.wav"] または ["asset://asset_a"]
Asset URL は、seedance-2.0seedance-2.0-fastseedance-2.0-mini のすべての Seedance 2.0 モデルで使用できます。
  • 最初/最後のフレーム画像(image_with_roles)を使用する場合、参照音声は使用できません
  • 最大3つの参照音声、合計時間 ≤ 15s
  • 参照音声は参照画像または参照動画と一緒に使用する必要があります

レスポンス

integer
レスポンスステータスコード、成功時は200
array
レスポンスデータ配列

ユースケース

ケース 1:テキストから動画

ケース 2:画像から動画(最初のフレーム)

ケース 3:最初/最後のフレーム動画

ケース 4:動画参照から動画生成

ケース 5:参照動画 + 参照音声

ケース 6:音声付き動画

ケース 7:連続動画生成(最後のフレームを返す)

ケース 8:高速版生成

ケース 9:参照画像 + 参照動画 + 参照音声(マルチモーダル動画)

参照画像、参照動画、参照音声を組み合わせて、没入感のある一人称視点の広告動画を生成します。商品プロモーション、ブランド広告など、複数素材の融合が必要なシーンに最適です。

ケース 10:Asset URL を使用した画像から動画

審査済みのバーチャルアバター素材を参照画像として直接渡すことができ、再アップロードや再審査は不要です。

ケース 11:Asset URL で参照ポートレートを指定(image_with_roles)

ケース 12:高速版 + Asset URL 画像から動画

ケース 13:Asset URL 画像 + 参照動画(モーション転送)

審査済みの人物素材と参照動画を組み合わせて、指定した動作を行うよう人物を誘導します。
タスク結果の照会動画生成は非同期タスクで、送信時に task_id を返します。タスクステータス取得 エンドポイントを使用して、生成の進行状況と結果を照会してください。

1.5 Proバージョンとの違い