> ## 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.
# Crear un vídeo de Seedance
> Crea una tarea de vídeo de Seedance en CometAPI. Usa Prompts de texto o imágenes de referencia, selecciona una duración y solicita un tamaño de salida exacto de WxH.
Elige un valor documentado de `WxH` de la tabla siguiente para el campo `size`.
Usa `doubao-seedance-2-0-mini` exactamente para Seedance 2.0 Mini.
El valor abreviado `seedance-mini` no es un ID de modelo válido.
## ID de modelos compatibles
Usa uno de estos valores exactos para el campo `model`.
| Modelo | ID exacto del modelo | Modos y niveles de resolución | Compatible `seconds` |
| ----------------- | -------------------------- | ------------------------------------------------------------------ | -------------------- |
| Seedance 2.0 | `doubao-seedance-2-0` | De texto a vídeo, de imagen a vídeo; `480p`, `720p`, `1080p`, `4K` | `4`-`15` |
| Seedance 2.0 Fast | `doubao-seedance-2-0-fast` | De texto a vídeo, de imagen a vídeo; `480p`, `720p` | `4`-`15` |
| Seedance 2.0 Mini | `doubao-seedance-2-0-mini` | De texto a vídeo, de imagen a vídeo; `480p`, `720p` | `4`-`15` |
| Seedance 1.5 Pro | `doubao-seedance-1-5-pro` | De texto a vídeo; `480p`, `720p`, `1080p` | `4`-`12` |
| Seedance 1.0 Pro | `doubao-seedance-1-0-pro` | De texto a vídeo; `480p`, `720p`, `1080p` | `2`-`10` |
## Usa imágenes de referencia
Seedance 2.0, Seedance 2.0 Fast y Seedance 2.0 Mini aceptan
`input_reference`. Para Prompts avanzados con varias referencias en una ruta que
los admita, repite el mismo campo multipart en el orden de carga.
Una solicitud de producción con Mini con un solo `input_reference` se completó en
`720x1280`. Esa comprobación confirmó que la solicitud se completó, pero no aisló el
efecto visual de la imagen de referencia del Prompt.
Seedance 2.0 es sensible a la forma en que el Prompt conecta cada imagen de referencia con la escena. Consulta los archivos cargados por orden, como `[Image 1]`, `[Image 2]` y `[Image 3]`, y asigna a cada imagen una función clara:
* Usa `[Image 1]` para el sujeto, personaje o producto principal.
* Usa `[Image 2]` para un sujeto, accesorio o acompañante secundario.
* Usa `[Image 3]` para el fondo, entorno, iluminación o estilo.
Describe qué debe seguir siendo reconocible, qué puede cambiar, la acción, el movimiento de cámara, el estilo visual y la escena. Un Prompt impreciso puede hacer que el vídeo generado parezca no haber usado la imagen de referencia, incluso cuando se aceptó la carga.
Esta estructura de Prompt es más fiable que limitarse a enumerar imágenes:
```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.
```
## Duración por modelo
Si omites `seconds`, CometAPI solicita un clip de 5 segundos. Envía `seconds` como una
cadena cuando necesites una duración específica.
| Familia de modelos | Compatible `seconds` | Predeterminado | Comportamiento en los límites |
| --------------------------------------------------- | -------------------- | -------------- | ------------------------------------------ |
| Seedance 2.0, Seedance 2.0 Fast y Seedance 2.0 Mini | `4`-`15` | `5` | Usa segundos enteros dentro del intervalo. |
| Seedance 1.5 Pro | `4`-`12` | `5` | Usa segundos enteros dentro del intervalo. |
| Seedance 1.0 Pro | `2`-`10` | `5` | Usa segundos enteros dentro del intervalo. |
## Compatibilidad de tamaños por modelo
La tabla siguiente reúne en un solo lugar los valores exactos de `WxH`. Seedance 2.0 Fast
solo utiliza los valores `480p` y `720p` en la quinta columna. Los valores `1080p`
de esa columna se aplican a Seedance 1.5 Pro y a Seedance 2.0 estándar. Los valores `4K`
se aplican solo a Seedance 2.0 estándar. En la columna Mini, `—` significa que la
resolución no es compatible.
| Clase de resolución | Relación de aspecto | Seedance 2.0 Mini | Serie Seedance 1.0 | Seedance 1.5 Pro / Seedance 2.0 estándar / 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` (Solo Seedance 2.0) |
| | `4:3` | — | — | `3326x2494` (Solo Seedance 2.0) |
| | `1:1` | — | — | `2880x2880` (Solo Seedance 2.0) |
| | `3:4` | — | — | `2494x3326` (Solo Seedance 2.0) |
| | `9:16` | — | — | `2160x3840` (Solo Seedance 2.0) |
| | `21:9` | — | — | `4398x1886` (Solo Seedance 2.0) |
Seedance 2.0 Mini admite `480p` y `720p`, no `1080p` ni `4K`.
En una comprobación de producción, una solicitud Mini para `1920x1080` produjo
`1280x720`.
Elige el valor documentado de `WxH` para el modelo de destino. La compatibilidad exacta con `WxH` sigue dependiendo del modelo, así que inspecciona el contenido multimedia completado antes de confiar en un tamaño no documentado.
## 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.
````