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

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:

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.

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

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:

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

Ejemplo:

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

Ejemplos:

"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.

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.

APIs de generación de video

Recuperar un video de 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
}

Moderación de contenido

Claves API

ID de modelos compatibles

Usa imágenes de referencia

Duración por modelo

Compatibilidad de tamaños por modelo

Autorizaciones

Cuerpo

Respuesta

​ID de modelos compatibles

​Usa imágenes de referencia

​Duración por modelo

​Compatibilidad de tamaños por modelo

Autorizaciones

Cuerpo

Respuesta

ID de modelos compatibles

Usa imágenes de referencia

Duración por modelo

Compatibilidad de tamaños por modelo