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-video-edit",
  "prompt": "Quitar a todos los transeuntes de @video1 y conservar solo al personaje principal",
  "video_urls": [
    "https://example.com/original.mp4"
  ],
  "quality": "720p",
  "generate_audio": true
}
'

{
  "created": 1761313744,
  "id": "task-unified-1774857405-abc123",
  "model": "seedance-2.5-flash-video-edit",
  "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-video-edit",
    "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"
  }
}

Seedance 2.5

Seedance 2.5 Flash 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 exactamente 1 video para editar (obligatorio, 4–30 segundos) + imágenes de referencia opcionales (0–10) + audio de referencia (0–5); la duración y la relación de aspecto de salida siguen al video de entrada
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-video-edit",
  "prompt": "Quitar a todos los transeuntes de @video1 y conservar solo al personaje principal",
  "video_urls": [
    "https://example.com/original.mp4"
  ],
  "quality": "720p",
  "generate_audio": true
}
'

{
  "created": 1761313744,
  "id": "task-unified-1774857405-abc123",
  "model": "seedance-2.5-flash-video-edit",
  "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-video-edit",
    "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"
  }
}

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>

predeterminado:seedance-2.5-flash-video-edit

requerido

Nombre del modelo de generacion de video

Opciones disponibles:

seedance-2.5-flash-video-edit

Ejemplo:

"seedance-2.5-flash-video-edit"

prompt

string

requerido

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:

Describa directamente el cambio que desea, por ejemplo: "Quitar a todos los transeuntes de @video1 y conservar solo al personaje principal"
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

Ejemplo:

"Quitar a todos los transeuntes de @video1 y conservar solo al personaje principal"

video_urls

string<uri>[]

requerido

Arreglo de URL de videos de entrada, obligatorio; exactamente 1 video

Requisito: proporcione exactamente 1 video, el que se va a editar. La duración y la relación de aspecto de salida siguen a este video.

Requisitos de video:

Formatos admitidos: .mp4, .mov
Resolucion: 480p, 720p, 1080p, 4K
Duración del video: 4 ~ 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
Las URLs de video deben ser accesibles directamente por el servidor

Required array length: 1 element

Ejemplo:

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

image_urls

string<uri>[]

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

Required array length: 1 - 10 elements

Ejemplo:

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

audio_urls

string<uri>[]

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

Required array length: 1 - 5 elements

Ejemplo:

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

duration

enum<integer>

predeterminado:-1

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

Detalles:

Puede omitir este campo; si se envía, solo se acepta -1 y la duración de salida sigue al video de entrada
No se aceptan duraciones personalizadas

Opciones disponibles:

-1

Ejemplo:

-1

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

Relacion de aspecto del video, valor predeterminado adaptive

Valores opcionales:

adaptive: la relación de salida sigue al video de entrada; también puede omitir este campo
Las relaciones fijas como 16:9 o 9:16 se rechazan

Opciones disponibles:

adaptive

Ejemplo:

"adaptive"

generate_audio

boolean

predeterminado:true

Si se genera audio sincronizado, valor predeterminado true

Valores opcionales:

true: el video incluye audio sincronizado, sin cargo adicional
false: no se genera audio nuevo

Ejemplo:

true

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-video-edit"

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 Video Edit

Autorizaciones

Cuerpo

Respuesta