# OpenRouter APIs — Google: Veo 3.1 Lite (google/veo-3.1-lite)

Guide for calling every confirmed OpenRouter API that serves `google/veo-3.1-lite`.

Model page: https://openrouter.ai/google/veo-3.1-lite
Create an API key: https://openrouter.ai/settings/keys

## Pricing

Standard-variant prices for `google/veo-3.1-lite`, per provider, in the unit each provider bills (tokens, images, seconds of video, or characters of audio). Pay-as-you-go with no markup on the provider's price.

- Google Vertex: from $0.05/second (plus 1 more; see the model page for the full price list)

Full price table, including other variants and per-request charges: https://openrouter.ai/google/veo-3.1-lite
How OpenRouter prices requests: https://openrouter.ai/pricing

## EU in-region routing

`google/veo-3.1-lite` is not currently available through EU in-region routing.

Docs: https://openrouter.ai/docs/guides/features/in-region-routing

## Authentication

Send this header with every request:

- Authorization: Bearer $OPENROUTER_API_KEY

## Video API

Generate videos with `google/veo-3.1-lite` through OpenRouter's Video API.

Docs: https://openrouter.ai/docs/guides/overview/multimodal/video-generation
Model discovery API: https://openrouter.ai/api/v1/videos/models

### Endpoint

POST https://openrouter.ai/api/v1/videos

Headers:
- Content-Type: application/json

Generation is asynchronous: the submit call returns a job, which is polled until it
finishes. The finished video is downloaded from the job, not returned inline.

### Request fields (google/veo-3.1-lite)

- model: string (required) — `"google/veo-3.1-lite"`
- prompt: string (optional when frame_images is set, otherwise required) — text description of the desired video
- duration: 8 | 4 | 6 (optional) — length of the video in seconds
- size: "1280x720" | "720x1280" | "1920x1080" | "1080x1920" (optional) — exact pixel dimensions, as WIDTHxHEIGHT
- resolution: "720p" | "1080p" (optional) — resolution tier; interchangeable with size when paired with aspect_ratio
- aspect_ratio: "16:9" | "9:16" (optional) — aspect ratio of the generated video
- frame_images: array of frame references (optional) — images to condition the named frame on, as `{ "type": "image_url", "image_url": { "url": "…" }, "frame_type": "first_frame" }` entries; frame_type is one of "first_frame" | "last_frame", and the url is an https URL or a base64 data URL
- input_references: array of reference assets (optional) — images to guide the generation, as `{ "type": "image_url", "image_url": { "url": "…" } }` entries
- generate_audio: boolean (optional) — generate audio alongside the video
- seed: integer (optional) — sample deterministically; determinism is not guaranteed for every provider
- callback_url: string (optional) — https URL notified by webhook when the job finishes, instead of polling

These are the generation parameters this model accepts between its providers; an unlisted
value is rejected, and a listed one can still be refused by whichever provider serves the
call. `provider` (routing preferences) is accepted on every request.

### Response

The submit call returns `202` with the job:

```json
{
  "id": "job-abc123",
  "generation_id": "gen-xyz789",
  "polling_url": "/api/v1/videos/job-abc123",
  "status": "pending"
}
```

Poll `GET https://openrouter.ai/api/v1/videos/{id}` with the same Authorization header while `status` is
`pending` or `in_progress`, and stop once it is `completed`, `failed`, `cancelled`, or
`expired`:

```json
{
  "id": "job-abc123",
  "status": "completed",
  "unsigned_urls": ["https://storage.example.com/video.mp4"],
  "usage": { "cost": 0.5 }
}
```

Download the bytes from `GET https://openrouter.ai/api/v1/videos/{id}/content` (`?index=N` selects a clip
when the job produced more than one). `usage.cost` is the USD charge for the call.

### Examples

#### Text to video (Snowy night)

```bash
curl -X POST https://openrouter.ai/api/v1/videos \
  -H "Authorization: Bearer $OPENROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "google/veo-3.1-lite",
  "prompt": "a slow cinematic push-in on a contemporary neighborhood storefront on a snowy winter evening at blue hour, a warm-white neon sign in flowing cursive reading \"OpenRouter\" above the entrance, snowflakes drifting through the golden window light, fresh snow on the awning, ledges and sidewalk, frost at the corners of the glass, a cozy interior of wood shelves and plants, a snow-dusted bicycle by the door, quiet street with no people, no holiday decorations"
}'
```

#### Text to video (Rainy night)

```bash
curl -X POST https://openrouter.ai/api/v1/videos \
  -H "Authorization: Bearer $OPENROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "google/veo-3.1-lite",
  "prompt": "a slow cinematic push-in on a glowing neon sign that reads \"OpenRouter\" in the window of a cozy coffee shop on a rainy night, rain streaking down the glass, reflections rippling on wet pavement",
  "duration": 6
}'
```

### Error differences

- 404 also covers an unknown video job
- 500 — the job could not be submitted

A job that fails after acceptance reports `status: "failed"` with an `error` message rather than
an HTTP error, since the submit call already succeeded.

## Errors

Failures return `{"error": {"code": <number>, "message": <string>}}` with the HTTP status:

- 400 — malformed request or an unsupported parameter
- 401 — missing or invalid API key
- 402 — insufficient credits
- 403 — spend limit reached, key disabled, or access blocked
- 404 — unknown model or no provider can serve the request
- 429 — rate limited; retry with backoff
- 502 — the operation failed upstream; failed generations are not billed

---

Canonical version of this document: https://openrouter.ai/google/veo-3.1-lite/llms.txt
