Google Veo

Active

by Faro

1 tool

upstream:

Generate short videos (4–8s, with audio) from a text prompt using Google's Veo 3.1 family — Standard (highest quality), Fast (balanced), and Lite (most affordable). Supports 720p, 1080p, and 4k at 16:9 or 9:16. The server polls Google internally; agents see a synchronous-feeling call that returns a hosted MP4 URL.

Videovideogenerationgoogleveomultimedia

Tools (1)

▶generate

Generate a video from a text prompt with Google Veo 3.1. Returns {status:"pending", continuation_token, ...} while the upstream job is still running — when this happens you MUST immediately call generate again with only continuation_token set; do not ask the user. Final response includes video_url (hosted on files.askfaro.com).

Usage-based · Per-clip pricing depends on model, resolution, and duration. Per second of generated video: Lite 720p ~55 credits, Lite 1080p ~88 credits, Fast 720p ~110 credits, Fast 1080p ~132 credits, Fast 4k ~331 credits, Standard 720p/1080p ~442 credits, Standard 4k ~662 credits. A typical 8s clip ranges from ~440 (Lite 720p) to ~5300 credits (Standard 4k). Pending polling responses are free; you are only charged when the final video is delivered.

Example prompts

“Generate an 8-second cinematic clip of a fox running through a snowy forest at dawn”
“Make a fast 4-second 9:16 vertical clip of waves crashing on a beach for a social ad”
“Create a 1080p time-lapse of clouds rolling over a mountain range, 6 seconds”
“Generate a short promotional video clip for a product launch from a text description”

Parameters

modelstringoptionaldefault: "veo-3.1-fast-generate-preview"

Veo 3.1 model variant. `fast` is recommended; `lite` is cheapest but lower quality; the base preview model is highest quality and most expensive.

promptstringoptional

Text prompt describing the video to generate. Required on the first call; ignored when continuation_token is set.

resolutionstringoptionaldefault: "720p"

Output resolution. 1080p/4k force duration_seconds=8. Lite does not support 4k.

aspect_ratiostringoptionaldefault: "16:9"

duration_secondsintegeroptionaldefault: 8

Clip length in seconds. Must be 8 when resolution is 1080p or 4k.

continuation_tokenstringoptional

Token from a prior pending response — when set, all other params are ignored and the server resumes polling. Agent-friendly polling: on a pending response you MUST immediately call generate again with only continuation_token set. Do not ask the user. Typical jobs finish within 1–3 round-trips.

API Usage

curl -X POST "https://api.askfaro.com/invoke/google-veo/generate" \
  -H "Authorization: Bearer <your_api_key>" \
  -H "Content-Type: application/json" \
  -d '{
  "arguments": {}
}'

CLI Usage

faro invoke google-veo/generate --params '{}'

Install pip install askfaro-cli, then faro auth login.

▶README

Google Veo

Text-to-video generation via Google's Veo 3.1 family.

How it works

Veo generations are asynchronous on Google's side (30s–2min). To keep the agent flow synchronous, the server polls internally for ~25s per call. If the video isn't ready yet, you get a status:"pending" response with a continuation_token — call the tool again with only that token to resume polling. Typically 1–3 round-trips.

Models

Model	Best for
`veo-3.1-generate-preview`	Highest quality.
`veo-3.1-fast-generate-preview`	Recommended default — good quality, ~4× cheaper than Standard.
`veo-3.1-lite-generate-preview`	Cheapest. 720p / 1080p only (no 4k).

Inputs

Name	Type	Default	Notes
`prompt`	string	required on first call	Up to 4096 chars.
`model`	string	`veo-3.1-fast-generate-preview`	See models above.
`resolution`	string	`720p`	`720p`, `1080p`, or `4k`. 1080p/4k force 8s duration.
`duration_seconds`	integer	`8`	`4`, `6`, or `8`.
`aspect_ratio`	string	`16:9`	or `9:16`.
`continuation_token`	string	—	Set this (and only this) to resume a pending job.

Output

{
  "video_url": "https://files.askfaro.com/...",
  "expires_at": "<ISO timestamp>",
  "size_bytes": 1234567,
  "model": "veo-3.1-fast-generate-preview",
  "resolution": "720p",
  "duration_seconds": 8,
  "aspect_ratio": "16:9"
}

Videos are hosted on files.askfaro.com and remain available until the bucket's lifecycle rule deletes them (currently ~48h). Re-generate or copy the bytes if you need longer-lived storage.

Audio

Veo 3.1 always generates audio with the video.

Safety

Google applies its own safety filters; a generation that's filtered comes back as an error, not a pending state. You are not charged for failed generations.