メインコンテンツへスキップ
POST

承認

Authorization
string
header
必須

##すべてのAPIはBearer Tokenによる認証が必要です##

APIキーの取得:

APIキー管理ページ にアクセスしてAPIキーを取得してください

リクエストヘッダーに以下を追加:

ボディ

application/json

このページは各モードのパラメータをまとめています。必須項目、指定可能な値、デフォルト値は選択した model に従います。違いは以下のモード別説明を参照してください。

model
enum<string>
必須

動画生成モデル名

利用可能なオプション:
seedance-2.5-flash-text-to-video,
seedance-2.5-flash-image-to-video,
seedance-2.5-flash-reference-to-video,
seedance-2.5-flash-video-edit,
seedance-2.5-flash-video-extend
例:

"seedance-2.5-flash-text-to-video"

prompt
string
必須

Text-to-Video

生成したい動画を説明するテキストプロンプト。中国語・英語に対応。中国語は500文字以内、英語は1000ワード以内を推奨。プロンプトの最大長:10000 tokens

注意:

  • このモデルはテキストのみの動画生成です。image_urls、video_urls、audio_urls の入力には対応していません

Image-to-Video

生成したい動画を説明するテキストプロンプト。中国語・英語に対応。中国語は500文字以内、英語は1000ワード以内を推奨。プロンプトの最大長:10000 tokens

注意:

  • このモデルは video_urls、audio_urls の入力には対応していません

Reference-to-Video

生成したい動画を説明するテキストプロンプト。中国語・英語に対応。中国語は500文字以内を推奨。プロンプトの最大長:10000 tokens

説明:

  • prompt 内で入力素材を参照する場合は、「画像1」「動画1」「音声1」のような自然言語表現だけに頼らず、@image1、@video1、@audio1 のような明示的なタグを優先してください
  • タグ番号は対応する URL 配列の順序と一致し、1 から始まります。image_urls の最初の要素は @image1、video_urls の最初の要素は @video1、audio_urls の最初の要素は @audio1 です
  • 自然言語による番号指定も認識される場合がありますが、明示的なタグのほうが各素材と用途をより正確に対応付けられます

編集 / 延長タスクと判定されないために:

  • タスク種別はプロンプトの意図から判定されます。「動画を編集」「追加」「削除」「変更 / 置換」などの表現は動画編集と判定され、「前方 / 後方に延長」「続きを書く」などの表現は動画延長と判定されます
  • これらのタスクと判定された場合、aspect_ratio は adaptive、動画編集では duration は -1 である必要があります。満たさない場合、送信時にはエラーにならず、後からタスクが failed(エラーコード InvalidParameter.TaskTypeConstraint)になります。仮押さえされたクレジットは返却されますが、待った時間は無駄になります
  • 編集 / 延長が目的の場合は seedance-2.5-flash-video-edit、seedance-2.5-flash-video-extend を直接ご利用ください。送信時にパラメータを検証するため、不正な値は即座に同期エラーとなります
  • 参照生成のみを行う場合は、「置き換える」「消す」といった表現を「画面に … が現れる」「@image1 のスタイルで表現する」のような描写的な表現に言い換えてください

Video Edit

希望する編集内容を記述するテキストプロンプト。日本語・中国語・英語に対応し、500 文字以内を推奨します。プロンプトの最大長:10000 tokens

説明:

  • プロンプトには編集意図を明記してください。例:「動画を編集:@video1 の BGM を削除」
  • 各素材の用途は自然言語で指定できます。例:「@video1 の人物を @image1 の人物に置き換える」
  • モデルは素材番号と用途の対応関係を自動的に理解します

Video Extend

希望する延長内容を記述するテキストプロンプト。日本語・中国語・英語に対応し、500 文字以内を推奨します。プロンプトの最大長:10000 tokens

説明:

  • プロンプトには延長意図を明記してください。例:「@video1 を後方に延長、人物がフレーム外へ歩き去る」
  • 各素材の用途は自然言語で指定できます。例:「@image1 のスタイルで @video1 を前方に延長する」
  • モデルは素材番号と用途の対応関係を自動的に理解します
