Seedance 動画を作成する

POST

videos

curl https://api.cometapi.com/v1/videos \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -F 'prompt="A matte magenta cube rotates slowly above a cyan studio floor while a small yellow sphere circles it."' \
  -F 'model="seedance-2-5"' \
  -F 'seconds="4"' \
  -F 'size="1280x720"'

{
  "id": "task_abc123",
  "task_id": "task_abc123",
  "object": "video",
  "model": "doubao-seedance-2-0-mini",
  "status": "queued",
  "progress": 0,
  "created_at": 1776681149
}

モデルに対応するサイズ表の値を size に設定します。WxH

Seedance 2.0 Mini には doubao-seedance-2-0-mini を正確に使用してください。短縮した seedance-mini 値は有効なモデル ID ではありません。

対応モデル ID

入力モードと解像度に対応するモデルを選択し、その正確な ID を model フィールドで送信します。

モデル	正確なモデル ID	モードと解像度の階層	対応 `seconds`
Seedance 2.5	`seedance-2-5`	テキストから動画、参照メディア； `480p`, `720p`	`4`-`30`
Seedance 2.0	`doubao-seedance-2-0`	テキストから動画、参照メディア； `480p`, `720p`, `1080p`, `4K`	`4`-`15`
Seedance 2.0 Fast	`doubao-seedance-2-0-fast`	テキストから動画、参照メディア； `480p`, `720p`	`4`-`15`
Seedance 2.0 Mini	`doubao-seedance-2-0-mini`	テキストから動画、参照メディア； `480p`, `720p`	`4`-`15`
Seedance 1.5 Pro	`doubao-seedance-1-5-pro`	テキストから動画、画像から動画； `480p`, `720p`, `1080p`	`4`-`12`
Seedance 1.0 Pro	`doubao-seedance-1-0-pro`	テキストから動画、画像から動画； `480p`, `720p`, `1080p`	`2`-`10`

参照画像を使用する

POST /v1/videos を multipart/form-data として送信し、参照画像は input_reference に指定します。複数の画像を使用する場合は、画像の順序に従ってフィールドを繰り返し、各フィールドに公開アクセス可能な HTTPS 画像 URL を 1 つ、またはアップロードした画像ファイルを 1 つ指定します。このフィールド内では URL のみ、またはファイルのみを使用してください。URL をカンマで連結せず、各 URL を個別に送信します。アップロードする各画像は 20 MiB（20 × 1024 × 1024 バイト). Seedance 1.0 Pro と 1.5 Pro では参照画像を 1 枚使用します。Seedance 2.0、Fast、Mini では最大 9 枚の参照画像を受け付けます。 Seedance 2.5 では最大 30 枚の参照画像を受け付けます。これらの数は URL とアップロードファイルの両方に適用されます。プロンプトで、各画像に被写体、設定、視覚スタイルなどの役割を割り当てます。維持する外観、アクション、カメラの動きを説明します。このページ上部のリクエストサンプルでは、画像 URL 入力と、単一画像または複数画像のアップロードを示しています。

参照画像 URL を送信する

被写体の外観と設定を指定するために、2 つの画像 URL を使用します：

curl \
  https://api.cometapi.com/v1/videos \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  --form-string 'model=doubao-seedance-2-0' \
  --form-string 'prompt=Use the subject in @Image1 and the setting in @Image2. Use a slow camera push-in and natural motion.' \
  --form-string 'seconds=5' \
  --form-string 'size=1280x720' \
  --form-string 'input_reference=https://your-image-host/subject.png' \
  --form-string 'input_reference=https://your-image-host/setting.png'

参照動画と音声を使用する

Seedance 2.0、Fast、Mini、2.5 では、reference_videos と reference_audios を受け付けます。動画の参照には MP4 ファイル、音声の参照には MP3 ファイルを使用します。各ファイルは、一般公開された HTTPS URL またはアップロード済みファイルとして送信します。参照音声は、少なくとも 1 つの画像または動画と組み合わせてください。プロンプトでは、@Image1、@Video1、@Audio1 を使用して参照に役割を割り当てます。参照は、各メディアタイプ内での順序に従って番号を付けます。異なるフィールド間で URL とアップロードを組み合わせることができます。 input_reference、reference_videos、reference_audios のそれぞれでは、すべて URL またはすべてファイルのいずれかを使用します。複数の入力では、URL をカンマで結合するのではなく、入力ごとにフィールドを 1 回繰り返します。

