curl --request POST \
  --url https://api.evolink.ai/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "seedance-2.5-text-to-video",
  "prompt": "A macro lens focuses on a green glass frog on a leaf. The focus gradually shifts from its smooth skin to its completely transparent abdomen, where a bright red heart is beating powerfully and rhythmically.",
  "duration": 8,
  "quality": "720p",
  "aspect_ratio": "16:9",
  "generate_audio": true,
  "content_filter": true
}
'

{
  "created": 1761313744,
  "id": "task-unified-1774857405-abc123",
  "model": "seedance-2.5-text-to-video",
  "object": "video.generation.task",
  "progress": 0,
  "status": "pending",
  "task_info": {
    "can_cancel": false,
    "estimated_time": 165,
    "video_duration": 8
  },
  "type": "video",
  "usage": {
    "billing_rule": "per_second",
    "credits_reserved": 50,
    "user_group": "default"
  }
}

{
  "error": {
    "code": "invalid_parameter",
    "message": "Invalid request parameters",
    "type": "invalid_request_error"
  }
}

{
  "error": {
    "code": "unauthorized",
    "message": "Invalid or expired token",
    "type": "authentication_error"
  }
}

{
  "error": {
    "code": "insufficient_quota",
    "message": "Insufficient quota. Please top up your account.",
    "type": "insufficient_quota"
  }
}

{
  "error": {
    "code": "model_access_denied",
    "message": "Token does not have access to model: seedance-2.5-reference-to-video",
    "type": "invalid_request_error"
  }
}

{
  "error": {
    "code": "rate_limit_exceeded",
    "message": "Too many requests, please try again later",
    "type": "rate_limit_error"
  }
}

{
  "error": {
    "code": "internal_error",
    "message": "Internal server error",
    "type": "api_error"
  }
}

{
  "error": {
    "code": "draft_unavailable",
    "message": "Draft mode is not available on the selected service right now. Retry later or send the request without draft.",
    "type": "invalid_request_error"
  }
}

Seedance 2.5

Seedance 2.5 Guía completa de parámetros

Interfaz unificada de la serie completa Seedance 2.5, seleccione el modelo especifico mediante el parametro model

5 modos de generacion:

Text-to-Video: genera video a partir de descripcion de texto puro, admite busqueda web para mejorar los resultados
Image-to-Video: 1-2 imagenes como primer y ultimo fotograma para impulsar la generacion de video
Reference-to-Video: referencia mixta multimodal con imagenes, videos y audio
Video Edit: edita un video de entrada para reemplazar sujetos, agregar o quitar objetos y reestilizar regiones
Video Extend: extiende un video de entrada hacia adelante o hacia atras

Modo borrador:

Envíe draft: true en cualquiera de los modos de generación para obtener un borrador en 480p más rápidamente, con la tarifa normal de 480p
Si le convence, use Seedance 2.5 Draft-to-Video para obtener un video final en 1080p con el mismo contenido. Ambas generaciones se facturan por separado; puede optar por no convertir el borrador
La conversión reutiliza los parámetros de generación del borrador. Los campos model y source_task_id son obligatorios; output_format y callback_url son opcionales. Consulte esa página para ver todos los parámetros y las reglas de facturación
Ahora compatible con materiales realistas de personas generados por IA (AIGC)
Modo de procesamiento asincrono, utilice el ID de tarea devuelto para consultar
El enlace del video generado es valido por 24 horas, guardelo lo antes posible

POST

videos

generations

curl --request POST \
  --url https://api.evolink.ai/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "seedance-2.5-text-to-video",
  "prompt": "A macro lens focuses on a green glass frog on a leaf. The focus gradually shifts from its smooth skin to its completely transparent abdomen, where a bright red heart is beating powerfully and rhythmically.",
  "duration": 8,
  "quality": "720p",
  "aspect_ratio": "16:9",
  "generate_audio": true,
  "content_filter": true
}
'