例:

"A macro lens focuses on a green glass frog on a leaf. The focus gradually shifts from its smooth skin to its completely transparent abdomen, where a bright red heart is beating powerfully and rhythmically."

image_urls
string<uri>[]

対象モード: Image-to-Video, Reference-to-Video, Video Edit, Video Extend

Image-to-Video

画像 URL 配列、1〜2 枚

画像枚数と動作:

画像要件:

  • 対応フォーマット:.jpeg、.png、.webp
  • アスペクト比(幅/高さ):0.4 〜 2.5
  • 幅・高さピクセル:300 〜 6000 px
  • 1枚あたりのサイズ:30MB 以内
  • リクエストボディの合計サイズは 64MB 以内
  • 先頭・末尾フレームを入力する場合、2枚の画像は同一でも可。アスペクト比が異なる場合は先頭フレームを基準とし、末尾フレームは自動トリミングで適応
  • 画像URLはサーバーから直接アクセス可能である必要があります

素材の指定: 公開アクセス可能な HTTP(S) URL と、選択された上流アカウントから利用できる asset:// 素材 ID に対応します。

Reference-to-Video

参照画像 URL 配列、省略可。指定する場合は1〜10枚

参照素材は任意: image_urls、video_urls、audio_urls はすべて省略できます。audio_urls のみの指定にも対応します。

役割の説明:

画像要件:

  • 対応フォーマット:.jpeg、.png、.webp
  • アスペクト比(幅/高さ):0.4 〜 2.5
  • 幅・高さピクセル:300 〜 6000 px
  • 1枚あたりのサイズ:30MB 以内
  • リクエストボディの合計サイズは 64MB 以内。Base64エンコードは使用しないでください
  • 画像URLはサーバーから直接アクセス可能である必要があります

素材の指定: 公開アクセス可能な HTTP(S) URL と、選択された上流アカウントから利用できる asset:// 素材 ID に対応します。

Video Edit

参照画像 URL 配列、省略可。指定する場合は1〜10枚

必須条件: 本モデルでは video_urls が必須です。画像は任意の補助参考素材です。

役割の説明:

画像要件:

  • 対応フォーマット:.jpeg、.png、.webp
  • アスペクト比(幅/高さ):0.4 〜 2.5
  • 幅・高さピクセル:300 〜 6000 px
  • 1枚あたりのサイズ:30MB 以内
  • リクエストボディの合計サイズは 64MB 以内。Base64エンコードは使用しないでください
  • 画像URLはサーバーから直接アクセス可能である必要があります

素材の指定: 公開アクセス可能な HTTP(S) URL と、選択された上流アカウントから利用できる asset:// 素材 ID に対応します。

Video Extend

参照画像 URL 配列、省略可。指定する場合は1〜10枚

必須条件: 本モデルでは video_urls が必須です。画像は任意の補助参考素材です。

役割の説明:

画像要件:

  • 対応フォーマット:.jpeg、.png、.webp
  • アスペクト比(幅/高さ):0.4 〜 2.5
  • 幅・高さピクセル:300 〜 6000 px
  • 1枚あたりのサイズ:30MB 以内
  • リクエストボディの合計サイズは 64MB 以内。Base64エンコードは使用しないでください
  • 画像URLはサーバーから直接アクセス可能である必要があります

素材の指定: 公開アクセス可能な HTTP(S) URL と、選択された上流アカウントから利用できる asset:// 素材 ID に対応します。

Maximum array length: 10
例:
video_urls
string<uri>[]

対象モード: Reference-to-Video, Video Edit, Video Extend

Reference-to-Video

参照動画 URL 配列、省略可。指定する場合は1〜5本

参照素材は任意: image_urls、video_urls、audio_urls はすべて省略できます。audio_urls のみの指定にも対応します。

役割の説明:

