Saltar al contenido principal
POST
/
v1
/
videos
/
generations
Veo-3.1-Generate-Preview API
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-generate-preview",
  "prompt": "A cat playing piano"
}
'
{
  "created": 1757169743,
  "id": "task-unified-1757169743-7cvnl5zw",
  "model": "veo-3.1-generate-preview",
  "status": "pending"
}

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
string
predeterminado:veo-3.1-generate-preview
requerido
​
prompt
string
requerido

Prompt, máximo 2000 tokens

Maximum string length: 2000
​
image_urls
string<uri>[]

Imágenes de referencia, máximo 3, máximo 10MB cada una

Maximum array length: 3
​
generation_type
enum<string>

Modo:

  • TEXT: Texto a video
  • FIRST&LAST: Primer y último fotograma, 1-2 imágenes
  • REFERENCE: Imagen de referencia, máximo 3 imágenes, duración fija de 8s, relación de aspecto fija de 16:9, excepto generate_audio, otros parámetros avanzados no son compatibles
Opciones disponibles:
TEXT,
FIRST&LAST,
REFERENCE
​
aspect_ratio
enum<string>

Relación de aspecto, por defecto 16:9

Opciones disponibles:
16:9,
9:16
​
generate_audio
boolean

Generar audio (costo adicional), por defecto true

​
duration
enum<integer>

Duración (segundos), por defecto 4

Opciones disponibles:
4,
6,
8
​
n
integer

Número de videos, por defecto 1

Rango requerido: 1 <= x <= 4
​
quality
enum<string>

Resolución, por defecto 720p

Opciones disponibles:
720p,
1080p,
4k
​
seed
integer
Rango requerido: 1 <= x <= 4294967295
​
negative_prompt
string
​
person_generation
enum<string>

Control de generación de personas, por defecto allow_adult. allow_adult: solo permitir adultos; dont_allow: sin personas/rostros

Opciones disponibles:
allow_adult,
dont_allow
​
resize_mode
enum<string>

Modo de redimensionamiento (solo I2V), por defecto pad

Opciones disponibles:
pad,
crop
​
callback_url
string<uri>

Respuesta

Tarea creada exitosamente

​
created
integer
Ejemplo:

1757169743

​
id
string
Ejemplo:

"task-unified-1757169743-7cvnl5zw"

​
model
string
Ejemplo:

"veo-3.1-generate-preview"

​
status
enum<string>
Opciones disponibles:
pending,
processing,
completed,
failed