curl --request POST \
  --url https://api.evolink.ai/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "veo-3.1-lite-generate-preview",
  "prompt": "A golden retriever puppy running through a sunlit meadow, slow motion, cinematic lighting"
}
'

{
  "created": 1757169743,
  "id": "task-unified-1757169743-7cvnl5zw",
  "model": "veo-3.1-lite-generate-preview",
  "object": "video.generation.task",
  "progress": 0,
  "status": "processing",
  "task_info": {
    "can_cancel": false,
    "estimated_time": 600,
    "video_duration": 4
  },
  "type": "video",
  "usage": {
    "billing_rule": "per_call",
    "credits_reserved": 12.24,
    "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: veo-3.1-lite-generate-preview",
    "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"
  }
}

Veo3.1

Veo3.1-Lite Generación de video

Veo 3.1 Lite es el nivel económico de Veo 3.1: texto a video e imagen a video con primer fotograma / primer y último fotograma; sin imágenes de referencia ni 4k
Se factura por segundo de video generado; la tarifa depende de la resolución y de si se genera audio, consulta precios de modelos de EvoLink
Procesamiento asíncrono: usa el ID de tarea devuelto para consultar su estado
Los enlaces de video generados son válidos durante 24 horas, guárdelos de inmediato

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": "veo-3.1-lite-generate-preview",
  "prompt": "A golden retriever puppy running through a sunlit meadow, slow motion, cinematic lighting"
}
'

{
  "created": 1757169743,
  "id": "task-unified-1757169743-7cvnl5zw",
  "model": "veo-3.1-lite-generate-preview",
  "object": "video.generation.task",
  "progress": 0,
  "status": "processing",
  "task_info": {
    "can_cancel": false,
    "estimated_time": 600,
    "video_duration": 4
  },
  "type": "video",
  "usage": {
    "billing_rule": "per_call",
    "credits_reserved": 12.24,
    "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: veo-3.1-lite-generate-preview",
    "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 APIs requieren autenticación Bearer Token##

Obtener API Key:

Visita la Página de gestión de API Key para obtener tu API Key

Agregar al encabezado de la solicitud:

Authorization: Bearer YOUR_API_KEY

Cuerpo

application/json

model

enum<string>

predeterminado:veo-3.1-lite-generate-preview

requerido

Nombre del modelo de generación de video. Este modelo no acepta image_start, image_end ni model_params (devuelve 400)

Opciones disponibles:

veo-3.1-lite-generate-preview

Ejemplo:

"veo-3.1-lite-generate-preview"

prompt

string

requerido

Prompt que describe el video, hasta 2000 tokens. Se cuentan con cl100k; los tokens no son caracteres. Google indica el inglés como idioma de prompt compatible. EvoLink no rechaza solicitudes por el idioma del prompt; no se garantizan resultados en otros idiomas.

Ejemplo:

"A golden retriever puppy running through a sunlit meadow, slow motion, cinematic lighting"

image_urls

string<uri>[]

URLs de las imágenes de entrada para imagen a video

Notas:

Máximo 2 imágenes por solicitud: 1 imagen se usa como primer fotograma, 2 imágenes se usan como primer y último fotograma
Tamaño de imagen: no mayor de 10 MB
Formatos de archivo admitidos: .jpg, .jpeg, .png

Maximum array length: 2

Ejemplo:

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

generation_type

enum<string>

Modo de generación. Si se omite, se deduce del número de imágenes:

TEXT: Texto a video (las imágenes enviadas no se usan)
FIRST&LAST: Primer y último fotograma, 1-2 imágenes

Este modelo no admite REFERENCE (imagen de referencia); devuelve 400

Opciones disponibles:

TEXT,

FIRST&LAST

aspect_ratio

enum<string>

Relación de aspecto del video. auto equivale a omitir aspect_ratio: no se especifica ninguna proporción y el modelo decide

Opciones disponibles:

auto,

16:9,

9:16

generate_audio

boolean

predeterminado:true

Generar audio, por defecto true. Generar audio aumenta el precio por segundo

duration

enum<integer>

predeterminado:4

Duración del video en segundos, por defecto 4. Los videos más largos cuestan más

Opciones disponibles:

4,

6,

8

integer

predeterminado:1

Número de videos a generar, por defecto 1. Cada video se factura por separado

Rango requerido: 1 <= x <= 4

quality

enum<string>

predeterminado:720p

Resolución de salida, por defecto 720p. 1080p tiene un precio por segundo mayor; este modelo no admite 4k

Opciones disponibles:

720p,

1080p

seed

integer

Semilla aleatoria para reproducir los resultados de generación

Rango requerido: 1 <= x <= 4294967295

negative_prompt

string

Prompt negativo que describe el contenido que no debe aparecer en el video

person_generation

enum<string>

Control de generación de personas. Si se omite, se usa el valor predeterminado del proveedor allow_adult. allow_adult: permitir solo adultos; dont_allow: no generar videos que contengan personas o rostros

Opciones disponibles:

allow_adult,

dont_allow

resize_mode

enum<string>

Modo de ajuste de imagen para imagen a video. Si se omite, se usa el valor predeterminado del proveedor pad. pad: añadir relleno para ajustar la relación de aspecto de salida; crop: recortar desde el centro para ajustarla. Requiere una imagen de entrada; enviar este parámetro sin una imagen devuelve 400

Opciones disponibles:

pad,

crop

callback_url

string<uri>

Dirección de callback HTTPS después de completar la tarea

Momento del callback:

Se activa cuando la tarea se completa o falla
Se envía después de completar la confirmación de facturación

Restricciones de seguridad:

Solo se admite el protocolo HTTPS
El callback a direcciones IP internas está prohibido (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 bytes UTF-8

Mecanismo de callback:

Tiempo de espera: 10 segundos
Máximo 3 reintentos en caso de fallo (reintentos después de 1 segundo/2 segundos/4 segundos)
El formato del cuerpo de respuesta del callback es consistente con el formato de respuesta de la API de consulta de tareas
La dirección de callback que devuelve un código de estado 2xx se considera exitosa, otros códigos de estado activarán reintentos

Ejemplo:

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

Respuesta

Tarea de generación de video creada exitosamente

created

integer

Marca de tiempo de creacion de la tarea

Ejemplo:

1757169743

string

ID de la tarea

Ejemplo:

"task-unified-1757169743-7cvnl5zw"

model

string

Nombre del modelo realmente utilizado

Ejemplo:

"veo-3.1-lite-generate-preview"

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:

"processing"

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

Veo3.1-Lite Generación de video

Autorizaciones

Cuerpo

Respuesta