{
  "created": 1761313744,
  "id": "task-unified-1774857405-abc123",
  "model": "seedance-2.5-text-to-video",
  "object": "video.generation.task",
  "progress": 0,
  "status": "pending",
  "task_info": {
    "can_cancel": false,
    "estimated_time": 165,
    "video_duration": 8
  },
  "type": "video",
  "usage": {
    "billing_rule": "per_second",
    "credits_reserved": 50,
    "user_group": "default"
  }
}

{
  "error": {
    "code": "invalid_parameter",
    "message": "Invalid request parameters",
    "type": "invalid_request_error"
  }
}

{
  "error": {
    "code": "unauthorized",
    "message": "Invalid or expired token",
    "type": "authentication_error"
  }
}

{
  "error": {
    "code": "insufficient_quota",
    "message": "Insufficient quota. Please top up your account.",
    "type": "insufficient_quota"
  }
}

{
  "error": {
    "code": "model_access_denied",
    "message": "Token does not have access to model: seedance-2.5-reference-to-video",
    "type": "invalid_request_error"
  }
}

{
  "error": {
    "code": "rate_limit_exceeded",
    "message": "Too many requests, please try again later",
    "type": "rate_limit_error"
  }
}

{
  "error": {
    "code": "internal_error",
    "message": "Internal server error",
    "type": "api_error"
  }
}

{
  "error": {
    "code": "draft_unavailable",
    "message": "Draft mode is not available on the selected service right now. Retry later or send the request without draft.",
    "type": "invalid_request_error"
  }
}

Autorizaciones

Authorization

string

header

requerido

##Todas las interfaces requieren autenticacion mediante Bearer Token##

Obtener API Key:

Visite la Pagina de gestion de API Key para obtener su API Key

Agregue en el encabezado de la solicitud al usar:

Authorization: Bearer YOUR_API_KEY

Cuerpo

application/json

model

enum<string>

requerido

Nombre del modelo de generacion de video

ID del modelo	Modo	Materiales de entrada
`seedance-2.5-text-to-video`	Text-to-Video	`prompt`
`seedance-2.5-image-to-video`	Image-to-Video	`prompt` + `image_urls`
`seedance-2.5-reference-to-video`	Reference-to-Video	`prompt` + `image_urls` / `video_urls` / `audio_urls`
`seedance-2.5-video-edit`	Video Edit	`prompt` + `video_urls`
`seedance-2.5-video-extend`	Video Extend	`prompt` + `video_urls`

Opciones disponibles:

seedance-2.5-text-to-video,

seedance-2.5-image-to-video,

seedance-2.5-reference-to-video,

seedance-2.5-video-edit,

seedance-2.5-video-extend

Ejemplo:

"seedance-2.5-text-to-video"

prompt

string

requerido

Indicacion de texto que describe el video deseado. Admite chino e ingles, se recomienda no exceder 500 caracteres en chino y 1000 palabras en ingles. Longitud maxima del prompt: 10000 tokens

Uso del prompt segun el modelo:

Text-to-Video: descripcion de texto puro, no admite el uso de image_urls, video_urls, audio_urls en el prompt
Image-to-Video: descripcion de texto puro, no admite el uso de video_urls, audio_urls en el prompt
Reference-to-Video: Al hacer referencia a materiales de entrada, use preferentemente etiquetas explicitas como @image1, @video1 y @audio1. La numeracion sigue el orden del array de URL correspondiente y empieza en 1. La numeracion en lenguaje natural puede seguir siendo reconocida, pero las etiquetas explicitas establecen una correspondencia mas clara entre cada material y su uso
Video Edit: debe expresar la intencion de edicion y usar @video1, @image1 para indicar el proposito de cada material
Video Extend: debe indicar la direccion de la extension (hacia adelante / hacia atras) y usar @video1 para senalar el video que se extiende

Evite la intencion de edicion / extension en los prompts de Reference-to-Video (editar el video, anadir, eliminar / quitar, cambiar / reemplazar, extender hacia adelante / hacia atras, continuar): con esas expresiones la solicitud se valida como Video Edit / Video Extend, por lo que un aspect_ratio distinto de adaptive (o un duration distinto de -1 en tareas de edicion) hace que la tarea falle mas tarde, sin error al enviarla. Para esos casos, cambie model directamente a seedance-2.5-video-edit / seedance-2.5-video-extend

