curl --request POST \
  --url https://api.evolink.ai/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "seedance-2.0-image-to-video",
  "prompt": "The camera slowly zooms in, the scene gradually comes to life",
  "image_urls": [
    "https://example.com/first-frame.jpg"
  ],
  "duration": 5,
  "aspect_ratio": "adaptive"
}
'

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

{
  "error": {
    "code": "invalid_request",
    "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.0-image-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"
  }
}

Seedance 2.0

Seedance 2.0 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
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.0-image-to-video",
  "prompt": "The camera slowly zooms in, the scene gradually comes to life",
  "image_urls": [
    "https://example.com/first-frame.jpg"
  ],
  "duration": 5,
  "aspect_ratio": "adaptive"
}
'

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

{
  "error": {
    "code": "invalid_request",
    "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.0-image-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"
  }
}

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.0-image-to-video

requerido

Nombre del modelo de generacion de video

Opciones disponibles:

seedance-2.0-image-to-video

Ejemplo:

"seedance-2.0-image-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 o 1000 palabras en ingles. Longitud maxima del prompt: 10000 tokens

Nota:

Este modelo no admite entrada de video_urls, audio_urls

Ejemplo:

"The camera slowly zooms in, the scene gradually comes to life"

image_urls

string<uri>[]

requerido

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

Required array length: 1 - 2 elements

Ejemplo:

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

duration

integer

predeterminado:5

Duracion del video (segundos), valor predeterminado 5 segundos

Descripcion:

Admite cualquier valor entero entre 4 y 15 segundos
La duracion esta directamente relacionada con la facturacion

Rango requerido: 4 <= x <= 15

Ejemplo:

5

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
4k: claridad 4K Ultra HD

Opciones disponibles:

480p,

720p,

1080p,

4k

Ejemplo:

"720p"

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 relacion de aspecto mas cercana segun la proporcion de la imagen del primer fotograma

Valores de pixeles por resolucion:

Relacion de aspecto	480p	720p	1080p	4K
16:9	864×496	1280×720	1920×1080	3840×2160
4:3	752×560	1112×834	1664×1248	3326×2494
1:1	640×640	960×960	1440×1440	2880×2880
3:4	560×752	834×1112	1248×1664	2494×3326
9:16	496×864	720×1280	1080×1920	2160×3840
21:9	992×432	1470×630	2206×946	4398×1886

Opciones disponibles:

16:9,

9:16,

1:1,

4:3,

3:4,

21:9,

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

callback_url

string<uri>

Direccion de callback HTTPS despues de completar la tarea

Momento del callback:

Se activa cuando la tarea se completa (completed), falla (failed) o se cancela (cancelled)
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.0-image-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.0 Image-to-Video

Autorizaciones

Cuerpo

Respuesta