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-flash-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-flash-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-flash-text-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": "<string>",
    "message": "<string>",
    "type": "<string>"
  }
}

Seedance 2.5 Flash

Seedance 2.5 Flash Guía completa de parámetros

Referencia completa de parámetros de Seedance 2.5 Flash. Use model para elegir un modelo de esta carpeta. Se detallan los campos obligatorios, las entradas y la facturación por modo.

Limitación de borradores: Seedance 2.5 Flash no admite draft: true ni la conversión de borradores a video final.

Búsqueda web en Text-to-Video: model_params.web_search: true y content_filter: false son incompatibles; enviarlos juntos devuelve un error de parámetro 400. Mantenga content_filter: true (valor predeterminado) para usar la búsqueda web.

ID del modelo	Modo	Campos obligatorios (sin model)
`seedance-2.5-flash-text-to-video`	Text-to-Video	`prompt`
`seedance-2.5-flash-image-to-video`	Image-to-Video	`prompt`, `image_urls`
`seedance-2.5-flash-reference-to-video`	Reference-to-Video	`prompt`
`seedance-2.5-flash-video-edit`	Video Edit	`prompt`, `video_urls`
`seedance-2.5-flash-video-extend`	Video Extend	`prompt`, `video_urls`

Text-to-Video

Genera video con indicaciones de texto puro, admite busqueda web para mejorar la actualidad

Image-to-Video

Ingrese 1 imagen para generar video desde el primer fotograma, ingrese 2 imagenes para generar video desde el primer y ultimo fotograma, el modelo determina automaticamente

Reference-to-Video

Genere un video con un prompt y referencias opcionales de imágenes (0–10), videos (0–5) y audio (0–5). Puede omitir todas las referencias o proporcionar únicamente audio.
Indicado para generar contenido nuevo: las imagenes, los videos y el audio actuan como referencia de estilo, sujeto, movimiento de camara y musica
Para reescribir o continuar un video existente, use Video Edit / Video Extend: en cuanto el prompt de este modelo expresa una intencion de edicion o extension, la solicitud se valida como tarea de edicion / extension, se acepta sin error y la tarea solo falla mientras se genera

Video Edit

Edicion sobre un video de entrada: reemplazar sujetos, agregar o quitar objetos, reestilizar o repintar regiones
Describa directamente el cambio en la indicación, por ejemplo: “Quitar a todos los transeuntes de @video1 y conservar solo al personaje principal”
Ingrese el video que se va a editar (obligatorio) + imagenes de referencia opcionales (0–10) + videos de referencia (hasta 5 en total) + audio de referencia (0–5)

Video Extend

Extiende un video de entrada hacia adelante o hacia atras
La indicacion debe expresar la intencion de extension (por ejemplo, “Extender @video1 hacia atras, el personaje sale del encuadre”)
Ingrese el video que se va a extender (obligatorio) + imagenes de referencia opcionales (0–10) + videos de referencia (hasta 5 en total) + audio de referencia (0–5)
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-flash-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-flash-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-flash-text-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": "<string>",
    "message": "<string>",
    "type": "<string>"
  }
}

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

Esta página reúne los parámetros de todos los modos. Los campos obligatorios, valores admitidos y valores por defecto dependen del model seleccionado; las diferencias se indican por modo abajo.

model

enum<string>

requerido

Nombre del modelo de generacion de video

ID del modelo	Modo	Campos obligatorios (sin model)
`seedance-2.5-flash-text-to-video`	Text-to-Video	`prompt`
`seedance-2.5-flash-image-to-video`	Image-to-Video	`prompt`, `image_urls`
`seedance-2.5-flash-reference-to-video`	Reference-to-Video	`prompt`
`seedance-2.5-flash-video-edit`	Video Edit	`prompt`, `video_urls`
`seedance-2.5-flash-video-extend`	Video Extend	`prompt`, `video_urls`

Opciones disponibles:

seedance-2.5-flash-text-to-video,

seedance-2.5-flash-image-to-video,

seedance-2.5-flash-reference-to-video,

seedance-2.5-flash-video-edit,