Ejemplo:

"Use the first-person perspective framing of @video1 throughout, and use @audio1 as background music throughout. First-person perspective fruit tea promotional video..."

image_urls

string<uri>[]

Array de URLs de imagenes

Modelos aplicables y limites de cantidad:

Text-to-Video: No admitido
Image-to-Video: Obligatorio, 1-2 imagenes
Reference-to-Video: Opcional, 1-30 imagenes
Video Edit: Opcional, 1-30 imagenes
Video Extend: Opcional, 1-30 imagenes

Comportamiento de imagenes en Image-to-Video:

Cantidad de imagenes	Comportamiento	Rol
1 imagen	Imagen a video con primer fotograma	Se establece automaticamente como `first_frame`
2 imagenes	Imagen a video con primer y ultimo fotograma	1ra imagen -> `first_frame`, 2da imagen -> `last_frame`

Rol de imagenes en Reference-to-Video:

Referencia de estilo, imagen de producto, apariencia de personaje, primer/ultimo fotograma (especificado mediante prompt)

Relacion obligatoria: Debe proporcionar al menos uno de image_urls, video_urls o audio_urls.

Requisitos de imagen:

Formatos admitidos: .jpeg, .png, .webp
Relacion de aspecto (ancho/alto): 0.4 ~ 2.5
Pixeles de ancho/alto: 300 ~ 6000 px
Tamano por imagen: no mas de 30MB
El tamano total del cuerpo de la solicitud no debe exceder 64MB
Al proporcionar primer y ultimo fotograma, ambas imagenes pueden ser iguales. Si la relacion de aspecto no coincide, se toma el primer fotograma como referencia y el ultimo se recorta automaticamente
Las URLs de imagenes deben ser accesibles directamente por el servidor

Required array length: 1 - 30 elements

Ejemplo:

[
  "https://example.com/ref1.jpg",
  "https://example.com/ref2.jpg"
]

video_urls

string<uri>[]

Array de URLs de videos de referencia, opcional; si se proporciona, debe contener de 1 a 10 videos

Se aplica a los modelos Reference-to-Video, Video Edit y Video Extend; los demas modelos no admiten este parametro

Obligatorio para Video Edit / Video Extend: al menos 1 video, siendo el primero el que se va a editar o extender.

Relacion obligatoria: Debe proporcionar al menos uno de image_urls, video_urls o audio_urls.

Descripcion del rol:

Tipo de medio	Rol	Uso tipico
Video	`reference_video`	Referencia de movimiento de camara, referencia de accion, video original para editar/extender

Requisitos de video:

Formatos admitidos: .mp4, .mov
Resolucion: 480p, 720p, 1080p, 4K
Duracion por video: 2 ~ 30 segundos, maximo 10, duracion total de todos los videos <= 30 segundos
Relacion de aspecto (ancho/alto): 0.4 ~ 2.5
Pixeles de ancho/alto: 300 ~ 6000 px
Pixeles de imagen (ancho x alto): 409,600 ~ 8,295,044 (ej. 640x640 ~ 3326x2494)
Tamano por archivo: no mas de 200MB
Velocidad de fotogramas: 24 ~ 60 FPS
El tamano total del cuerpo de la solicitud no debe exceder 64MB, no use codificacion Base64
La validez del codec, la resolucion y otros detalles del material se comprueba adicionalmente por el modelo
El uso de referencia de video aumentara los costos (la duracion del video de entrada se incluye en la facturacion)
Las URLs de video deben ser accesibles directamente por el servidor

Required array length: 1 - 10 elements

Ejemplo:

["https://example.com/reference.mp4"]

audio_urls

string<uri>[]

Array de URLs de audio de referencia, opcional; si se proporciona, debe contener de 1 a 10 segmentos

Se aplica a los modelos Reference-to-Video, Video Edit y Video Extend; los demas modelos no admiten este parametro

Relacion obligatoria: Debe proporcionar al menos uno de image_urls, video_urls o audio_urls.

Descripcion del rol:

