# Veo 3.1 Lite

> 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.

- Página del modelo: https://yir.ai/es/models/veo-3-1-lite-generate-001
- ID del modelo: `google/veo-3.1-lite-generate-001`
- Cobro: según el proveedor que ejecutó la tarea; los intentos que el proveedor no facturó son gratis.

## Precios

Precios públicos actuales por proveedor para la misma especificación de salida; los precios oficiales son una referencia. Se te cobra según el proveedor que realmente ejecuta la tarea, que puede cambiar con un failover.

| Especificación de salida | Proveedor | Precio público |
|---|---|---|
| 720p · sin audio | Google (oficial) | 0,03 $ / segundo |
| 720p · sin audio | NanoAPI | 0,0585 $ / segundo |
| 1080p · sin audio | Google (oficial) | 0,05 $ / segundo |
| 1080p · con audio | Google (oficial) | 0,08 $ / segundo |
| 4 s · 720p · con audio | Google (oficial) | 0,05 $ / segundo |
| 4 s · 720p · con audio | KIE | 0,0188 $ / segundo |
| 4 s · 720p · con audio | NanoAPI | 0,0585 $ / segundo |
| 6 s · 720p · con audio | Google (oficial) | 0,05 $ / segundo |
| 6 s · 720p · con audio | KIE | 0,0125 $ / segundo |
| 6 s · 720p · con audio | NanoAPI | 0,0585 $ / segundo |
| 8 s · 720p · con audio | Google (oficial) | 0,05 $ / segundo |
| 8 s · 720p · con audio | KIE | 0,0094 $ / segundo |
| 8 s · 720p · con audio | NanoAPI | 0,0585 $ / segundo |

## Parámetros

- Operación: `generate_video`

| Parámetro | Valores | Por defecto |
|---|---|---|
| `input` | text / image | text |
| `resolution` | 720p / 1080p | 720p |
| `aspect_ratio` | 16:9 / 9:16 | 16:9 |
| `duration` | 4 / 6 / 8 | 8 |
| `generate_audio` | true / false | true |

## Integración

Elige una opción: el SDK oficial para código nuevo, o cambia la Base URL en proyectos que ya usan el protocolo de OpenAI.

### SDK oficial (TypeScript)

El SDK llama a la Standard API (https://gateway.yir.ai) para enviar tareas, esperarlas y recoger los resultados; también hay un SDK de Go. https://yir.ai/docs/integrations/sdk

```bash
pnpm add @yir-ai/sdk
```

```ts
import { createNodeYirClient } from "@yir-ai/sdk/server";

// Reads YIR_API_KEY from the environment by default: process.env.YIR_API_KEY
const client = createNodeYirClient();

// 1. Submit a video generation job
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. Wait for the job to finish and deliver its result
const result = await client.waitForJob(job.id);
console.log("Delivered files:", result.result);
if (result.result && "files" in result.result) {
  for (const file of result.result.files) {
    console.log("->", file.url);
  }
}
```

### API compatible con OpenAI

Protocolos OpenAI Images y Sora Videos para los SDK de OpenAI y gateways como new-api; sin chat. https://yir.ai/docs/integrations/openai-compatibility

- base_url del SDK de OpenAI: `https://gateway.yir.ai/openai/v1`
- Base URL del canal en new-api (tipo de canal OpenAI): `https://gateway.yir.ai/openai`
- ID del modelo: `google/veo-3.1-lite-generate-001`

```bash
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"
  }'
```

## Preguntas frecuentes

### ¿Veo 3.1 Lite tiene una API oficial?

Sí. Google vende Veo 3.1 Lite a través de su propia API oficial. Con la misma especificación, los proveedores externos en Yir lo ofrecen hasta un 81% más barato (consulta la tabla anterior), y los llamas a todos con una sola clave de API de Yir.

## Reglas

- Autentícate con Authorization: Bearer $YIR_API_KEY; guarda la clave en una variable de entorno del servidor, nunca en código de navegador, control de versiones, prompts ni registros.
- Las tareas son asíncronas: guarda el Job ID, espera a un estado final y luego lee el resultado; gestiona los fallos y las cancelaciones.
- Para reintentar de forma segura, reutiliza la misma clave de idempotencia y la misma solicitud; no reenvíes a ciegas cuando el resultado sea desconocido.
- Las URL de resultados son temporales; copia los archivos a otro lugar si necesitas conservarlos.

## Enlaces

- [Inicio rápido](https://yir.ai/docs/getting-started/quickstart)
- [Referencia de la API](https://yir.ai/docs/reference)
- [llms.txt](https://yir.ai/llms.txt)