モデルファミリー	参照画像	参照動画	参照音声	参照入力の合計
Seedance 2.0、Fast、Mini	最大 9 件の URL またはファイル（ `input_reference`	最大 3	最大 3	最大 12
Seedance 2.5	最大 30 件の URL またはファイル（ `input_reference`	最大 10 件の URL または 5 ファイル	最大 10 件の URL または 5 ファイル	最大 50

アップロードする各動画は 50 MiB 以下、各音声ファイルは 15 MiB 以下にしてください。 1 MiB は 1024 × 1024 バイトです。標準の Seedance 2.0（doubao-seedance-2-0）には、URL とアップロード済みファイルの両方に追加のメディア制限があります。参照動画では、合計再生時間を 2 ～ 15 秒、合計サイズを 50 MB 未満にしてください。参照動画の解像度には、およそ 480p（640x640）から 720p（834x1112）). 参照音声では、合計再生時間を 15 秒以下、各ファイルを 15 MB 以下にしてください。アップロードするメディアは、上記のファイルごとのアップロード制限も満たす必要があります。

参照動画 URL を送信する

参照動画を使用して、カメラの動きとアクションを誘導します。

curl \
  https://api.cometapi.com/v1/videos \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  --form-string 'model=doubao-seedance-2-0' \
  --form-string 'prompt=Follow the camera movement and action in @Video1. Preserve the direction and pace of the motion.' \
  --form-string 'seconds=5' \
  --form-string 'size=1280x720' \
  --form-string 'reference_videos=https://your-media-host/reference.mp4'

画像 URL と音声を組み合わせる

参照音声のリズムに合わせて、参照対象をアニメーション化します。

curl \
  https://api.cometapi.com/v1/videos \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  --form-string 'model=doubao-seedance-2-0' \
  --form-string 'prompt=Animate the subject in @Image1 to the rhythm of @Audio1. Preserve the subject appearance and use a fixed camera.' \
  --form-string 'seconds=5' \
  --form-string 'size=1280x720' \
  --form-string 'input_reference=https://your-image-host/subject.png' \
  --form-string 'reference_audios=https://your-media-host/reference.mp3'

Seedance 2.5 で参照メディアをアップロードする

1 回のリクエストで 2 枚の画像、MP4 動画、MP3 音声ファイルをアップロードします。

curl \
  https://api.cometapi.com/v1/videos \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  --form-string 'model=seedance-2-5' \
  --form-string 'prompt=Use the subject in @Image1 and the setting in @Image2. Follow the motion in @Video1 and the rhythm of @Audio1.' \
  --form-string 'seconds=5' \
  --form-string 'size=1280x720' \
  --form 'input_reference=@/path/to/subject.png;type=image/png' \
  --form 'input_reference=@/path/to/setting.png;type=image/png' \
  --form 'reference_videos=@/path/to/reference.mp4;type=video/mp4' \
  --form 'reference_audios=@/path/to/reference.mp3;type=audio/mpeg'

モデル別の期間

seconds をモデルでサポートされる範囲内の整数値に設定します。省略した場合、CometAPI は5秒のクリップをリクエストします。

モデルファミリー	対応範囲 `seconds`	デフォルト	範囲外の動作
Seedance 2.5	`4`-`30`	`5`	範囲内の整数の秒数を使用します。
Seedance 2.0、Seedance 2.0 Fast、Seedance 2.0 Mini	`4`-`15`	`5`	範囲内の整数の秒数を使用します。
Seedance 1.5 Pro	`4`-`12`	`5`	範囲内の整数の秒数を使用します。
Seedance 1.0 Pro	`2`-`10`	`5`	範囲内の整数の秒数を使用します。

モデル別のサイズ対応

Seedance 2.5

Seedance 2.5 では、これらの WxH 値はテキストプロンプトと参照メディアの両方に適用されます。

解像度クラス	`16:9`	`4:3`	`1:1`	`3:4`	`9:16`	`21:9`
`480p`	`854x480`	`752x560`	`640x640`	`560x752`	`480x854`	`992x432`
`720p`	`1280x720`	`1112x834`	`960x960`	`834x1112`	`720x1280`	`1470x630`

以前のSeedanceモデル

最後の列には、Seedance 1.5 Pro、標準のSeedance 2.0、およびFast向けの正確な WxH 値がまとめられています。 Seedance 2.0 Fast では、その列の 480p 値と 720p 値のみを使用します。その列の 1080p 値は、Seedance 1.5 Pro と標準のSeedance 2.0 に適用されます。 4K 値は標準のSeedance 2.0 にのみ適用されます。Mini列では、— はその解像度がサポートされていないことを意味します。