Tipo de medio	Rol	Uso tipico
Audio	`reference_audio`	Musica de fondo, efectos de sonido, referencia de voz/dialogos

Requisitos de audio:

Formatos admitidos: .wav, .mp3
Duracion por segmento de audio: 2 ~ 30 segundos, maximo 10 segmentos, duracion total de todo el audio <= 30 segundos
Tamano por archivo: no mas de 15MB
El tamano total del cuerpo de la solicitud no debe exceder 64MB, no use codificacion Base64
Las URLs de audio deben ser accesibles directamente por el servidor

Required array length: 1 - 10 elements

Ejemplo:

["https://example.com/bgm.mp3"]

duration

integer

predeterminado:5

Duracion del video de salida (segundos), valor predeterminado 5 segundos

Descripcion:

Admite cualquier valor entero entre 4 y 30 segundos
-1: duracion automatica, el modelo elige una duracion entre 4 y 30 segundos y la facturacion sigue la duracion real de salida
La duracion esta directamente relacionada con la facturacion
Video Edit solo admite -1: la duracion de salida sigue al video de entrada y no se puede personalizar

Aplicable a los 5 modelos

Ejemplo:

10

quality

enum<string>

predeterminado:720p

Resolucion del video, valor predeterminado 720p

Valores opcionales:

480p: menor claridad, precio mas bajo
720p: claridad estandar, este es el valor predeterminado
1080p: claridad Ultra HD

Aplicable a los 5 modelos

Modo borrador: cuando draft es true, solo se permite 480p. Si se omite quality, se utiliza 480p automáticamente

Opciones disponibles:

480p,

720p,

1080p

Ejemplo:

"720p"

draft

boolean

predeterminado:false

Activa el modo borrador; el valor predeterminado es false

Detalles:

true: genera primero un borrador en 480p, más rápidamente, con la tarifa normal de 480p
Cuando está activado, quality debe ser 480p o debe omitirse. Cualquier otra resolución devuelve un error de parámetro 400
Solo se admite en el nivel superior del cuerpo de la solicitud. Incluirlo en model_params devuelve un error de parámetro 400

Conversión en video final:

Una vez completado el borrador, la consulta de la tarea devuelve draft_expires_at
Antes de esa fecha, envíe el ID de tarea del borrador a Seedance 2.5 Draft-to-Video para generar un video final en 1080p con el mismo contenido
El video final y el borrador se facturan por separado. Si el borrador no le convence, puede omitir la conversión y pagar solo el borrador
El período de validez predeterminado es de 24 horas desde que se completa el borrador; draft_expires_at indica la fecha límite real. Envíe la solicitud de conversión con antelación: si el borrador caduca mientras la tarea espera en la cola, la conversión también fallará

Indisponibilidad temporal: el servicio puede devolver 503 cuando no está disponible temporalmente. Si el código de error es draft_unavailable, reintente más tarde o retire draft para generar en el modo normal

Ejemplo:

false

aspect_ratio

enum<string>

predeterminado:adaptive

Relacion de aspecto del video, valor predeterminado adaptive

Valores opcionales:

16:9 (horizontal), 9:16 (vertical), 1:1 (cuadrado), 4:3, 3:4, 21:9 (ultra ancho)
adaptive: selecciona automaticamente la mejor proporcion

Comportamiento de adaptive segun el modelo:

Text-to-Video: selecciona automaticamente segun el contenido de la indicacion
Image-to-Video: se adapta automaticamente segun la relacion de aspecto de la imagen del primer fotograma (este modelo solo admite adaptive, no se pueden especificar relaciones fijas)
Reference-to-Video: prioridad: proporcion del material de video > proporcion del material de imagen > inferencia de la indicacion
Video Edit / Video Extend: sigue la relacion del primer video de entrada (ambos modelos solo admiten adaptive)

Valores de pixeles por resolucion:

Relacion de aspecto	480p	720p	1080p
16:9	854×480	1280×720	1920×1080
4:3	752×560	1112×834	1664×1248
1:1	640×640	960×960	1440×1440
3:4	560×752	834×1112	1248×1664
9:16	480×854	720×1280	1080×1920
21:9	992×432	1470×630	2206×946

