Saltar al contenido principal
POST
/
v1
/
videos
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-2-0-fast"' \
  -F 'seconds="5"' \
  -F 'size="16:9"' \
  -F 'resolution="720p"'
{
  "id": "task_abc123",
  "task_id": "task_abc123",
  "object": "video",
  "model": "doubao-seedance-2-0-fast",
  "status": "SUBMITTED",
  "progress": 0,
  "created_at": 1776681149
}
Usa este endpoint para iniciar un trabajo de video ByteDance Seedance. Todos los niveles de modelo de Seedance comparten la misma estructura de solicitud; eliges el modelo configurando el campo model. La llamada devuelve un id de tarea inmediatamente y el renderizado continúa en segundo plano.

​
Elegir un modelo

Model idNivelNotas
doubao-seedance-2-02.0Salida de mayor calidad dentro de la familia 2.0.
doubao-seedance-2-0-fast2.0Variante más rápida de 2.0 para iteración rápida y vistas previas.
doubao-seedance-1-5-pro1.5 ProCompatible con 1080p. Solo texto a video.
doubao-seedance-1-0-pro1.0 ProCompatible con 1080p y clips más cortos desde 2 segundos. Solo texto a video.
Consulta la página de modelos para ver la disponibilidad en tiempo real.

​
Rangos de parámetros

CampoTipoObligatorioPredeterminadoValores permitidos
promptstringsí—cualquier texto
modelstringsí—doubao-seedance-2-0, doubao-seedance-2-0-fast, doubao-seedance-1-5-pro, doubao-seedance-1-0-pro
secondsintegerno5depende del modelo (ver abajo)
sizestringno16:921:9, 16:9, 4:3, 1:1, 3:4, 9:16
resolutionstringno720p480p, 720p para modelos 2.0; 480p, 720p, 1080p para 1.5 Pro y 1.0 Pro
input_referencefileno—JPEG, PNG o WebP. Aceptado solo por los modelos 2.0.

​
Rango de duración por modelo

ModelRango de seconds
doubao-seedance-2-0, doubao-seedance-2-0-fast4 a 15
doubao-seedance-1-5-pro4 a 12
doubao-seedance-1-0-pro2 a 10
Enviar un valor fuera del rango del modelo devuelve HTTP 400 con code: "InvalidParameter" y un mensaje sobre duration.

​
Compatibilidad con image-to-video

Solo los modelos 2.0 aceptan un archivo input_reference. Enviar input_reference con doubao-seedance-1-5-pro o doubao-seedance-1-0-pro devuelve HTTP 400 con un mensaje con una forma como the specified task_type r2v does not support model seedance-1-5-pro. Usa esos modelos solo para text-to-video.

​
Subir una imagen de referencia

El cuerpo de la solicitud es multipart/form-data. Para ejecutar image-to-video en un modelo 2.0, adjunta la imagen como la parte input_reference en la misma solicitud: 
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-2-0"' \
  -F 'seconds="5"' \
  -F 'size="16:9"' \
  -F 'resolution="720p"' \
  -F 'input_reference=@/path/to/reference.jpg'
Reemplaza /path/to/reference.jpg con la ruta absoluta o relativa de la imagen que quieres usar como ancla del primer fotograma. Los formatos compatibles son JPEG, PNG y WebP.

​
Flujo de la tarea

1

Enviar la tarea

Envía una solicitud POST con al menos prompt y model. Guarda el id devuelto para el siguiente paso.
2

Consultar la tarea

Llama a Retrieve a Seedance video cada 10 a 20 segundos.
3

Descargar la salida

Cuando status pase a ser SUCCESS, descarga el archivo en video_url y vuelve a alojarlo si necesitas acceso a largo plazo. La URL está firmada y expira después de un período limitado.

​
Respuestas de error

El endpoint devuelve HTTP 400 cuando falta un campo obligatorio, un valor queda fuera del rango aceptado o se envía input_reference a un modelo que no es compatible con image-to-video. Devuelve HTTP 401 cuando falta el bearer token o no es válido. El cuerpo del error usa una de dos estructuras; consulta los ejemplos de 400 y 401 en el playground para ver los campos exactos.

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.

Ejemplo:

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

​
model
enum<string>
requerido

Seedance model id. Choose doubao-seedance-2-0 for the highest quality 2.0 output, doubao-seedance-2-0-fast for quick iteration on 2.0, doubao-seedance-1-5-pro for the 1.5 Pro tier, or doubao-seedance-1-0-pro for the 1.0 Pro tier. Only the two 2.0 models accept input_reference.

Opciones disponibles:
doubao-seedance-2-0,
doubao-seedance-2-0-fast,
doubao-seedance-1-5-pro,
doubao-seedance-1-0-pro
Ejemplo:

"doubao-seedance-2-0-fast"

​
seconds
integer
predeterminado:5

Video duration in seconds. The accepted range depends on the model: doubao-seedance-2-0 and doubao-seedance-2-0-fast accept 4 to 15, doubao-seedance-1-5-pro accepts 4 to 12, and doubao-seedance-1-0-pro accepts 2 to 10. The default is 5 for every model.

Rango requerido: 2 <= x <= 15
Ejemplo:

5

​
size
enum<string>
predeterminado:16:9

Output aspect ratio. All Seedance models accept the same set of values.

Opciones disponibles:
21:9,
16:9,
4:3,
1:1,
3:4,
9:16
Ejemplo:

"16:9"

​
resolution
enum<string>
predeterminado:720p

Output resolution. 480p and 720p are accepted by every model; 1080p is supported only by doubao-seedance-1-5-pro and doubao-seedance-1-0-pro.

Opciones disponibles:
480p,
720p,
1080p
Ejemplo:

"720p"

​
input_reference
file

Optional reference image. When included, the job runs in image-to-video mode and uses the image as the visual anchor. Only doubao-seedance-2-0 and doubao-seedance-2-0-fast accept this field; sending it with a 1.0 Pro or 1.5 Pro model returns HTTP 400.

Respuesta

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

​
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. A newly created task is returned as SUBMITTED.

Opciones disponibles:
SUBMITTED,
IN_PROGRESS,
SUCCESS,
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.