動画要件:

  • 対応フォーマット:.mp4、.mov
  • 解像度:480p、720p、1080p、4K
  • 1本あたりの動画時間:2 〜 30 秒、最大5本、全動画の合計時間 ≤ 30 秒
  • アスペクト比(幅/高さ):0.4 〜 2.5
  • 幅・高さピクセル:300 〜 6000 px
  • 画面ピクセル(幅 × 高さ):409,600 〜 8,295,044(例:640×640 〜 3326×2494)
  • 1本あたりのサイズ:200MB 以内
  • フレームレート:24 〜 60 FPS
  • リクエストボディの合計サイズは 64MB 以内。Base64エンコードは使用しないでください
  • コーデック、解像度などの素材の有効性は、モデル側で追加確認されます
  • 動画参照を使用すると追加料金が発生します(入力動画の再生時間が課金に算入)
  • 動画URLはサーバーから直接アクセス可能である必要があります

素材の指定: 公開アクセス可能な HTTP(S) URL と、選択された上流アカウントから利用できる asset:// 素材 ID に対応します。

Video Edit

入力動画 URL 配列、必須;1–5 本

必須条件: 少なくとも 1 本の動画(編集対象)が必要です。1 本目が編集対象となり、残りは参考素材として扱われます。

役割の説明:

動画要件:

  • 対応フォーマット:.mp4、.mov
  • 解像度:480p、720p、1080p、4K
  • 1本あたりの動画時間:4 〜 30 秒(1 本目が編集対象)、最大5本、全動画の合計時間 ≤ 30 秒
  • アスペクト比(幅/高さ):0.4 〜 2.5
  • 幅・高さピクセル:300 〜 6000 px
  • 画面ピクセル(幅 × 高さ):409,600 〜 8,295,044(例:640×640 〜 3326×2494)
  • 1本あたりのサイズ:200MB 以内
  • フレームレート:24 〜 60 FPS
  • リクエストボディの合計サイズは 64MB 以内。Base64エンコードは使用しないでください
  • コーデック、解像度などの素材の有効性は、モデル側で追加確認されます
  • 動画参照を使用すると追加料金が発生します(入力動画の再生時間が課金に算入)
  • 動画URLはサーバーから直接アクセス可能である必要があります

素材の指定: 公開アクセス可能な HTTP(S) URL と、選択された上流アカウントから利用できる asset:// 素材 ID に対応します。

Video Extend

入力動画 URL 配列、必須;1–5 本

必須条件: 少なくとも 1 本の動画(延長対象)が必要です。1 本目が延長対象となり、残りは参考素材として扱われます。

役割の説明:

動画要件:

  • 対応フォーマット:.mp4、.mov
  • 解像度:480p、720p、1080p、4K
  • 1本あたりの動画時間:2 〜 30 秒、最大5本、全動画の合計時間 ≤ 30 秒
  • アスペクト比(幅/高さ):0.4 〜 2.5
  • 幅・高さピクセル:300 〜 6000 px
  • 画面ピクセル(幅 × 高さ):409,600 〜 8,295,044(例:640×640 〜 3326×2494)
  • 1本あたりのサイズ:200MB 以内
  • フレームレート:24 〜 60 FPS
  • リクエストボディの合計サイズは 64MB 以内。Base64エンコードは使用しないでください
  • コーデック、解像度などの素材の有効性は、モデル側で追加確認されます
  • 動画参照を使用すると追加料金が発生します(入力動画の再生時間が課金に算入)
  • 動画URLはサーバーから直接アクセス可能である必要があります

素材の指定: 公開アクセス可能な HTTP(S) URL と、選択された上流アカウントから利用できる asset:// 素材 ID に対応します。

Maximum array length: 5
例:
audio_urls
string<uri>[]

対象モード: Reference-to-Video, Video Edit, Video Extend

Reference-to-Video

参照音声 URL 配列、省略可。指定する場合は1〜5本

参照素材は任意: image_urls、video_urls、audio_urls はすべて省略できます。audio_urls のみの指定にも対応します。

役割の説明:

音声要件:

  • 対応フォーマット:.wav、.mp3
  • 1本あたりの音声時間:2 〜 30 秒、最大5本、全音声の合計時間 ≤ 30 秒
  • 1本あたりのサイズ:15MB 以内
  • リクエストボディの合計サイズは 64MB 以内。Base64エンコードは使用しないでください
  • 音声URLはサーバーから直接アクセス可能である必要があります