Aplicable a los 5 modelos (Image-to-Video / Video Edit / Video Extend solo acepta adaptive)

Opciones disponibles:

16:9,

9:16,

1:1,

4:3,

3:4,

21:9,

adaptive

Ejemplo:

"16:9"

generate_audio

boolean

predeterminado:true

Si se genera audio sincronizado, valor predeterminado true

true: el video incluye audio sincronizado (voz, efectos de sonido, musica de fondo), sin cargo adicional
false: salida de video sin audio

Aplicable a los 5 modelos

Ejemplo:

true

content_filter

boolean

predeterminado:true

Filtro de contenido, valor predeterminado true

Valores opcionales:

true: verificacion estandar de seguridad de contenido, este es el valor predeterminado
false: relaja las restricciones de contenido, facturado con +10% (1.1x). El contenido ilegal y prohibido siempre se aplica independientemente de esta configuracion

Incompatible con la busqueda web:

content_filter: false y model_params.web_search: true no se pueden usar juntos; enviarlos a la vez devuelve un error de parametro 400
Mantenga content_filter: true (valor predeterminado) cuando necesite la busqueda web

Ejemplo:

true

output_format

enum<string>

predeterminado:mp4

Formato de contenedor de salida, valor predeterminado mp4

Valores opcionales:

mp4: codificacion H.264, la mejor compatibilidad y precision de color estandar; es el valor predeterminado
mov: H.264 + submuestreo de croma yuv444p + audio PCM, con mayor fidelidad de color, recomendado para etalonaje, recorte de croma y composicion. Es posible que el navegador no lo reproduzca en linea; descarguelo y reproduzcalo con VLC / mpv / ffplay. Sin cargo adicional

Opciones disponibles:

mp4,

mov

Ejemplo:

"mp4"

model_params

object

Parametros extendidos del modelo

Solo aplicable a modelos Text-to-Video

Show child attributes

callback_url

string<uri>

Direccion de callback HTTPS despues de completar la tarea

Momento del callback:

Se activa cuando la tarea se completa (completed) o falla (failed)
Se envia despues de confirmar la facturacion

Restricciones de seguridad:

Solo admite protocolo HTTPS
Prohibido el callback a direcciones IP de red interna (127.0.0.1, 10.x.x.x, 172.16-31.x.x, 192.168.x.x, etc.)
La longitud de la URL no debe exceder 2048 caracteres

Mecanismo de callback:

Tiempo de espera: 10 segundos
Maximo 3 reintentos despues del fallo (reintentos a los 1/2/4 segundos despues del fallo)
El formato del cuerpo de respuesta del callback es consistente con el formato de retorno de la interfaz de consulta de tareas
Un codigo de estado 2xx se considera exitoso, otros codigos de estado activan reintentos

Ejemplo:

"https://your-domain.com/webhooks/video-task-completed"

Respuesta

Tarea de generacion de video creada exitosamente

created

integer

Marca de tiempo de creacion de la tarea

Ejemplo:

1761313744

string

ID de la tarea

Ejemplo:

"task-unified-1774857405-abc123"

model

string

Nombre del modelo utilizado

Ejemplo:

"seedance-2.5-text-to-video"

object

enum<string>

Tipo especifico de la tarea

Opciones disponibles:

video.generation.task

progress

integer

Porcentaje de progreso de la tarea (0-100)

Rango requerido: 0 <= x <= 100

Ejemplo:

0

status

enum<string>

Estado de la tarea

Opciones disponibles:

pending,

processing,

completed,

failed

Ejemplo:

"pending"

task_info

object

Informacion detallada de la tarea de video

Show child attributes

type

enum<string>

Tipo de salida de la tarea

Opciones disponibles:

text,

image,

audio,

video

Ejemplo:

"video"

usage

object

Informacion de uso y facturacion

Show child attributes

Serie de imágenes

Serie de videos

Serie de audio

Serie de texto

Gestión de cuenta

Gestión de tareas

Gestión de archivos

Seedance 2.5 Guía completa de parámetros

Autorizaciones

Cuerpo

Respuesta