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.

Obtén tu clave API

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

Realiza tu primera solicitud

curl -X POST "https://veo3api.com/generate" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "a dog running",
    "model": "veo3-fast",
    "watermark": "veo"
  }'

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

curl -X GET "https://veo3api.com/feed?task_id=YOUR_TASK_ID" \
  -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ámetro	Tipo	Requerido	Descripción
`prompt`	string	*	El prompt de texto para la generación de video
`model`	string	*	Elige entre veo3 (alta calidad, 180 créditos) o veo3-fast (generación rápida, 25 créditos)
`aspect_ratio`	string		Relación de aspecto: 16:9 (predeterminado, 1080P HD), 9:16 (vertical) o Auto (coincidir con la imagen)
`image_urls`	string[]		Arreglo de URLs de imágenes para la generación de imagen a video
`watermark`	string		Texto de marca de agua personalizada. Establecer como null para no usar marca de agua

Solicitud de ejemplo

JSON

{
  "prompt": "a dog running",
  "model": "veo3-fast",
  "watermark": "veo"
}

Respuesta

JSON Response 200 OK

{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "veo4a7f5dd50a90446aa3c567ecceea42bcbksv"
  }
}

Consumo de créditos

Tipo de modelo	Créditos	Costo
`veo3-fast`	25 credits	$0.25
`veo3`	180 credits	$1.80
`extend`	Igual que el original	-
`get-1080p`	Gratis	$0.00

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

{
  "code": 200,
  "message": "success",
  "data": {
    "request": {
      "prompt": "a dog running",
      "model": "veo3-fast",
      "watermark": "veo"
    },
    "response": [
      "https://cdn.veo3api.com/video/example_watermarked.mp4"
    ],
    "status": "COMPLETED",
    "created_at": "2025-10-29 12: 20: 46"
  }
}

💡 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ámetro	Tipo	Requerido	Descripción
`task_id`	string	*	El task_id del video original completado que se desea extender
`prompt`	string	*	El prompt de texto que describe cómo continuar/extender el video
`seeds`	integer		Semilla aleatoria (10000-99999) para generación reproducible. La misma semilla produce resultados similares
`watermark`	string		Texto de marca de agua personalizada. Establecer como null para no usar marca de agua

Solicitud de ejemplo

JSON

{
  "task_id": "veo4a7f5dd50a90446aa3c567ecceea42bcbksv",
  "prompt": "The dog continues running and jumps over a fence",
  "watermark": "veo"
}

Respuesta

JSON Response 200 OK

{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "veo8b2c3dd60b80557bb4c678fddef53cdextd",
    "original_task_id": "veo4a7f5dd50a90446aa3c567ecceea42bcbksv",
    "credits_consumed": 25
  }
}

Nota: Solo las tareas de video completadas pueden extenderse. Los videos convertidos a 1080P no 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

{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "veo4a7f5dd50a90446aa3c567ecceea42bcbksv",
    "result_url": "https://cdn.veo3api.com/video/example_1080p.mp4"
  }
}

💡 Consejo: Este endpoint es completamente gratuito. Puedes obtener la versión 1080P de cualquier video completado sin consumir créditos.

Códigos de estado HTTP

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