Crear un vídeo de 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
}

Establece size en un valor WxH de la tabla de tamaños para tu modelo.

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

Elige un modelo para tu modo de entrada y resolución, y luego envía su ID exacto en el campo model.

Modelo	ID exacto del modelo	Modos y niveles de resolución	Compatible `seconds`
Seedance 2.5	`seedance-2-5`	Texto a vídeo, medios de referencia; `480p`, `720p`	`4`-`30`
Seedance 2.0	`doubao-seedance-2-0`	Texto a vídeo, medios de referencia; `480p`, `720p`, `1080p`, `4K`	`4`-`15`
Seedance 2.0 Fast	`doubao-seedance-2-0-fast`	Texto a vídeo, medios de referencia; `480p`, `720p`	`4`-`15`
Seedance 2.0 Mini	`doubao-seedance-2-0-mini`	Texto a vídeo, medios de referencia; `480p`, `720p`	`4`-`15`
Seedance 1.5 Pro	`doubao-seedance-1-5-pro`	Texto a vídeo, imagen a vídeo; `480p`, `720p`, `1080p`	`4`-`12`
Seedance 1.0 Pro	`doubao-seedance-1-0-pro`	Texto a vídeo, imagen a vídeo; `480p`, `720p`, `1080p`	`2`-`10`

Usa imágenes de referencia

Envía POST /v1/videos como multipart/form-data, con las imágenes de referencia en input_reference. Para varias imágenes, repite el campo en el orden de las imágenes, con una URL HTTPS de imagen accesible públicamente o un archivo de imagen cargado por campo. Usa solo URL o solo archivos en este campo. Envía cada URL por separado en lugar de unirlas con comas. Mantén cada imagen cargada en un tamaño de hasta 20 MiB (20 × 1024 × 1024 bytes). Seedance 1.0 Pro y 1.5 Pro usan una imagen de referencia. Seedance 2.0, Fast y Mini aceptan hasta 9 imágenes de referencia. Seedance 2.5 acepta hasta 30 imágenes de referencia. Estos límites se aplican tanto a las URL como a los archivos cargados. En el Prompt, asigna a cada imagen una función, como el sujeto, el entorno o el estilo visual. Describe la apariencia que deseas conservar, la acción y el movimiento de cámara. Los ejemplos de solicitudes de la parte superior de esta página muestran entradas de URL de imágenes y cargas de una o varias imágenes.

Envía URL de imágenes de referencia

Usa dos URL de imágenes para guiar la apariencia del sujeto y el entorno:

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'

Usa video y audio de referencia

Seedance 2.0, Fast, Mini y 2.5 aceptan reference_videos y reference_audios. Usa archivos MP4 para las referencias de video y archivos MP3 para las referencias de audio. Envía cada uno como una URL HTTPS de acceso público o como un archivo cargado. Combina el audio de referencia con al menos una imagen o un video. En el prompt, usa @Image1, @Video1 y @Audio1 para asignar roles a tus referencias. Numera las referencias según su orden dentro de cada tipo de medio. Puedes combinar URL y archivos cargados entre distintos campos. En cada uno de input_reference, reference_videos y reference_audios, usa solo URL o solo archivos. Para varias entradas, repite el campo una vez por cada entrada en lugar de unir las URL con comas.

Familia de modelos	Imágenes de referencia	Videos de referencia	Audio de referencia	Total de entradas de referencia
Seedance 2.0, Fast y Mini	Hasta 9 URL o archivos en `input_reference`	Hasta 3	Hasta 3	Hasta 12
Seedance 2.5	Hasta 30 URL o archivos en `input_reference`	Hasta 10 URL o 5 archivos	Hasta 10 URL o 5 archivos	Hasta 50

Mantén cada video cargado en 50 MiB o menos y cada archivo de audio cargado en 15 MiB o menos. Un MiB equivale a 1024 × 1024 bytes. Seedance 2.0 estándar (doubao-seedance-2-0) tiene límites de medios adicionales tanto para URL como para archivos cargados. Para los videos de referencia, mantén la duración combinada entre 2 y 15 segundos y el tamaño total por debajo de 50 MB. Usa una resolución de video de referencia de aproximadamente 480p (640x640) a 720p (834x1112). Para el audio de referencia, mantén la duración combinada en 15 segundos o menos y cada archivo en 15 MB o menos. Los medios cargados también deben cumplir los límites de carga por archivo indicados anteriormente.

