Documentación de la API Veo 3.1

Guía completa para integrar la generación de video con IA de Google en tus aplicaciones.

Guía de inicio rápido

Empieza a usar la API Veo 3.1 en solo unos minutos.

1

Obtén tu clave API

Primero, debes obtener una clave API desde tu panel de control.

2

Realiza tu primera solicitud

1curl -X POST "https://veo3api.com/generate" \
2 -H "Authorization: Bearer YOUR_API_KEY" \
3 -H "Content-Type: application/json" \
4 -d '{
5 "prompt": "a dog running",
6 "model": "veo4",
7 "duration": 5,
8 "resolution": "720p"
9 }'
3

Verifica el estado de generación

La generación de video es asíncrona. https://veo3api.com/feed Usa el endpoint para comprobar el estado, o proporciona un

cURL
1curl -X GET "https://veo3api.com/feed?task_id=YOUR_TASK_ID" \
2 -H "Authorization: Bearer YOUR_API_KEY"

Referencia de la API

Referencia completa de todos los endpoints, parámetros y formatos de respuesta de la API Veo 3.1.

URL base

https://veo3api.com

Los endpoints no usan el prefijo /api — llama a https://veo3api.com/ (por ejemplo https://veo3api.com/generate).

Autenticación

Todas las solicitudes a la API requieren autenticación usando un token Bearer en el encabezado Authorization.

Authorization: Bearer YOUR_API_KEY
POSThttps://veo3api.com/generate

Generar un video a partir de un prompt de texto o imagen

Cuerpo de la solicitud

ParámetroTipoRequeridoDescripción
promptstring*El prompt de texto para la generación de video
modelstring*Elige veo3 (alta calidad, 180 créditos), veo3-fast (generación rápida, 25 créditos) o veo4 (precio según duración y resolución; consulta la tabla inferior)
durationintegerDuración de Veo 4: 5, 10 o 15 segundos (predeterminado: 5)
resolutionstringResolución de salida de Veo 4: 480p, 720p (predeterminado) o 1080p
aspect_ratiostringRelación de aspecto: 16:9 (predeterminado, 1080P HD), 9:16 (vertical) o Auto (coincidir con la imagen)
image_urlsstring[]Arreglo de URLs de imágenes para la generación de imagen a video
watermarkstringTexto de marca de agua personalizada. Establecer como null para no usar marca de agua

Solicitud de ejemplo

JSON
1{
2 "prompt": "a dog running",
3 "model": "veo4",
4 "duration": 5,
5 "resolution": "720p",
6 "aspect_ratio": "16: 9"
7}

Respuesta

JSON Response 200 OK
1{
2 "code": 200,
3 "message": "success",
4 "data": {
5 "task_id": "n90a1b2c3d4e5f6sd20",
6 "status": "IN_PROGRESS",
7 "consumed_credits": 240,
8 "model": "veo4"
9 }
10}

Consumo de créditos

Tipo de modeloCréditosCosto
veo3-fast25 credits$0.25
veo3180 credits$1.80
veo4480p · 5s / 10s / 15s160 / 320 / 480 credits$1.60 / $3.20 / $4.80
veo4720p · 5s / 10s / 15s240 / 480 / 720 credits$2.40 / $4.80 / $7.20
veo41080p · 5s / 10s / 15s360 / 720 / 1080 credits$3.60 / $7.20 / $10.80
extendIgual que el original-
get-1080pGratis$0.00

El precio de Veo 4 depende de la duración y la resolución; texto a video e imagen a video usan la misma tarifa.

Nota: Los créditos solo se descuentan cuando la generación del video se completa con éxito. Las tareas fallidas no consumen créditos.

GEThttps://veo3api.com/feed

Comprobar el estado de una tarea de generación de video

Solicitud de ejemplo

GET https://veo3api.com/feed?task_id=YOUR_TASK_ID

Respuesta

JSON Response 200 OK
1{
2 "code": 200,
3 "message": "success",
4 "data": {
5 "request": {
6 "prompt": "a dog running",
7 "model": "veo4",
8 "duration": 5,
9 "resolution": "720p",
10 "aspect_ratio": "16: 9"
11 },
12 "response": [
13 "https://cdn.veo3api.com/video/example_watermarked.mp4"
14 ],
15 "status": "COMPLETED",
16 "consumed_credits": 240,
17 "type": "text-to-video",
18 "model": "veo4",
19 "created_at": "2025-10-29 12: 20: 46"
20 }
21}

💡 Consejo: La URL del video generado se puede obtener desde el arreglo data.response.

POSThttps://veo3api.com/extend

Extender un video existente con un nuevo prompt. El video extendido continuará desde donde terminó el original.

Cuerpo de la solicitud

ParámetroTipoRequeridoDescripción
task_idstring*El task_id del video original completado que se desea extender
promptstring*El prompt de texto que describe cómo continuar/extender el video
seedsintegerSemilla aleatoria (10000-99999) para generación reproducible. La misma semilla produce resultados similares
watermarkstringTexto de marca de agua personalizada. Establecer como null para no usar marca de agua

Solicitud de ejemplo

JSON
1{
2 "task_id": "veo8a7f5dd50a90446aa3c567ecceea42bcbksv",
3 "prompt": "The dog continues running and jumps over a fence",
4 "watermark": "veo"
5}

Respuesta

JSON Response 200 OK
1{
2 "code": 200,
3 "message": "success",
4 "data": {
5 "task_id": "veo8b2c3dd60b80557bb4c678fddef53cdextd",
6 "original_task_id": "veo8a7f5dd50a90446aa3c567ecceea42bcbksv",
7 "credits_consumed": 25
8 }
9}

Nota: Este endpoint solo admite tareas veo3 y veo3-fast completadas. No está disponible para tareas Veo 4, y los videos convertidos a 1080P tampoco se pueden extender.

GEThttps://veo3api.com/get-1080pGratis

Obtén la versión 1080P en alta definición de una tarea de video completada. Este endpoint es gratuito y no consume créditos.

Solicitud de ejemplo

GET https://veo3api.com/get-1080p?task_id=YOUR_TASK_ID

Respuesta

JSON Response 200 OK
1{
2 "code": 200,
3 "message": "success",
4 "data": {
5 "task_id": "veo8a7f5dd50a90446aa3c567ecceea42bcbksv",
6 "result_url": "https://cdn.veo3api.com/video/example_1080p.mp4"
7 }
8}

💡 Consejo: Este endpoint solo admite tareas veo3 y veo3-fast completadas. Es gratuito y no consume créditos. Veo 4 se puede generar directamente en 1080p.

Códigos de estado HTTP

Código de estadoDescripción
200Solicitud exitosa
400Solicitud incorrecta - Parámetros inválidos
401No autorizado - Clave API inválida
429Límite de solicitudes excedido
500Error interno del servidor