Veo3.1 Fast Reference to Video | Fast Image-to-Video API

Google Veo 3.1 Fast Reference-to-Video

Google Veo 3.1 Fast Reference-to-Video generates an 8-second video guided by up to three reference images and a text prompt. It is designed for subject, object, and product consistency, making it useful for character-led shots, product motion, style-guided generation, and other reference-driven video workflows.

Why Choose This?

Reference-guided generation Use up to three reference images to preserve subject, object, or product identity in the generated video.
Fast Veo workflow Built on Google Veo 3.1 Fast for quicker turnaround and efficient iteration.
Consistent 8-second output Generates a fixed-length 8s MP4, making duration predictable for planning and pricing.
Flexible aspect ratio Supports both 16:9 and 9:16 for landscape and vertical video use cases.
Optional audio generation Enable generate_audio when you want the output to include generated sound.
Simple pricing Pricing depends only on resolution and whether audio generation is enabled.

Parameters

Parameter	Required	Description
prompt	Yes	Motion, scene, and camera instructions.
images	Yes	`1–3` reference images. These are sent as asset reference images.
aspect_ratio	No	`16:9` or `9:16`. Default: `16:9`.
resolution	No	`720p` or `1080p`. Default: `720p`.
generate_audio	No	Whether to generate audio. Default: `false`.
negative_prompt	No	Things to avoid in the video.
seed	No	Random seed for reproducibility.

How to Use

Upload your reference images — provide 1–3 images for subject, style, or product guidance.
Write your prompt — describe the motion, scene progression, camera movement, and overall visual intent.
Set aspect ratio — choose 16:9 for landscape or 9:16 for vertical output.
Choose resolution — use 720p for lower cost or 1080p for higher quality.
Enable audio (optional) — turn on generate_audio if you want generated sound in the result.
Add a negative prompt (optional) — describe elements or artifacts you want to avoid.
Set a seed (optional) — use a fixed seed for more reproducible outputs.
Submit — run the model and download the generated 8-second video.

Example Prompt

A cinematic product reveal of the same luxury watch from the reference images, rotating slowly on a reflective black surface, dramatic studio lighting, soft camera push-in, premium commercial style

Pricing

This model generates a fixed 8-second video.

Mode	Cost
720p without audio	$0.64
720p with audio	$0.80
1080p without audio	$0.80
1080p with audio	$0.96

Billing Rules

Output length is fixed at 8 seconds
720p without audio costs $0.64
720p with audio costs $0.80
1080p without audio costs $0.80
1080p with audio costs $0.96
Pricing depends only on resolution and generate_audio
aspect_ratio, negative_prompt, seed, and the number of reference images do not affect pricing

Best Use Cases

Product motion videos — Generate controlled product shots from reference images.
Character consistency — Keep the same subject identity across a short generated clip.
Style-guided generation — Use references to anchor visual style, mood, or composition.
Marketing creatives — Produce short polished clips for ads, social media, and promotional assets.
Vertical content — Generate 9:16 outputs for short-form mobile platforms.

Pro Tips

Use clear, high-quality reference images for stronger identity preservation.
Keep the reference images visually consistent when you want the subject or product to remain stable.
Be specific in your prompt about motion, camera movement, and scene intent.
Use negative_prompt to reduce unwanted style drift or artifacts.
Enable audio only when you actually need it, since it changes pricing.
Reuse the same seed when you want more reproducible generations.

Notes

Both prompt and images are required.
This workflow supports up to 3 reference images.
The model uses the official Veo 3.1 Fast long-running generation flow with referenceImages added to the request payload.
Output duration is fixed at 8 seconds.
generate_audio defaults to false.

Related Models

Other Google Veo 3.1 Fast video generation variants may be useful when you need text-to-video or non-reference workflows.

Veo3.1 Fast Reference To Video API — Quick start

Grab a WaveSpeedAI API key, then call POST https://api.wavespeed.ai/api/v3/google/veo3.1-fast/reference-to-video with your input as JSON. The endpoint returns a prediction id; poll the prediction endpoint until status flips to completed, then read the output URL from data.outputs[0]. Examples for Veo3.1 Fast Reference To Video below.

HTTP example

# Submit the prediction
curl -X POST "https://api.wavespeed.ai/api/v3/google/veo3.1-fast/reference-to-video" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $WAVESPEED_API_KEY" \
  -d '{
    "prompt": "A cinematic shot of a city at sunset, soft golden light",
    "aspect_ratio": "16:9",
    "resolution": "720p",
    "generate_audio": false,
    "negative_prompt": "blurry, low quality, distorted",
    "seed": -1
}'