seedance-2.5-flash-video-extend

Ejemplo:

"seedance-2.5-flash-text-to-video"

prompt

string

requerido

Text-to-Video

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

Nota:

Este modelo es solo para texto a video, no admite entrada de image_urls, video_urls, audio_urls

Image-to-Video

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

Nota:

Este modelo no admite entrada de video_urls, audio_urls

Reference-to-Video

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

Descripcion:

Al hacer referencia a materiales de entrada en el prompt, use preferentemente etiquetas explicitas como @image1, @video1 y @audio1, en lugar de depender solo de expresiones en lenguaje natural como "imagen 1", "video 1" o "audio 1"
La numeracion de las etiquetas sigue el orden del array de URL correspondiente y empieza en 1: el primer elemento de image_urls es @image1, el primero de video_urls es @video1 y el primero de audio_urls es @audio1
La numeracion en lenguaje natural puede seguir siendo reconocida, pero las etiquetas explicitas establecen una correspondencia mas clara entre cada material y su uso

Evite que la tarea se clasifique como edicion / extension:

El tipo de tarea se deduce de la intencion del prompt: expresiones como "editar el video", "anadir", "eliminar / quitar", "cambiar / reemplazar" se interpretan como edicion de video; expresiones como "extender hacia adelante / hacia atras" o "continuar" se interpretan como extension de video
Una vez clasificada asi, aspect_ratio debe ser adaptive y, en la edicion de video, duration debe ser -1; de lo contrario la solicitud se acepta sin error y la tarea termina despues en failed (codigo de error InvalidParameter.TaskTypeConstraint). La cuota retenida se devuelve, pero el tiempo de espera se pierde
Si realmente necesita editar o extender, use directamente seedance-2.5-flash-video-edit o seedance-2.5-flash-video-extend: los parametros se validan al enviar la solicitud, por lo que un valor invalido devuelve un error sincrono inmediato
Para una generacion por referencia pura, reformule palabras como "reemplazar" o "quitar" de forma descriptiva, por ejemplo "en la escena aparece ..." o "presentado con el estilo de @image1"

Video Edit

Indicacion de texto que describe la edicion deseada. Admite chino e ingles; se recomienda no superar 500 caracteres en chino. Longitud maxima de la indicacion: 10000 tokens

Detalles:

La indicacion debe expresar la intencion de edicion, por ejemplo: "Editar el video: quitar la musica de fondo de @video1"
Puede usar lenguaje natural para indicar el proposito de cada material, por ejemplo: "reemplazar al personaje de @video1 por la persona de @image1"
El modelo entiende automaticamente la correspondencia entre los numeros de material y su uso previsto

Video Extend

Indicacion de texto que describe la extension deseada. Admite chino e ingles; se recomienda no superar 500 caracteres en chino. Longitud maxima de la indicacion: 10000 tokens

Detalles:

La indicacion debe expresar la intencion de extension, por ejemplo: "Extender @video1 hacia atras, el personaje sale del encuadre"
Puede usar lenguaje natural para indicar el proposito de cada material, por ejemplo: "extender @video1 hacia adelante siguiendo el estilo de @image1"
El modelo entiende automaticamente la correspondencia entre los numeros de material y su uso previsto

Ejemplo:

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

image_urls

string<uri>[]

Solo se aplica a: Image-to-Video, Reference-to-Video, Video Edit, Video Extend

Image-to-Video

Array de URLs de imagenes, 1-2 imagenes

Cantidad de imagenes y comportamiento:

Cantidad	Comportamiento	Rol
1 imagen	Video desde primer fotograma	Se establece automaticamente como `first_frame`
2 imagenes	Video desde primer y ultimo fotograma	1ra imagen -> `first_frame`, 2da imagen -> `last_frame`

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 fotogramas primero y ultimo, ambas imagenes pueden ser iguales. Cuando las relaciones de aspecto no coinciden, se toma el primer fotograma como referencia y el ultimo se recorta automaticamente
Las URLs de imagenes deben ser accesibles directamente por el servidor

