Models/Google/Veo 3.1

Google: Veo 3.1

Name: Veo 3.1
Brand: Google
Price: 2.55 USD
Availability: InStock

Videoveo-3.1

Google DeepMind's Veo 3.1: cinematic 1080p video with native audio, from text or a first frame.

API docs

Playgroundveo-3.1

Reference image＋Upload

duration

Aspect ratio

Latency13.5 s

24hnow

Specifications

Authorgoogle

ModalityVideo

Price$2.55 / video$3.20 / video

Savings−20%

ReleasedJul 23, 2026

Quick start

# Video is asynchronous: create, then poll.
curl https://api.altrouter.ai/v1/videos \
  -H "Authorization: Bearer ar-..." \
  -H "Content-Type: application/json" \
  -d '{
    "model": "veo-3.1",
    "prompt": "a drone shot over a coastline"
  }'
# → { "id": "vid_...", "status": "queued" }

curl https://api.altrouter.ai/v1/videos/vid_... \
  -H "Authorization: Bearer ar-..."
# → { "status": "completed", "url": "https://api.altrouter.ai/media/videos/..." }

Same OpenAI-compatible endpoint — just swap base_url and key.

API

An asynchronous endpoint: the call returns immediately in queued, and you poll GET /v1/videos/{id} for the result. The finished mp4 is re-hosted on our CDN, and only a completed render is charged.

POST/v1/videos

Body parameters

modelstringrequired"veo-3.1"

The model id.

promptstringrequired

The text description of the scene.

secondsinteger

Clip length; `duration` is accepted as an alias.

imagestringURL or base64

A reference frame — its presence routes to the model’s image-to-video variant.

durationenum4 · 6 · 8default 8

Clip length in seconds (affects price).

aspect_ratioenum16:9 · 9:16default 16:9

Output aspect ratio.

Response

The same object comes back from GET /v1/videos/{id}; the finished file is also served directly from GET /v1/videos/{id}/content.

idstring

The render id (vid_…) — this is what you poll.

statusenumqueued · in_progress · completed · failed

The state of the render.

urlstring

The finished mp4 on our CDN — appears at status: completed.

secondsinteger

The clip length the price was computed on.

errorobject

Why it failed at status: failed: { code, message }.

Example

cURLPythonJSON

curl https://api.altrouter.ai/v1/videos \
  -H "Authorization: Bearer ar-..." \
  -H "Content-Type: application/json" \
  -d '{
  "model": "veo-3.1",
  "prompt": "a drone shot over a rocky coastline at sunrise",
  "duration": "8",
  "aspect_ratio": "16:9"
}'

Errors

400Invalid request.

401Missing or invalid API key.

402Insufficient credits, or the key’s spending cap is exhausted.

404Model not found.

429Rate limit exceeded.