建立 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。針對支援進階多參考 Prompt 的路由，請依上傳順序重複使用相同的 multipart 欄位。支援此功能時，請依上傳順序重複使用相同的 multipart 欄位。一個使用單一 input_reference 的 Mini 生產請求已於 720x1280。該檢查確認請求已完成，但未能將參考圖片的視覺效果與 Prompt 區分開來。參考圖片的視覺效果與 Prompt 區分開來。 Seedance 2.0 對 Prompt 如何將每張參考圖片與場景連結起來很敏感。請依順序提及上傳的檔案，例如 [Image 1]、[Image 2] 和 [Image 3]，然後為每張圖片指定明確的角色：

將 [Image 1] 用於主要主體、角色或產品。
將 [Image 2] 用於次要主體、道具或陪襯。
將 [Image 3] 用於背景、場景、光線或風格。

描述應保持可辨識的內容、可變更的內容、動作、鏡頭運動、視覺風格和場景。模糊的 Prompt 可能使產生的影片看起來像是未使用參考圖片，即使上傳已被接受。此 Prompt 結構比只列出圖片更可靠：

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 僅使用第五欄中的 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

使用參考圖片

依模型分類的時長

依模型支援的尺寸