解像度クラス	アスペクト比	Seedance 2.0 Mini	Seedance 1.0シリーズ	Seedance 1.5 Pro / 標準のSeedance 2.0 / Fast
`480p`	`16:9`	`864x496`	`864x480`	`864x496`
	`4:3`	`752x560`	`736x544`	`752x560`
	`1:1`	`640x640`	`640x640`	`640x640`
	`3:4`	`560x752`	`544x736`	`560x752`
	`9:16`	`496x864`	`480x864`	`496x864`
	`21:9`	`992x432`	`960x416`	`992x432`
`720p`	`16:9`	`1280x720`	`1248x704`	`1280x720`
	`4:3`	`1112x834`	`1120x832`	`1112x834`
	`1:1`	`960x960`	`960x960`	`960x960`
	`3:4`	`834x1112`	`832x1120`	`834x1112`
	`9:16`	`720x1280`	`704x1248`	`720x1280`
	`21:9`	`1470x630`	`1504x640`	`1470x630`
`1080p`	`16:9`	—	`1920x1088`	`1920x1080`
	`4:3`	—	`1664x1248`	`1664x1248`
	`1:1`	—	`1440x1440`	`1440x1440`
	`3:4`	—	`1248x1664`	`1248x1664`
	`9:16`	—	`1088x1920`	`1080x1920`
	`21:9`	—	`2176x928`	`2206x946`
`4K`	`16:9`	—	—	`3840x2160` (Seedance 2.0のみ)
	`4:3`	—	—	`3326x2494` (Seedance 2.0のみ)
	`1:1`	—	—	`2880x2880` (Seedance 2.0のみ)
	`3:4`	—	—	`2494x3326` (Seedance 2.0のみ)
	`9:16`	—	—	`2160x3840` (Seedance 2.0のみ)
	`21:9`	—	—	`4398x1886` (Seedance 2.0のみ)

Seedance 2.0 Mini は 480p と 720p をサポートします。size をMini列の WxH 値に設定してください。

承認

Authorization

string

header

必須

Bearer token authentication. Use your CometAPI key.

ボディ

multipart/form-data

prompt

string

必須

Text prompt that describes the video. Required. When using reference images, describe what each image should control, such as the subject from @Image1, the secondary object from @Image2, and the background or style from @Image3. Also state the action, camera motion, visual style, and scene.

例:

"A slow cinematic camera push across a coastal landscape at sunrise."

model

enum<string>

必須

Seedance model ID. Use one of the exact values below. Aliases such as seedance-mini are not accepted.

利用可能なオプション:

seedance-2-5,

doubao-seedance-2-0,

doubao-seedance-2-0-fast,

doubao-seedance-2-0-mini,

doubao-seedance-1-5-pro,

doubao-seedance-1-0-pro

例:

"doubao-seedance-2-0-mini"

seconds

integer

デフォルト:5

Video duration in seconds. Seedance 2.5 accepts 4 to 30. Seedance 2.0, Seedance 2.0 Fast, and Seedance 2.0 Mini accept 4 to 15. Seedance 1.5 Pro accepts 4 to 12, and Seedance 1.0 Pro accepts 2 to 10. The default is 5.

必須範囲: 2 <= x <= 30

例:

5

size

string

Output size as an exact WxH value. For Seedance 2.5 text-to-video and image-to-video, use 854x480, 752x560, 640x640, 560x752, 480x854, or 992x432 for 480p; use 1280x720, 1112x834, 960x960, 834x1112, 720x1280, or 1470x630 for 720p. For Seedance 2.0 Mini, use 864x496, 752x560, 640x640, 560x752, 496x864, or 992x432 for 480p; use the same documented 720p values. The standard Seedance 2.0 model also accepts its documented 4K values.

Pattern: ^[1-9]\d{2,3}x[1-9]\d{2,3}$

例:

"854x480"

"480x854"

"864x496"

"752x560"

"640x640"

"560x752"

"496x864"

"992x432"

"1280x720"

"1112x834"

"960x960"

"834x1112"

"720x1280"

"1470x630"

"1920x1080"

"1080x1920"

"3840x2160"

"3326x2494"

"2880x2880"

"2494x3326"

"2160x3840"

"4398x1886"

input_reference

