SandBase is live — $1 in free credits on signupStart free ›

Google modelsvideo generation api

google/veo3.1/reference-to-video

Veo3.1 is Google's image-to-video AI model. Bring static images to life with fluid animation, consistent character motion, and professional-grade video output.

Input
The text prompt describing the video you want to generate

PNG, JPEG, WebP, or GIF · 20 MiB maximum each

URLs of the reference images to use for consistent subject appearance
The resolution of the generated video. Allowed values: 720p, 1080p, 4k.
The duration of the generated video.
Whether to generate audio for the video.
The aspect ratio of the generated image. Allowed values: 21:9, 16:9, 3:2, 4:3, 5:4, 1:1, 4:5, 3:4, 2:3, 9:16.
Idle

Example output — click Run to generate your own

API README

Veo 3.1

google/veo3.1/reference-to-video uses multiple visual references to establish characters, objects, environments, or style in a newly generated video. Veo 3.1 improves instruction following, physical consistency, character continuity, and audiovisual quality while supporting more ways to anchor or continue a shot. This combination makes the model a practical choice when the creative outcome depends on those qualities rather than on a generic media conversion.

For production work with google/veo3.1/reference-to-video, the reference-guided generation workflow suits storyboards, campaign films, product moments, narrative shots, and visual concepts that need coherent motion rather than isolated animated frames. The result is most reliable when the source material and creative brief clearly describe the intended subject, progression, visual or sonic character, and the qualities that must remain unchanged.

Highlights

Multi-reference understanding carries supplied identities, objects, and style into a coherent moving scene.

Improved physical coherence strengthens object interactions, character movement, and cause-and-effect across shots.

Visual continuity maintains subjects and scene logic across the generated sequence.

Native audio generation coordinates dialogue, ambience, and sound effects with the visual action.

Pricing

ResolutionAudio off, per secondAudio on, per second
720p or 1080p$0.200$0.400
4K$0.400$0.600

When to Use

✅ Good fit❌ Consider alternatives
The model's named workflow matches the source material and intended outputA different input modality or model route is required
A managed asynchronous result is suitable for the production pipelineA synchronous, interactive editor is essential
The documented controls cover the required duration, framing, or formatThe project needs controls outside this endpoint's schema
Creative iteration benefits from a repeatable request structureExact deterministic pixels, frames, geometry, or samples are mandatory
A finished downloadable media asset is the desired deliverableEditable source layers or a native project file are required

Prompt Guide

For generation, state the intended result first, then add the subject or source treatment, progression, style, and delivery constraints. Keep one creative variable per phrase, use the documented field names for controls, and change one setting at a time when comparing results.

{
  "aspect_ratio": "21:9",
  "duration": 8,
  "images": [
    "https://static.sandbase.ai/examples/google/veo3.1/reference-to-video/input_images_0.png"
  ],
  "prompt": "A chimpanzee wearing overalls frolics in the grassy field, gently playing with the butterflies. In the background, a circus tent and carousel beckon.",
  "resolution": "720p"
}

Technical Specs

SpecValue
Model IDgoogle/veo3.1/reference-to-video
Inputsaspect_ratio, duration, generate_audio, images, prompt, resolution
Required inputsprompt
Output fieldscontent_type, url
ExecutionAsync (submit, then poll for result)
Resolution720p / 1080p / 4k
Aspect Ratio21:9 / 16:9 / 3:2 / 4:3 / 5:4 / 1:1 / 4:5 / 3:4 / 2:3 / 9:16

Related Models

Related Models

google/veo3.1Veo3.1 by Google - generate cinematic videos from text descriptions with AI. Create high-quality video content with natural motion, camera control, and optional audio generation.google/veo3.1/extend-videoVeo3.1 Extend Video is Google's video-to-video AI model. Transform, enhance, and edit video content using text prompts - from style changes to object manipulation and scene modification.google/veo3.1/fastVeo3.1 Fast is Google's text-to-video AI model. Turn written scripts and prompts into professional-quality video clips with realistic motion, lighting, and scene composition.google/veo3.1/fast/extend-videoVeo3.1 Fast Extend Video by Google - AI-powered video editing and transformation. Apply style transfer, motion control, lip-sync, and visual effects to existing videos with natural language instructions.google/veo3.1/fast/first-last-frame-to-videoVeo3.1 Fast First Last Frame To Video is Google's image-to-video AI model. Bring static images to life with fluid animation, consistent character motion, and professional-grade video output.google/veo3.1/fast/image-to-videoVeo 3.1 Fast is Google's image-to-video AI model. Bring static images to life with fluid animation, consistent character motion, and professional-grade video output.google/veo3.1/fast/reference-to-videoVeo3.1 Fast by Google - animate still images into dynamic videos with AI. Transform photos into cinematic clips with natural motion, camera movement, and optional audio generation.google/veo3.1/first-last-frame-to-videoVeo3.1 First Last Frame To Video by Google - animate still images into dynamic videos with AI. Transform photos into cinematic clips with natural motion, camera movement, and optional audio generation.