Saltar al contenido principal
POST
/
v1
/
videos
/
generations
Interfaz veo3.1-fast
curl --request POST \
  --url https://api.evolink.ai/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "veo3.1-fast",
  "prompt": "A cat playing piano"
}
'
{
  "created": 1757169743,
  "id": "task-unified-1757169743-7cvnl5zw",
  "model": "veo3.1-fast",
  "object": "video.generation.task",
  "progress": 0,
  "status": "pending",
  "task_info": {
    "can_cancel": true,
    "estimated_time": 180,
    "video_duration": 8
  },
  "type": "video",
  "usage": {
    "billing_rule": "per_call",
    "credits_reserved": 25.7,
    "user_group": "default"
  }
}

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:veo3.1-fast
requerido

Nombre del modelo de generación de video

Opciones disponibles:
veo3.1-fast
Ejemplo:

"veo3.1-fast"

​
prompt
string
requerido

Prompt que describe qué tipo de video generar, limitado a 2000 tokens

Maximum string length: 2000
Ejemplo:

"A cat playing piano"

​
aspect_ratio
enum<string>
predeterminado:auto

Relación de aspecto del video. Cuando se establece en auto: imagen a video seleccionará automáticamente según la relación de la imagen de entrada, texto a video seleccionará automáticamente según el contenido del prompt

Opciones disponibles:
auto,
16:9,
9:16
Ejemplo:

"auto"

​
image_urls
string<uri>[]

Lista de URLs de imágenes de referencia para la función de imagen a video

Nota:

  • Una solicitud admite la cantidad de imágenes de entrada: 3 imágenes (1 imagen para generación de video de primer fotograma, 2 imágenes para generación de video de primer y último fotograma)
  • Tamaño de imagen: no más de 10MB
  • Formatos de archivo admitidos: .jpg, .jpeg, .png, .webp
  • Las URLs de las imágenes deben ser directamente visibles por el servidor, o la URL de la imagen debe activar la descarga directa al acceder (normalmente estas URLs terminan con extensiones de archivo de imagen, como .png, .jpg)
Maximum array length: 3
Ejemplo:
["http://example.com/image1.jpg"]
​
quality
enum<string>

Resolución de video, por defecto es 720p

Opciones disponibles:
720p,
1080p,
4k
​
generation_type
enum<string>

Modo de generación de video, por defecto coincide según la cantidad de imágenes, se recomienda la selección manual. Modos disponibles:

  • TEXT: Texto a video
  • FIRST&LAST: Primer y último fotograma a video, admite 1~2 imágenes
  • REFERENCE: Imagen de referencia a video, admite hasta 3 imágenes

Nota:

  • Actualmente, el modo de imagen de referencia a video REFERENCE solo admite relación de aspecto 16:9
Opciones disponibles:
TEXT,
FIRST&LAST,
REFERENCE
​
enhance_prompt
boolean
predeterminado:true

Si se debe traducir automáticamente el prompt al inglés. Cuando está habilitado, los prompts que no estén en inglés se traducirán automáticamente al inglés para obtener mejores resultados de generación

Ejemplo:

true

​
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, falla o se cancela
  • 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 caracteres

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 creación de la tarea

Ejemplo:

1757169743

​
id
string

ID de tarea

Ejemplo:

"task-unified-1757169743-7cvnl5zw"

​
model
string

Nombre del modelo real utilizado

Ejemplo:

"veo3.1-fast"

​
object
enum<string>

Tipo de tarea específico

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

Información detallada de la tarea de video

​
type
enum<string>

Tipo de salida de la tarea

Opciones disponibles:
text,
image,
audio,
video
Ejemplo:

"video"

​
usage
object

Información de uso y facturación