> ## Documentation Index
> Fetch the complete documentation index at: https://apidoc.cometapi.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Seedance 동영상 생성
> CometAPI에서 Seedance 동영상 작업을 생성합니다. 텍스트 프롬프트(Prompt) 또는 참조 이미지를 사용하고, 길이를 선택한 뒤 정확한 WxH 출력 크기를 요청하세요.
`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 필드를 반복하세요.
단일 `input_reference`을 포함한 Mini 프로덕션 요청 하나가
`720x1280`에서 완료되었습니다. 해당 확인으로 요청 완료는 확인되었지만,
참조 이미지가 프롬프트(Prompt)에 미친 시각적 효과를 분리해 확인하지는 못했습니다.
Seedance 2.0은 프롬프트(Prompt)가 각 참조 이미지를 장면과 연결하는 방식에 민감합니다. `[Image 1]`, `[Image 2]`, `[Image 3]`처럼 업로드된 파일을 순서대로 참조한 다음 각 이미지에 명확한 역할을 지정하세요:
* 주요 피사체, 캐릭터 또는 제품에는 `[Image 1]`을 사용하세요.
* 보조 피사체, 소품 또는 동반 대상에는 `[Image 2]`을 사용하세요.
* 배경, 설정, 조명 또는 스타일에는 `[Image 3]`을 사용하세요.
계속 알아볼 수 있어야 하는 요소, 변경 가능한 요소, 동작, 카메라 움직임, 시각적 스타일 및 장면을 설명하세요. 업로드가 수락되었더라도 프롬프트(Prompt)가 모호하면 생성된 동영상이 참조 이미지를 사용하지 않은 것처럼 보일 수 있습니다.
이미지만 나열하는 것보다 다음 프롬프트(Prompt) 구조가 더 안정적입니다:
```text theme={null}
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`은 지원하지 않습니다.
한 프로덕션 점검에서 `1920x1080`에 대한 Mini 요청은 생성했습니다
`1280x720`.
대상 모델에 맞는 문서화된 `WxH` 값을 선택하세요. 정확한 `WxH` 지원은 여전히 모델에 따라 달라지므로, 문서화되지 않은 크기에 의존하기 전에 완성된 미디어를 검사하세요.
## OpenAPI
````yaml api/openapi/video/seedance/post-seedance-create.openapi.json POST /v1/videos
openapi: 3.1.0
info:
title: Seedance Video Generation API
version: 1.0.0
description: >-
Create an asynchronous ByteDance Seedance video task through CometAPI. Use
one of the five documented model IDs exactly. Seedance 2.0 Mini supports the
documented 480p and 720p WxH values, but not 1080p or 4K. Save the returned
id and poll GET /v1/videos/{id} until the status reaches completed.
servers:
- url: https://api.cometapi.com
security:
- bearerAuth: []
paths:
/v1/videos:
post:
summary: Create a Seedance video task
description: >-
Submit a Seedance video task as multipart/form-data. Seedance 2.0,
Seedance 2.0 Fast, and Seedance 2.0 Mini accept input_reference;
Seedance 1.0 Pro and 1.5 Pro accept text prompts only. For multiple
reference images on a route that supports them, repeat input_reference
in upload order and describe each image's role in the prompt. The
endpoint returns a task id; use GET /v1/videos/{id} to read the final
result.
operationId: seedance_create_video
requestBody:
required: true
content:
multipart/form-data:
schema:
type: object
required:
- prompt
- model
properties:
prompt:
type: string
description: >-
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.
example: >-
A slow cinematic camera push across a coastal landscape at
sunrise.
model:
type: string
description: >-
Seedance model ID. Use one of the exact values below.
Aliases such as seedance-mini are not accepted.
enum:
- doubao-seedance-2-0
- doubao-seedance-2-0-fast
- doubao-seedance-2-0-mini
- doubao-seedance-1-5-pro
- doubao-seedance-1-0-pro
example: doubao-seedance-2-0-mini
seconds:
type: integer
description: >-
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.
minimum: 2
maximum: 15
default: 5
example: 5
size:
type: string
description: >-
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}$
examples:
- 864x496
- 752x560
- 640x640
- 560x752
- 496x864
- 992x432
- 1280x720
- 1112x834
- 960x960
- 834x1112
- 720x1280
- 1470x630
- 1920x1080
- 1080x1920
- 3840x2160
- 3326x2494
- 2880x2880
- 2494x3326
- 2160x3840
- 4398x1886
example: 1280x720
input_reference:
type: string
format: binary
description: >-
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.
encoding:
input_reference:
contentType: image/jpeg, image/png, image/webp
examples:
seedance_2_0_mini_text_to_video:
summary: Seedance 2.0 Mini text-to-video
value:
prompt: >-
A matte red cube rotates slowly on a clean white studio
floor. The camera remains fixed. Soft daylight and a short
shadow.
model: doubao-seedance-2-0-mini
seconds: 15
size: 1280x720
responses:
'200':
description: Task created. Save the returned id and poll GET /v1/videos/{id}.
content:
application/json:
schema:
$ref: '#/components/schemas/CreateVideoResponse'
example:
id: task_abc123
task_id: task_abc123
object: video
model: doubao-seedance-2-0-mini
status: queued
progress: 0
created_at: 1776681149
'400':
description: >-
The request is missing a required field or contains an out-of-range
value.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
examples:
missing_prompt:
summary: prompt field missing
value:
code: invalid_request
message: prompt is required
missing_model:
summary: model field missing
value:
error:
code: ''
message: model name is required
type: comet_api_error
invalid_duration:
summary: seconds outside the per-model range
value:
code: InvalidParameter
message: >-
the parameter duration specified in the request is not
valid
i2v_not_supported:
summary: input_reference sent with a 1.0 Pro or 1.5 Pro model
value:
code: InvalidParameter
message: >-
The parameter task_type specified in the request is not
valid: the specified task_type r2v does not support model
seedance-1-5-pro
'401':
description: The API key is missing or invalid.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
examples:
invalid_token:
summary: Bearer token rejected
value:
error:
code: ''
message: invalid token
type: comet_api_error
x-codeSamples:
- lang: Shell
label: Text-to-video (Seedance 2.0 Mini, exact 1280x720)
source: |-
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"'
- lang: Python
label: Text-to-video (Seedance 2.0 Mini, exact 1280x720)
source: |
import os
import requests
response = requests.post(
"https://api.cometapi.com/v1/videos",
headers={"Authorization": "Bearer " + os.environ["COMETAPI_KEY"]},
data={
"prompt": "A matte red cube rotates slowly on a clean white studio floor. The camera remains fixed. Soft daylight and a short shadow.",
"model": "doubao-seedance-2-0-mini",
"seconds": "15",
"size": "1280x720",
},
timeout=30,
)
response.raise_for_status()
print(response.json())
- lang: JavaScript
label: Text-to-video (Seedance 2.0 Mini, exact 1280x720)
source: >
const form = new FormData();
form.append("prompt", "A matte red cube rotates slowly on a clean
white studio floor. The camera remains fixed. Soft daylight and a
short shadow.");
form.append("model", "doubao-seedance-2-0-mini");
form.append("seconds", "15");
form.append("size", "1280x720");
const response = await fetch("https://api.cometapi.com/v1/videos", {
method: "POST",
headers: { Authorization: `Bearer ${process.env.COMETAPI_KEY}` },
body: form,
});
const result = await response.json();
console.log(result);
- lang: Shell
label: Single reference image (Seedance 2.0)
source: |-
curl https://api.cometapi.com/v1/videos \
-H "Authorization: Bearer $COMETAPI_KEY" \
-F 'prompt="Use [Image 1] as the main visual reference. Preserve the subject identity, clothing colors, and overall composition from [Image 1]. Create a 4-second video with a gentle camera push-in, subtle natural motion, warm daylight, and a realistic cinematic style."' \
-F 'model="doubao-seedance-2-0"' \
-F 'seconds="4"' \
-F 'size="720x1280"' \
-F 'input_reference=@"/path/to/reference.png"'
- lang: Python
label: Single reference image (Seedance 2.0)
source: >
import os
import requests
prompt = "Use [Image 1] as the main visual reference. Preserve the
subject identity, clothing colors, and overall composition from
[Image 1]. Create a 4-second video with a gentle camera push-in,
subtle natural motion, warm daylight, and a realistic cinematic
style."
with open("/path/to/reference.png", "rb") as image:
response = requests.post(
"https://api.cometapi.com/v1/videos",
headers={"Authorization": "Bearer " + os.environ["COMETAPI_KEY"]},
data={
"prompt": prompt,
"model": "doubao-seedance-2-0",
"seconds": "4",
"size": "720x1280",
},
files=[("input_reference", ("reference.png", image, "image/png"))],
timeout=30,
)
response.raise_for_status()
print(response.json())
- lang: JavaScript
label: Single reference image (Seedance 2.0)
source: >
import { readFile } from "node:fs/promises";
const prompt = "Use [Image 1] as the main visual reference. Preserve
the subject identity, clothing colors, and overall composition from
[Image 1]. Create a 4-second video with a gentle camera push-in,
subtle natural motion, warm daylight, and a realistic cinematic
style.";
const image = await readFile("/path/to/reference.png");
const form = new FormData();
form.append("prompt", prompt);
form.append("model", "doubao-seedance-2-0");
form.append("seconds", "4");
form.append("size", "720x1280");
form.append("input_reference", new Blob([image], { type: "image/png"
}), "reference.png");
const response = await fetch("https://api.cometapi.com/v1/videos", {
method: "POST",
headers: { Authorization: `Bearer ${process.env.COMETAPI_KEY}` },
body: form,
});
const result = await response.json();
console.log(result);
- lang: Shell
label: Multiple reference images (Seedance 2.0)
source: |-
curl https://api.cometapi.com/v1/videos \
-H "Authorization: Bearer $COMETAPI_KEY" \
-F '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."' \
-F 'model="doubao-seedance-2-0"' \
-F 'seconds="4"' \
-F 'size="720x1280"' \
-F 'input_reference=@"/path/to/seelite_ref_1.png"' \
-F 'input_reference=@"/path/to/seelite_ref_2.png"' \
-F 'input_reference=@"/path/to/seelite_ref_3.png"'
- lang: Python
label: Multiple reference images (Seedance 2.0)
source: >
import os
import requests
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."
with open("/path/to/seelite_ref_1.png", "rb") as image_1,
open("/path/to/seelite_ref_2.png", "rb") as image_2,
open("/path/to/seelite_ref_3.png", "rb") as image_3:
response = requests.post(
"https://api.cometapi.com/v1/videos",
headers={"Authorization": "Bearer " + os.environ["COMETAPI_KEY"]},
data={
"prompt": prompt,
"model": "doubao-seedance-2-0",
"seconds": "4",
"size": "720x1280",
},
files=[
("input_reference", ("seelite_ref_1.png", image_1, "image/png")),
("input_reference", ("seelite_ref_2.png", image_2, "image/png")),
("input_reference", ("seelite_ref_3.png", image_3, "image/png")),
],
timeout=30,
)
response.raise_for_status()
print(response.json())
- lang: JavaScript
label: Multiple reference images (Seedance 2.0)
source: >
import { readFile } from "node:fs/promises";
const 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.";
const image1 = await readFile("/path/to/seelite_ref_1.png");
const image2 = await readFile("/path/to/seelite_ref_2.png");
const image3 = await readFile("/path/to/seelite_ref_3.png");
const form = new FormData();
form.append("prompt", prompt);
form.append("model", "doubao-seedance-2-0");
form.append("seconds", "4");
form.append("size", "720x1280");
form.append("input_reference", new Blob([image1], { type:
"image/png" }), "seelite_ref_1.png");
form.append("input_reference", new Blob([image2], { type:
"image/png" }), "seelite_ref_2.png");
form.append("input_reference", new Blob([image3], { type:
"image/png" }), "seelite_ref_3.png");
const response = await fetch("https://api.cometapi.com/v1/videos", {
method: "POST",
headers: { Authorization: `Bearer ${process.env.COMETAPI_KEY}` },
body: form,
});
const result = await response.json();
console.log(result);
- lang: Shell
label: Text-to-video (exact 1920x1080)
source: |-
curl https://api.cometapi.com/v1/videos \
-H "Authorization: Bearer $COMETAPI_KEY" \
-F 'prompt="A slow cinematic camera push across a coastal landscape at sunrise"' \
-F 'model="doubao-seedance-1-5-pro"' \
-F 'seconds="4"' \
-F 'size="1920x1080"'
- lang: Python
label: Text-to-video (exact 1920x1080)
source: |
import os
import requests
response = requests.post(
"https://api.cometapi.com/v1/videos",
headers={"Authorization": "Bearer " + os.environ["COMETAPI_KEY"]},
data={
"prompt": "A slow cinematic camera push across a coastal landscape at sunrise",
"model": "doubao-seedance-2-0",
"seconds": "4",
"size": "1920x1080",
},
timeout=30,
)
response.raise_for_status()
print(response.json())
- lang: JavaScript
label: Text-to-video (exact 1920x1080)
source: >
const form = new FormData();
form.append("prompt", "A slow cinematic camera push across a coastal
landscape at sunrise");
form.append("model", "doubao-seedance-1-5-pro");
form.append("seconds", "4");
form.append("size", "1920x1080");
const response = await fetch("https://api.cometapi.com/v1/videos", {
method: "POST",
headers: { Authorization: `Bearer ${process.env.COMETAPI_KEY}` },
body: form,
});
const result = await response.json();
console.log(result);
components:
schemas:
CreateVideoResponse:
type: object
required:
- id
- object
- model
- status
- progress
- created_at
properties:
id:
type: string
description: Task id. Use it as the path parameter for GET /v1/videos/{id}.
task_id:
type: string
description: Alias of id returned for compatibility. The value matches id.
object:
type: string
description: Object type, always video.
model:
type: string
description: Echo of the requested model id.
status:
type: string
description: Initial task status. Newly created tasks are returned as queued.
enum:
- queued
- in_progress
- completed
- failed
- error
progress:
type: integer
minimum: 0
maximum: 100
description: Completion percentage. 0 at creation.
created_at:
type: integer
description: Task creation time as a Unix timestamp in seconds.
additionalProperties: true
ErrorResponse:
description: >-
Error body. The endpoint returns one of two shapes depending on where
the validation fails.
oneOf:
- type: object
properties:
code:
type:
- string
- 'null'
description: Short error code such as invalid_request or InvalidParameter.
message:
type: string
description: Human-readable error message.
required:
- message
additionalProperties: true
- type: object
properties:
error:
type: object
properties:
code:
type:
- string
- 'null'
message:
type: string
type:
type: string
description: Error category, for example comet_api_error.
required:
- message
- type
additionalProperties: true
required:
- error
additionalProperties: true
securitySchemes:
bearerAuth:
type: http
scheme: bearer
description: Bearer token authentication. Use your CometAPI key.
````