Seedance 動画を作成する

POST

videos

curl https://api.cometapi.com/v1/videos \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -F 'prompt="A matte red cube rotates slowly on a clean white studio floor. The camera remains fixed. Soft daylight and a short shadow."' \
  -F 'model="doubao-seedance-2-0-mini"' \
  -F 'seconds="15"' \
  -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
}

以下の表にある文書化済みの WxH 値を、size フィールドに指定してください。

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

サポートされているモデル ID

model フィールドには、これらの完全一致する値のいずれかを使用してください。

モデル	完全一致するモデル ID	モードと解像度ティア	対応状況 `seconds`
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`

参照画像を使用する

Seedance 2.0、Seedance 2.0 Fast、Seedance 2.0 Mini で参照画像を受け付けるフィールドは input_reference。高度な複数参照プロンプトの場合、をサポートするルートでは、同じ multipart フィールドをアップロード順に繰り返してください。単一の input_reference を含む Mini 本番リクエストの完了時刻は 720x1280。この確認によりリクエストの完了は確認できましたが、プロンプトからの参照画像の視覚的効果を切り分けたものではありません。 Seedance 2.0 は、プロンプトで各参照画像をシーンにどのように関連付けるかに敏感です。アップロードしたファイルを順番に、たとえば [Image 1]、[Image 2]、[Image 3] のように参照し、それぞれの画像に明確な役割を割り当ててください：

主な被写体、キャラクター、または製品には [Image 1] を使用します。
二次的な被写体、小道具、または同行者には [Image 2] を使用します。
背景、設定、照明、またはスタイルには [Image 3] を使用します。

認識可能なまま維持すべきもの、変更可能なもの、アクション、カメラの動き、ビジュアルスタイル、シーンを説明してください。曖昧なプロンプトでは、アップロードが受け付けられていても、生成された動画が参照画像を使用していないように見えることがあります。このプロンプト構造は、画像を列挙するだけの場合より信頼性があります：

Use the uploaded images in order: keep the boy wearing glasses and a blue T-shirt from [Image 1], add the corgi puppy from [Image 2], and use the lawn from [Image 3] as the setting. Create a 4-second 3D cartoon video with the boy and puppy sitting together, a slow camera push-in, soft daylight, and no extra characters.

モデル別の長さ

seconds を省略すると、CometAPI は 5 秒のクリップをリクエストします。特定の長さが必要な場合は、seconds を文字列として送信してください。

モデルファミリー	対応状況 `seconds`	デフォルト	境界時の動作
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`	範囲内の整数秒を使用してください。

モデル別の対応サイズ

以下の表には、正確な WxH 値がまとめられています。Seedance 2.0 Fast では、5 列目の 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 をサポートしますが、1080p と 4K はサポートしません。本番環境でのある確認では、Mini に 1920x1080 をリクエストすると、生成されました 1280x720.

対象モデルに対して、文書化されている WxH 値を選択してください。正確な 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 uploaded image should control, such as the subject from [Image 1], the secondary object from [Image 2], and the background or style from [Image 3]. 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.

利用可能なオプション:

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.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 <= 15

例:

5

size

string

Output size as an exact WxH value. For Seedance 2.0 Mini, use 864x496, 752x560, 640x640, 560x752, 496x864, or 992x432 for 480p; use 1280x720, 1112x834, 960x960, 834x1112, 720x1280, or 1470x630 for 720p. Mini does not support 1080p or 4K. A Mini request for 1920x1080 produced 1280x720 in one production check. The standard Seedance 2.0 model also accepts its documented 4K values.

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

例:

"864x496"

"752x560"

"640x640"

"560x752"

"496x864"

"992x432"

"1280x720"

"1112x834"

"960x960"

"834x1112"

"720x1280"

"1470x630"

"1920x1080"

"1080x1920"

"3840x2160"

"3326x2494"

"2880x2880"

"2494x3326"

"2160x3840"

"4398x1886"

input_reference

file

Optional reference image uploaded as a multipart file. Seedance 2.0, Seedance 2.0 Fast, and Seedance 2.0 Mini accept this field. On routes that support multiple reference images, repeat the field and reference the files in upload order as [Image 1], [Image 2], and so on. Seedance 1.0 Pro and 1.5 Pro do not accept it.

レスポンス

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.

動画生成 API

Seedance 動画を取得する

curl https://api.cometapi.com/v1/videos \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -F 'prompt="A matte red cube rotates slowly on a clean white studio floor. The camera remains fixed. Soft daylight and a short shadow."' \
  -F 'model="doubao-seedance-2-0-mini"' \
  -F 'seconds="15"' \
  -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

参照画像を使用する

モデル別の長さ

モデル別の対応サイズ

承認

ボディ

レスポンス

​サポートされているモデル ID

​参照画像を使用する

​モデル別の長さ

​モデル別の対応サイズ

承認

ボディ

レスポンス

サポートされているモデル ID

参照画像を使用する

モデル別の長さ

モデル別の対応サイズ