Direcciones de medios: se admiten URL HTTP(S) públicas e identificadores asset:// accesibles para la cuenta del proveedor seleccionada.

Reference-to-Video

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

Referencias opcionales: puede omitir image_urls, video_urls y audio_urls, o proporcionar solo audio_urls.

Descripcion del rol:

Tipo de medio	Rol	Uso tipico
Imagen	`reference_image`	Referencia de estilo, imagen de producto, primer/ultimo fotograma (especificado mediante prompt)

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, no use codificacion Base64
Las URLs de imagenes deben ser accesibles directamente por el servidor

Direcciones de medios: se admiten URL HTTP(S) públicas e identificadores asset:// accesibles para la cuenta del proveedor seleccionada.

Video Edit

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

Requisito: en este modelo video_urls es obligatorio; las imagenes son referencias complementarias opcionales.

Descripcion del rol:

Tipo de medio	Rol	Uso tipico
Imagen	`reference_image`	Referencia de estilo, imagen de producto, sujeto de reemplazo (indicado en el prompt)

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, no use codificacion Base64
Las URLs de imagenes deben ser accesibles directamente por el servidor

Direcciones de medios: se admiten URL HTTP(S) públicas e identificadores asset:// accesibles para la cuenta del proveedor seleccionada.

Video Extend

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

Requisito: en este modelo video_urls es obligatorio; las imagenes son referencias complementarias opcionales.

Descripcion del rol:

Tipo de medio	Rol	Uso tipico
Imagen	`reference_image`	Referencia de estilo, imagen de producto, referencia de escena (indicado en el prompt)

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, no use codificacion Base64
Las URLs de imagenes deben ser accesibles directamente por el servidor

Direcciones de medios: se admiten URL HTTP(S) públicas e identificadores asset:// accesibles para la cuenta del proveedor seleccionada.

Maximum array length: 10

Ejemplo:

["https://example.com/first-frame.jpg"]

video_urls

string<uri>[]

Solo se aplica a: Reference-to-Video, Video Edit, Video Extend

Reference-to-Video

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

Referencias opcionales: puede omitir image_urls, video_urls y audio_urls, o proporcionar solo 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 5, 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

Direcciones de medios: se admiten URL HTTP(S) públicas e identificadores asset:// accesibles para la cuenta del proveedor seleccionada.

Video Edit

Arreglo de URL de videos de entrada, obligatorio; de 1 a 5 videos

Requisito: se necesita al menos 1 video, el que se va a editar. El primer video es el objeto de la edicion; los demas actuan como referencia.

Descripcion del rol:

Tipo de medio	Rol	Uso tipico
Video	`reference_video`	El video que se va a editar (el primero), referencia de movimiento de camara o de accion (los demas)

Requisitos de video:

Formatos admitidos: .mp4, .mov
Resolucion: 480p, 720p, 1080p, 4K
Duracion por video: 4 ~ 30 segundos (el primer video es el objeto de la edicion), maximo 5, 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

Direcciones de medios: se admiten URL HTTP(S) públicas e identificadores asset:// accesibles para la cuenta del proveedor seleccionada.

Video Extend

Arreglo de URL de videos de entrada, obligatorio; de 1 a 5 videos

Requisito: se necesita al menos 1 video, el que se va a extender. El primer video es el objeto de la extension; los demas actuan como referencia.

Descripcion del rol:

Tipo de medio	Rol	Uso tipico
Video	`reference_video`	El video que se va a extender (el primero), referencia de movimiento de camara o de accion (los demas)

Requisitos de video:

Formatos admitidos: .mp4, .mov
Resolucion: 480p, 720p, 1080p, 4K
Duracion por video: 2 ~ 30 segundos, maximo 5, 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

Direcciones de medios: se admiten URL HTTP(S) públicas e identificadores asset:// accesibles para la cuenta del proveedor seleccionada.

Maximum array length: 5

Ejemplo:

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

audio_urls

string<uri>[]

Solo se aplica a: Reference-to-Video, Video Edit, Video Extend

Reference-to-Video

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