素材の指定: 公開アクセス可能な HTTP(S) URL と、選択された上流アカウントから利用できる asset:// 素材 ID に対応します。

Video Edit / Video Extend

参照音声 URL 配列、省略可。指定する場合は1〜5本

必須条件: 本モデルでは video_urls が必須です。音声は任意の補助参考素材です。

役割の説明:

音声要件:

  • 対応フォーマット:.wav、.mp3
  • 1本あたりの音声時間:2 〜 30 秒、最大5本、全音声の合計時間 ≤ 30 秒
  • 1本あたりのサイズ:15MB 以内
  • リクエストボディの合計サイズは 64MB 以内。Base64エンコードは使用しないでください
  • 音声URLはサーバーから直接アクセス可能である必要があります

素材の指定: 公開アクセス可能な HTTP(S) URL と、選択された上流アカウントから利用できる asset:// 素材 ID に対応します。

Maximum array length: 5
例:
duration

Text-to-Video / Image-to-Video

動画の再生時間(秒)、デフォルトは 5 秒

説明:

  • 4〜30 秒の任意の整数値に対応
  • -1:自動時長。モデルが 4–30 秒の範囲で決定し、実際の出力時間に基づいて課金されます
  • 再生時間は課金に直接影響します

Reference-to-Video

出力動画の再生時間(秒)、デフォルトは 5 秒

説明:

  • 4〜30 秒の任意の整数値に対応
  • -1:自動時長。モデルが 4–30 秒の範囲で決定し、実際の出力時間に基づいて課金されます
  • 再生時間は課金に直接影響します

プロンプトが動画編集タスクと判定された場合、有効なのは -1 のみです。具体的な秒数を指定すると、送信時にはエラーにならず、後からタスクが失敗します

Video Edit

出力動画の長さ(秒)、デフォルトは -1

説明:

  • -1 のみ対応:出力の長さは入力動画に従います(最大 0.4 秒短くなる場合があります)
  • 任意の秒数指定はできず、具体的な数値を指定すると拒否されます
  • 動画の長さは課金に直結します

Video Extend

出力動画の長さ(秒)、デフォルトは 5 秒

説明:

  • 4〜30 秒の任意の整数値に対応
  • -1:自動時長。実際の出力時間に基づいて課金されます
  • 動画の長さは課金に直結します
利用可能なオプション:
-1
例:

8

quality
enum<string>
デフォルト:720p

動画の解像度、デフォルトは 720p

選択可能な値:

  • 480p:解像度が低め、料金も低め
  • 720p:標準解像度、デフォルト値
利用可能なオプション:
480p,
720p
例:

"720p"

aspect_ratio
enum<string>
デフォルト:adaptive

Text-to-Video

動画のアスペクト比、デフォルトは adaptive

選択可能な値:

  • 16:9(横向き)、9:16(縦向き)、1:1(正方形)、4:3、3:4、21:9(ウルトラワイド)
  • adaptive:モデルがプロンプトに基づいて最適なアスペクト比を自動選択

各解像度の対応ピクセル値:

Image-to-Video

動画のアスペクト比、Image-to-Video では adaptive のみ対応

選択可能な値:

  • adaptive:先頭フレーム画像の比率に基づいて最も近いアスペクト比を自動選択(本モデルで指定できる唯一の値)
  • 本モデルでは 16:9、9:16 などの固定比率を指定できません

Reference-to-Video

動画のアスペクト比、デフォルトは adaptive

選択可能な値:

  • 16:9(横向き)、9:16(縦向き)、1:1(正方形)、4:3、3:4、21:9(ウルトラワイド)
  • adaptive:プロンプトの意図に基づいて判断。優先順位:動画 > 画像 > プロンプト

各解像度の対応ピクセル値:

プロンプトが動画編集 / 動画延長タスクと判定された場合、有効なのは adaptive のみです。固定比率を指定すると、送信時にはエラーにならず、後からタスクが失敗します