# Response includes a prediction id. Poll for the result:
curl -X GET "https://api.wavespeed.ai/api/v3/predictions/{request_id}/result" \
  -H "Authorization: Bearer $WAVESPEED_API_KEY"

# When status is "completed", read the output from data.outputs[0].

Node.js example

// npm install wavespeed
const WaveSpeed = require('wavespeed');

const client = new WaveSpeed(); // reads WAVESPEED_API_KEY from env

const result = await client.run("google/veo3.1-fast/reference-to-video", {
        "prompt": "A cinematic shot of a city at sunset, soft golden light",
        "aspect_ratio": "16:9",
        "resolution": "720p",
        "generate_audio": false,
        "negative_prompt": "blurry, low quality, distorted",
        "seed": -1
});

console.log(result.outputs[0]); // → URL of the generated output

Python example

# pip install wavespeed
import wavespeed

output = wavespeed.run(
    "google/veo3.1-fast/reference-to-video",
    {
    "prompt": "A cinematic shot of a city at sunset, soft golden light",
    "aspect_ratio": "16:9",
    "resolution": "720p",
    "generate_audio": false,
    "negative_prompt": "blurry, low quality, distorted",
    "seed": -1
}
)

print(output["outputs"][0])  # → URL of the generated output

Veo3.1 Fast Reference To Video API — Frequently asked questions

What is the Veo3.1 Fast Reference To Video API?

Veo3.1 Fast Reference To Video is a Google model for video generation from images, exposed as a REST API on WaveSpeedAI. Google Veo 3.1 Fast Reference to Video is a fast AI reference-to-video generation model that creates 8-second videos from up to three reference images using the official Veo predictLongRunning endpoint with referenceImages assets. Ready-to-use REST inference API for product videos, character consistency, branded visual storytelling, social media clips, advertising creatives, and professional reference-based video generation workflows with simple integration, no coldstarts, and affordable pricing. You can call it programmatically or try it from the playground above.

How do I call the Veo3.1 Fast Reference To Video API?

POST your input parameters to the model's REST endpoint (shown in the API tab of this playground) with your WaveSpeedAI API key in the Authorization header. Submission returns a prediction ID; poll the prediction endpoint until status flips to "completed", then read the output URL from the result. The playground generates a ready-to-paste code sample in Python, JavaScript, or cURL for whatever inputs you've set. Full request/response shape is documented at https://wavespeed.ai/docs/docs-api/google/google-veo3.1-fast-reference-to-video.

How much does Veo3.1 Fast Reference To Video cost per run?

Veo3.1 Fast Reference To Video starts at $0.64 per run. That figure is the base price — the final charge scales with the parameters you set in the form (output size, length, count, references, or whatever knobs this model exposes), so a higher-quality or larger output costs more than a minimal one. The exact cost for your current input is shown live next to the Generate button before you submit, and the actual per-call charge is recorded on the prediction afterwards.

What inputs does Veo3.1 Fast Reference To Video accept?

Key inputs: `prompt`, `images`, `aspect_ratio`, `resolution`, `seed`, `negative_prompt`. The full JSON schema (types, defaults, allowed values) is rendered above the Generate button and mirrored in the API reference at https://wavespeed.ai/docs/docs-api/google/google-veo3.1-fast-reference-to-video.

How do I get started with the Veo3.1 Fast Reference To Video API?

Sign up for a free WaveSpeedAI account to claim starter credits, copy your API key from /accesskey, then call the endpoint shown in the API tab of the playground. The playground also auto-generates a code sample in Python, JavaScript, or cURL for the parameters you've set.

Can I use Veo3.1 Fast Reference To Video outputs commercially?

Commercial usage rights depend on the model's license, set by its provider (Google). The license summary appears on the model card above; see WaveSpeedAI's Terms of Service for platform-level conditions.

ExamplesView all

Related Models

README

Google Veo 3.1 Fast Reference-to-Video

Why Choose This?

Parameters

How to Use

Example Prompt

Pricing

Billing Rules

Best Use Cases

Pro Tips

Notes

Related Models

Veo3.1 Fast Reference To Video API — Quick start

Veo3.1 Fast Reference To Video API — Frequently asked questions