Referencias opcionales: puede omitir image_urls, video_urls y audio_urls, o proporcionar solo 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 5 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

Direcciones de medios: se admiten URL HTTP(S) públicas e identificadores asset:// accesibles para la cuenta del proveedor seleccionada.

Video Edit / Video Extend

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

Requisito: en este modelo video_urls es obligatorio; el audio es una referencia complementaria opcional.

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

Direcciones de medios: se admiten URL HTTP(S) públicas e identificadores asset:// accesibles para la cuenta del proveedor seleccionada.

Maximum array length: 5

Ejemplo:

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

duration

Text-to-Video / Image-to-Video

Duracion del video (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

Reference-to-Video

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

Si el prompt se clasifica como tarea de edicion de video, solo -1 es valido; indicar segundos concretos hace que la tarea falle mas tarde, sin error al enviarla

Video Edit

Duracion del video de salida (segundos), valor predeterminado -1

Detalles:

Solo se admite -1: la duracion de salida sigue al video de entrada (puede ser hasta 0,4 s mas corta)
No se aceptan duraciones personalizadas
La duracion afecta directamente a la facturacion

Video Extend

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

Detalles:

Admite cualquier valor entero entre 4 y 30 segundos
-1: duracion automatica, liquidada segun la duracion real de salida
La duracion afecta directamente a la facturacion

Opciones disponibles:

-1

Ejemplo:

8

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

Opciones disponibles:

480p,

720p

Ejemplo:

"720p"

aspect_ratio

enum<string>

predeterminado:adaptive

Text-to-Video

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: el modelo selecciona inteligentemente la mejor relacion de aspecto segun la indicacion

Valores de pixeles por resolucion:

Relacion de aspecto	480p	720p
16:9	854×480	1280×720
4:3	752×560	1112×834
1:1	640×640	960×960
3:4	560×752	834×1112
9:16	480×854	720×1280
21:9	992×432	1470×630

Image-to-Video

Relacion de aspecto del video, Image-to-Video solo admite adaptive

Valores opcionales:

adaptive: selecciona automaticamente la relacion de aspecto mas cercana segun la proporcion de la imagen del primer fotograma; es el unico valor admitido por este modelo
Este modelo no permite especificar relaciones fijas como 16:9 o 9:16

Reference-to-Video

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: determina segun la intencion de la indicacion, prioridad: video > imagen > indicacion

Valores de pixeles por resolucion:

Relacion de aspecto	480p	720p
16:9	854×480	1280×720
4:3	752×560	1112×834
1:1	640×640	960×960
3:4	560×752	834×1112
9:16	480×854	720×1280
21:9	992×432	1470×630

Si el prompt se clasifica como tarea de edicion / extension de video, solo adaptive es valido; una relacion fija hace que la tarea falle mas tarde, sin error al enviarla

Video Edit / Video Extend

Relacion de aspecto del video, valor predeterminado adaptive

Valores opcionales:

adaptive: la relacion de salida sigue al primer video de entrada; es el unico valor admitido por este modelo
Las relaciones fijas como 16:9 o 9:16 se rechazan

Opciones disponibles:

16:9,

9:16,

1:1,

4:3,

3:4,

21:9,

adaptive

Ejemplo:

"16:9"

generate_audio

boolean

predeterminado:true

Text-to-Video

Si se genera audio sincronizado, valor predeterminado true

Valores opcionales:

true: el video incluye audio sincronizado (voz, efectos de sonido, musica de fondo), sin cargo adicional. Se recomienda colocar los dialogos entre comillas dobles para optimizar la generacion de audio
false: salida de video sin audio

Image-to-Video / Reference-to-Video / Video Edit / Video Extend

Si se genera audio sincronizado, valor predeterminado true

Valores opcionales:

true: el video incluye audio sincronizado, sin cargo adicional
false: salida de video sin audio

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

Solo se aplica a: Text-to-Video

Parametros extendidos del modelo

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-flash-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 Flash Guía completa de parámetros

Text-to-Video

Image-to-Video

Reference-to-Video

Video Edit

Video Extend

Autorizaciones

Cuerpo

Respuesta