Video Edit / Video Extend

動画のアスペクト比、デフォルトは adaptive

選択可能な値:

  • adaptive:出力比率は 1 本目の入力動画に従います。本モデルで指定できる唯一の値です
  • 16:9、9:16 などの固定比率を指定すると拒否されます
利用可能なオプション:
16:9,
9:16,
1:1,
4:3,
3:4,
21:9,
adaptive
例:

"16:9"

generate_audio
boolean
デフォルト:true

Text-to-Video

同期音声を生成するかどうか、デフォルトは true

選択可能な値:

  • true:動画に同期音声(人声、効果音、BGM)を含む、追加料金なし。会話部分をダブルクォーテーションで囲むと音声生成の品質が向上します
  • false:無音動画を出力

Image-to-Video / Reference-to-Video / Video Edit / Video Extend

同期音声を生成するかどうか、デフォルトは true

選択可能な値:

  • true:動画に同期音声を含む、追加料金なし
  • false:無音動画を出力
例:

true

content_filter
boolean
デフォルト:true

コンテンツフィルター、デフォルトは true

選択可能な値:

  • true:標準のコンテンツ安全チェック、これがデフォルトです
  • false:コンテンツ制限を緩和し、料金が +10%(1.1x)加算されます。違法および禁止されたコンテンツはこの設定に関係なく常に適用されます

ウェブ検索と併用不可:

  • content_filter: false と model_params.web_search: true は同時に使用できません。両方を指定すると 400 パラメータエラーが返されます
  • ウェブ検索が必要な場合は content_filter: true(デフォルト)のままにしてください
例:

true

output_format
enum<string>
デフォルト:mp4

出力コンテナ形式、デフォルトは mp4

選択可能な値:

  • mp4:H.264 エンコード、互換性が最も高く標準的な色精度(デフォルト)
  • mov:H.264 + yuv444p クロマサンプリング + PCM 音声。色再現性が高く、カラーグレーディングやキーイング、合成などのポストプロダクション向け。ブラウザ内での再生に対応しない場合があるため、ダウンロードして VLC / mpv / ffplay で再生してください。追加料金なし
利用可能なオプション:
mp4,
mov
例:

"mp4"

model_params
object

対象モード: Text-to-Video

モデル拡張パラメータ

callback_url
string<uri>

タスク完了後の HTTPS コールバックアドレス

コールバックタイミング:

  • タスク完了(completed)または失敗(failed)時にトリガー
  • 課金確認完了後に送信

セキュリティ制限:

  • HTTPS プロトコルのみ対応
  • プライベートIPアドレスへのコールバックは禁止(127.0.0.1、10.x.x.x、172.16-31.x.x、192.168.x.x など)
  • URL の長さは 2048 文字以内

コールバックメカニズム:

  • タイムアウト:10 秒
  • 失敗後最大 3 回リトライ(失敗後 1/2/4 秒でそれぞれリトライ)
  • コールバックレスポンスボディのフォーマットはタスク照会APIの返却フォーマットと同一
  • 2xx ステータスコードを成功とみなし、その他のステータスコードでリトライをトリガー
例:

"https://your-domain.com/webhooks/video-task-completed"

レスポンス

動画生成タスクの作成に成功

created
integer

タスク作成タイムスタンプ

例:

1761313744

id
string

タスクID

例:

"task-unified-1774857405-abc123"

model
string

実際に使用されたモデル名

例:

"seedance-2.5-flash-text-to-video"

object
enum<string>

タスクの具体的なタイプ

利用可能なオプション:
video.generation.task
progress
integer

タスク進捗パーセンテージ (0-100)

必須範囲: 0 <= x <= 100
例:

0

status
enum<string>

タスクステータス

利用可能なオプション:
pending,
processing,
completed,
failed
例:

"pending"

task_info
object

動画タスクの詳細情報

type
enum<string>

タスクの出力タイプ

利用可能なオプション:
text,
image,
audio,
video
例:

"video"

usage
object

使用量と課金情報