Veo 3.1 Lite API
Modelo de vídeo ligero de Google que genera vídeos horizontales o verticales a partir de texto o de un fotograma inicial, con audio nativo opcional.
- 720p · sin audio
- Google 0,03 $ / segundo
- 1080p · sin audio
- Google 0,05 $ / segundo
- 1080p · con audio
- Google 0,08 $ / segundo
- 4 s · 720p · con audio
- KIE 0,0188 $ / segundo
- Oficial
0,05 $63% menos
Comparar precios
Compara los precios públicos de los proveedores para la misma especificación de salida
Enrutamiento automático y failover
Llama a Veo 3.1 Lite con un solo ID de modelo y Yir elige el canal de cada tarea entre Google, NanoAPI y KIE: la envía al canal disponible con el precio estimado más bajo y la cobra al precio público de ese canal, sin recargo. Si un intento falla, lo reintenta en otro canal sin superar tu max_cost. No necesitas parámetros de enrutamiento en tu solicitud. Documentación de enrutamiento y failover
Notas de precios
Se cobra según el proveedor que realmente ejecuta la tarea. El failover puede cambiar de proveedor, lo que puede modificar el costo y el tiempo.
Usar la API
Deja el código a un agente de programación, genera en el chat con MCP o la Skill, o intégralo tú mismo con el SDK o la API compatible con OpenAI.
Deja que un agente de programación lo integre
Copia el prompt de integración o ábrelo directamente en Codex o Claude. El agente lee esta página y el contrato del modelo, y luego escribe en tu proyecto el envío, la espera y el manejo de resultados.
Añade el servidor MCP de Yir
Conéctalo a ChatGPT, Claude o Cursor, menciona @Yir y pide Veo 3.1 Lite por su nombre. Primero te da el precio y solo genera cuando confirmas.
https://gateway.yir.ai/mcpUn comando para Claude Code
Crea una API key en la consola, guárdala como YIR_API_KEY y ejecuta:
claude mcp add --transport http yir https://gateway.yir.ai/mcp --header "Authorization: Bearer $YIR_API_KEY"Instala la Skill de Yir
Define YIR_API_KEY donde se ejecuta tu agente, añade la Skill a Claude Code, Codex u otro agente de programación y di “usa Veo 3.1 Lite en Yir para crear…”.
npx skills add yir-ai/skillsInstala el SDK oficial con tu gestor de paquetes o copia el fragmento de código de abajo para empezar
| import { createNodeYirClient } from "@yir-ai/sdk/server"; |
| // Lee YIR_API_KEY del entorno por defecto: process.env.YIR_API_KEY |
| const client = createNodeYirClient(); |
| // 1. Envía una tarea de generación de video |
| const job = await client.submitVideo({ |
| model: "google/veo-3.1-lite-generate-001", |
| input: { |
| type: "text", |
| prompt: "Una tortuga marina nada despacio sobre un arrecife de coral. La cámara la sigue suavemente de lado mientras la luz del sol atraviesa el agua clara y proyecta reflejos en movimiento sobre su caparazón", |
| }, |
| parameters: { |
| duration: 8, |
| resolution: "720p", |
| aspect_ratio: "16:9", |
| generate_audio: true, |
| n: 1, |
| }, |
| }); |
| // 2. Espera a que la tarea termine y entregue el resultado |
| const result = await client.waitForJob(job.id); |
| console.log("Archivos entregados:", result.result); |
| if (result.result && "files" in result.result) { |
| for (const file of result.result.files) { |
| console.log("->", file.url); |
| } |
| } |
Los proyectos que ya usan el protocolo de OpenAI, o gateways como new-api, solo necesitan una nueva Base URL y una nueva clave. Guía de compatibilidad con OpenAI
- base_url del SDK de OpenAI
https://gateway.yir.ai/openai/v1- Base URL del canal en new-api
https://gateway.yir.ai/openai- Clave
- API Key de Yir
- ID del modelo
google/veo-3.1-lite-generate-001
curl https://gateway.yir.ai/openai/v1/videos \
-H "Authorization: Bearer $YIR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "google/veo-3.1-lite-generate-001",
"prompt": "Una tortuga marina nada despacio sobre un arrecife de coral. La cámara la sigue suavemente de lado mientras la luz del sol atraviesa el agua clara y proyecta reflejos en movimiento sobre su caparazón",
"resolution": "720p",
"aspect_ratio": "16:9",
"seconds": "8"
}'Resumen de parámetros
Parámetros comunes; los límites dependen del modelo actual y del proveedor seleccionado
- Resolución resolution
- 720p
- 1080p
Nivel de resolución de salida. Las resoluciones más altas dan mayor nitidez y el precio aumenta en consecuencia
- Relación de aspecto aspect_ratio
- 16:9
- 9:16
Proporción geométrica. Elígela según el medio de destino (vertical, banner o cuadrado)
- Modo de entrada input_mode
- Entrada de texto
- Entrada de imagen
Los límites y formatos de las referencias dependen del modelo y del proveedor seleccionado
- Duración duration
- 4 segundos
- 6 segundos
- 8 segundos
Nivel de duración del video de salida, cobrado por segundo o por tramos
- Audio generate_audio
- Opcional
Pista de audio nativo sincronizado opcional
- Referencias references
- first_frame ≤ 1
Los límites por modo dependen del proveedor elegido. Las cantidades de la tabla son ejemplos de precio, no límites ni cuotas gratuitas.