Envía una URL de video de referencia

Usa el video de referencia para guiar el movimiento de cámara y la acción:

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'

Combina una URL de imagen con audio

Anima el sujeto de referencia al ritmo del audio de referencia:

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'

Carga medios de referencia con Seedance 2.5

Carga dos imágenes, un video MP4 y un archivo de audio MP3 en una sola solicitud:

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'

Duración por modelo

Establezca seconds en un valor entero dentro del rango de su modelo. Si lo omite, CometAPI solicita un clip de 5 segundos.

Familia de modelos	Compatible `seconds`	Predeterminado	Comportamiento en los límites
Seedance 2.5	`4`-`30`	`5`	Use segundos enteros dentro del rango.
Seedance 2.0, Seedance 2.0 Fast y Seedance 2.0 Mini	`4`-`15`	`5`	Use segundos enteros dentro del rango.
Seedance 1.5 Pro	`4`-`12`	`5`	Use segundos enteros dentro del rango.
Seedance 1.0 Pro	`2`-`10`	`5`	Use segundos enteros dentro del rango.

Compatibilidad de tamaños por modelo

Seedance 2.5

Para Seedance 2.5, estos valores de WxH se aplican tanto a los prompts de texto como a los medios de referencia.

Clase de resolución	`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`

Modelos Seedance anteriores

La columna final agrupa los valores exactos de WxH para Seedance 1.5 Pro, Seedance 2.0 estándar y Fast. Seedance 2.0 Fast usa únicamente los valores 480p y 720p de esa columna. Los valores de 1080p de esa columna se aplican a Seedance 1.5 Pro y Seedance 2.0 estándar. Los valores de 4K se aplican únicamente 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. Establezca size en un valor WxH de la columna Mini.

Autorizaciones

Authorization

string

header

requerido

Bearer token authentication. Use your CometAPI key.

Cuerpo

multipart/form-data

prompt

string

requerido

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.

Ejemplo:

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

model

enum<string>

requerido

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

Opciones disponibles:

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

Ejemplo:

"doubao-seedance-2-0-mini"

seconds

integer

predeterminado: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.

Rango requerido: 2 <= x <= 30

Ejemplo:

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}$

Ejemplos:

"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://

Ejemplo:

"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://

Ejemplo:

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

Respuesta

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

string

requerido

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

object

string

requerido

Object type, always video.

model

string

requerido

Echo of the requested model id.

status

enum<string>

requerido

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

Opciones disponibles:

queued,

in_progress,

completed,

failed,

error

progress

integer

requerido

Completion percentage. 0 at creation.

Rango requerido: 0 <= x <= 100

created_at

integer

requerido

Task creation time as a Unix timestamp in seconds.

task_id

string

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

Última modificación el 9 de septiembre de 2026

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
}

Moderación de contenido

Claves API

ID de modelos compatibles

Usa imágenes de referencia

Envía URL de imágenes de referencia

Usa video y audio de referencia

Envía una URL de video de referencia

Combina una URL de imagen con audio

Carga medios de referencia con Seedance 2.5

Duración por modelo

Compatibilidad de tamaños por modelo

Seedance 2.5

Modelos Seedance anteriores

Autorizaciones

Cuerpo

Respuesta

​ID de modelos compatibles

​Usa imágenes de referencia

​Envía URL de imágenes de referencia

​Usa video y audio de referencia

​Envía una URL de video de referencia

​Combina una URL de imagen con audio

​Carga medios de referencia con Seedance 2.5

​Duración por modelo

​Compatibilidad de tamaños por modelo

​Seedance 2.5

​Modelos Seedance anteriores

Autorizaciones

Cuerpo

Respuesta

ID de modelos compatibles

Usa imágenes de referencia

Envía URL de imágenes de referencia

Usa video y audio de referencia

Envía una URL de video de referencia

Combina una URL de imagen con audio

Carga medios de referencia con Seedance 2.5

Duración por modelo

Compatibilidad de tamaños por modelo

Seedance 2.5

Modelos Seedance anteriores