Reference images: repeat input_reference with one publicly accessible HTTPS image URL or one uploaded image file per field. Use only URLs or only files within this field; do not join URLs with commas. Keep each uploaded image at or below 20 MiB. Seedance 2.0, Fast, and Mini allow up to nine image URLs or files and 12 reference inputs in total. Seedance 2.5 allows up to 30 image URLs or files and 50 reference inputs in total. For Seedance 1.0 Pro and 1.5 Pro, send one URL or one file. Submit images in the order you want to reference them in the prompt.

Pattern: ^https://

reference_videos

(string<uri> | file)[]

Reference video inputs for Seedance 2.0, Fast, Mini, and 2.5. Repeat reference_videos with a publicly accessible HTTPS MP4 URL or an uploaded MP4 file. Use only URLs or only files within this field. Each file can be up to 50 MiB. Seedance 2.0, Fast, and Mini allow up to three video inputs and 12 reference inputs in total. Seedance 2.5 allows up to ten video URLs or five uploaded video files, with 50 reference inputs in total. For standard Seedance 2.0 (doubao-seedance-2-0), URL and uploaded references must have a combined video duration of 2 to 15 seconds and a total video size under 50 MB. Each reference video must have a resolution of approximately 480p (640x640) to 720p (834x1112). These media limits apply in addition to the 50 MiB per-file upload limit.

Required array length: 1 - 10 elements

Pattern: ^https://

例:

"https://your-media-host/reference.mp4"

reference_audios

(string<uri> | file)[]

Reference audio inputs for Seedance 2.0, Fast, Mini, and 2.5. Repeat reference_audios with a publicly accessible HTTPS MP3 URL or an uploaded MP3 file. Use only URLs or only files within this field. Each file can be up to 15 MiB. Seedance 2.0, Fast, and Mini allow up to three audio inputs and 12 reference inputs in total. Seedance 2.5 allows up to ten audio URLs or five uploaded audio files, with 50 reference inputs in total. Pair audio with at least one reference image or video. For standard Seedance 2.0 (doubao-seedance-2-0), URL and uploaded audio references must have a combined duration at or below 15 seconds, with each audio file at or below 15 MB. These media limits apply in addition to the 15 MiB per-file upload limit.

Required array length: 1 - 10 elements

Pattern: ^https://

例:

"https://your-media-host/reference.mp3"

レスポンス

Task created. Save the returned id and poll GET /v1/videos/{id}.

string

必須

Task id. Use it as the path parameter for GET /v1/videos/{id}.

object

string

必須

Object type, always video.

model

string

必須

Echo of the requested model id.

status

enum<string>

必須

Initial task status. Newly created tasks are returned as queued.

利用可能なオプション:

queued,

in_progress,

completed,

failed,

error

progress

integer

必須

Completion percentage. 0 at creation.

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

created_at

integer

必須

Task creation time as a Unix timestamp in seconds.

task_id

string

Alias of id returned for compatibility. The value matches id.

最終更新日 2026年9月9日

curl https://api.cometapi.com/v1/videos \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -F 'prompt="A matte magenta cube rotates slowly above a cyan studio floor while a small yellow sphere circles it."' \
  -F 'model="seedance-2-5"' \
  -F 'seconds="4"' \
  -F 'size="1280x720"'

{
  "id": "task_abc123",
  "task_id": "task_abc123",
  "object": "video",
  "model": "doubao-seedance-2-0-mini",
  "status": "queued",
  "progress": 0,
  "created_at": 1776681149
}

コンテンツモデレーション

APIキー

対応モデル ID

参照画像を使用する

参照画像 URL を送信する

参照動画と音声を使用する

参照動画 URL を送信する

画像 URL と音声を組み合わせる

Seedance 2.5 で参照メディアをアップロードする

モデル別の期間

モデル別のサイズ対応

Seedance 2.5

以前のSeedanceモデル

承認

ボディ

レスポンス

​対応モデル ID

​参照画像を使用する

​参照画像 URL を送信する

​参照動画と音声を使用する

​参照動画 URL を送信する

​画像 URL と音声を組み合わせる

​Seedance 2.5 で参照メディアをアップロードする

​モデル別の期間

​モデル別のサイズ対応

​Seedance 2.5

​以前のSeedanceモデル

承認

ボディ

レスポンス

対応モデル ID

参照画像を使用する

参照画像 URL を送信する

参照動画と音声を使用する

参照動画 URL を送信する

画像 URL と音声を組み合わせる

Seedance 2.5 で参照メディアをアップロードする

モデル別の期間

モデル別のサイズ対応

Seedance 2.5

以前のSeedanceモデル