Veo 3.1

Veo 3.1 is a cinematic video generation model for developers. It turns text prompts or reference images into high fidelity scenes with richer native audio, better prompt adherence, and granular shot control. Use it for story driven clips with smoother motion and consistent style.

API Reference
INTEGRATE
Complete technical specification for integration
RequestResponse
Examples3
CODE
Ready-to-use code snippets for common workflows
Windblown Salt Flats Caravan
import { createClient } from '@runware/sdk'
const client = await createClient({ apiKey: process.env.RUNWARE_API_KEY })
await client.connect()
const [result] = await client.run({
model: 'google:3@2',
positivePrompt: 'Extend the existing shot seamlessly as the caravan continues across the endless salt flats. The camera gradually arcs outward from the lead sail wagon to reveal several more wind-powered wagons traveling in staggered formation, their canvas rigs flexing in powerful gusts. Fine crystals skitter across the surface, wheels leave faint temporary trails, and the horizon wavers with heat haze. A flock of pale birds lifts suddenly from the ground and crosses the frame. Keep the handcrafted world grounded and believable, with cinematic composition, smooth motion continuity, coherent lighting, natural textures, and immersive environmental sound matching the scene.',
inputs: {
video: 'https://assets.runware.ai/assets/inputs/18651b28-127c-414e-b438-63ba201e7bde.mp4'
}
})import asyncio
import os
from runware import Runware
async def main():
async with Runware(api_key=os.environ["RUNWARE_API_KEY"]) as client:
results = await client.run({
"model": "google:3@2",
"positivePrompt": "Extend the existing shot seamlessly as the caravan continues across the endless salt flats. The camera gradually arcs outward from the lead sail wagon to reveal several more wind-powered wagons traveling in staggered formation, their canvas rigs flexing in powerful gusts. Fine crystals skitter across the surface, wheels leave faint temporary trails, and the horizon wavers with heat haze. A flock of pale birds lifts suddenly from the ground and crosses the frame. Keep the handcrafted world grounded and believable, with cinematic composition, smooth motion continuity, coherent lighting, natural textures, and immersive environmental sound matching the scene.",
"inputs": {
"video": "https://assets.runware.ai/assets/inputs/18651b28-127c-414e-b438-63ba201e7bde.mp4"
}
})
asyncio.run(main())curl https://api.runware.ai/v1 \
-H "Authorization: Bearer $RUNWARE_API_KEY" \
-H "Content-Type: application/json" \
-d '[
{
"taskType": "videoInference",
"taskUUID": "5bc59356-3f80-48fa-80e1-5b08f06c2c62",
"model": "google:3@2",
"positivePrompt": "Extend the existing shot seamlessly as the caravan continues across the endless salt flats. The camera gradually arcs outward from the lead sail wagon to reveal several more wind-powered wagons traveling in staggered formation, their canvas rigs flexing in powerful gusts. Fine crystals skitter across the surface, wheels leave faint temporary trails, and the horizon wavers with heat haze. A flock of pale birds lifts suddenly from the ground and crosses the frame. Keep the handcrafted world grounded and believable, with cinematic composition, smooth motion continuity, coherent lighting, natural textures, and immersive environmental sound matching the scene.",
"inputs": {
"video": "https://assets.runware.ai/assets/inputs/18651b28-127c-414e-b438-63ba201e7bde.mp4"
}
}
]'runware run google:3@2 \
positivePrompt="Extend the existing shot seamlessly as the caravan continues across the endless salt flats. The camera gradually arcs outward from the lead sail wagon to reveal several more wind-powered wagons traveling in staggered formation, their canvas rigs flexing in powerful gusts. Fine crystals skitter across the surface, wheels leave faint temporary trails, and the horizon wavers with heat haze. A flock of pale birds lifts suddenly from the ground and crosses the frame. Keep the handcrafted world grounded and believable, with cinematic composition, smooth motion continuity, coherent lighting, natural textures, and immersive environmental sound matching the scene." \
inputs.video=https://assets.runware.ai/assets/inputs/18651b28-127c-414e-b438-63ba201e7bde.mp4{
"taskType": "videoInference",
"taskUUID": "5bc59356-3f80-48fa-80e1-5b08f06c2c62",
"model": "google:3@2",
"positivePrompt": "Extend the existing shot seamlessly as the caravan continues across the endless salt flats. The camera gradually arcs outward from the lead sail wagon to reveal several more wind-powered wagons traveling in staggered formation, their canvas rigs flexing in powerful gusts. Fine crystals skitter across the surface, wheels leave faint temporary trails, and the horizon wavers with heat haze. A flock of pale birds lifts suddenly from the ground and crosses the frame. Keep the handcrafted world grounded and believable, with cinematic composition, smooth motion continuity, coherent lighting, natural textures, and immersive environmental sound matching the scene.",
"inputs": {
"video": "https://assets.runware.ai/assets/inputs/18651b28-127c-414e-b438-63ba201e7bde.mp4"
}
}{
"taskType": "videoInference",
"taskUUID": "5bc59356-3f80-48fa-80e1-5b08f06c2c62",
"videoUUID": "8d94c5f5-c28d-43cb-97e5-e2a4a93079eb",
"videoURL": "https://vm.runware.ai/video/os/a22d05/ws/5/vi/8d94c5f5-c28d-43cb-97e5-e2a4a93079eb.mp4",
"seed": 1735117314,
"cost": 3.2
}Moonlit Desert Train Platform
import { createClient } from '@runware/sdk'
const client = await createClient({ apiKey: process.env.RUNWARE_API_KEY })
await client.connect()
const [result] = await client.run({
model: 'google:3@2',
positivePrompt: 'Begin from the provided first frame image. A cinematic nighttime scene at a remote desert train platform beneath an enormous moon. The camera slowly pushes forward along the platform as warm station lamps flicker in the wind, fine sand skims across the ground, the sleeper train hums softly, and distant lightning flashes inside towering clouds on the horizon. A lone traveler in a pale coat steps into frame near the carriage door, fabric moving in the breeze. Rich contrast, realistic textures, elegant shot continuity from the input frame, subtle atmospheric depth, premium film look, immersive ambient night audio with wind, metal creaks, low train engine rumble, and a faint mournful whistle.',
width: 1920,
height: 1080,
duration: 8,
seed: 3967,
providerSettings: {
google: {
enhancePrompt: true,
generateAudio: true,
resizeMode: 'crop'
}
},
inputs: {
frameImages: [
{
inputImage: 'https://assets.runware.ai/assets/inputs/c5f27ba0-48e9-4d95-b584-c49b1d6cd0d5.jpg',
frame: 'first'
}
]
}
})import asyncio
import os
from runware import Runware
async def main():
async with Runware(api_key=os.environ["RUNWARE_API_KEY"]) as client:
results = await client.run({
"model": "google:3@2",
"positivePrompt": "Begin from the provided first frame image. A cinematic nighttime scene at a remote desert train platform beneath an enormous moon. The camera slowly pushes forward along the platform as warm station lamps flicker in the wind, fine sand skims across the ground, the sleeper train hums softly, and distant lightning flashes inside towering clouds on the horizon. A lone traveler in a pale coat steps into frame near the carriage door, fabric moving in the breeze. Rich contrast, realistic textures, elegant shot continuity from the input frame, subtle atmospheric depth, premium film look, immersive ambient night audio with wind, metal creaks, low train engine rumble, and a faint mournful whistle.",
"width": 1920,
"height": 1080,
"duration": 8,
"seed": 3967,
"providerSettings": {
"google": {
"enhancePrompt": True,
"generateAudio": True,
"resizeMode": "crop"
}
},
"inputs": {
"frameImages": [
{
"inputImage": "https://assets.runware.ai/assets/inputs/c5f27ba0-48e9-4d95-b584-c49b1d6cd0d5.jpg",
"frame": "first"
}
]
}
})
asyncio.run(main())curl https://api.runware.ai/v1 \
-H "Authorization: Bearer $RUNWARE_API_KEY" \
-H "Content-Type: application/json" \
-d '[
{
"taskType": "videoInference",
"taskUUID": "5c2130bb-19f0-48fd-8d99-1d7b1da9d508",
"model": "google:3@2",
"positivePrompt": "Begin from the provided first frame image. A cinematic nighttime scene at a remote desert train platform beneath an enormous moon. The camera slowly pushes forward along the platform as warm station lamps flicker in the wind, fine sand skims across the ground, the sleeper train hums softly, and distant lightning flashes inside towering clouds on the horizon. A lone traveler in a pale coat steps into frame near the carriage door, fabric moving in the breeze. Rich contrast, realistic textures, elegant shot continuity from the input frame, subtle atmospheric depth, premium film look, immersive ambient night audio with wind, metal creaks, low train engine rumble, and a faint mournful whistle.",
"width": 1920,
"height": 1080,
"duration": 8,
"seed": 3967,
"providerSettings": {
"google": {
"enhancePrompt": true,
"generateAudio": true,
"resizeMode": "crop"
}
},
"inputs": {
"frameImages": [
{
"inputImage": "https://assets.runware.ai/assets/inputs/c5f27ba0-48e9-4d95-b584-c49b1d6cd0d5.jpg",
"frame": "first"
}
]
}
}
]'runware run google:3@2 \
positivePrompt="Begin from the provided first frame image. A cinematic nighttime scene at a remote desert train platform beneath an enormous moon. The camera slowly pushes forward along the platform as warm station lamps flicker in the wind, fine sand skims across the ground, the sleeper train hums softly, and distant lightning flashes inside towering clouds on the horizon. A lone traveler in a pale coat steps into frame near the carriage door, fabric moving in the breeze. Rich contrast, realistic textures, elegant shot continuity from the input frame, subtle atmospheric depth, premium film look, immersive ambient night audio with wind, metal creaks, low train engine rumble, and a faint mournful whistle." \
width=1920 \
height=1080 \
duration=8 \
seed=3967 \
providerSettings.google.enhancePrompt=true \
providerSettings.google.generateAudio=true \
providerSettings.google.resizeMode=crop \
inputs.frameImages.0.inputImage=https://assets.runware.ai/assets/inputs/c5f27ba0-48e9-4d95-b584-c49b1d6cd0d5.jpg \
inputs.frameImages.0.frame=first{
"taskType": "videoInference",
"taskUUID": "5c2130bb-19f0-48fd-8d99-1d7b1da9d508",
"model": "google:3@2",
"positivePrompt": "Begin from the provided first frame image. A cinematic nighttime scene at a remote desert train platform beneath an enormous moon. The camera slowly pushes forward along the platform as warm station lamps flicker in the wind, fine sand skims across the ground, the sleeper train hums softly, and distant lightning flashes inside towering clouds on the horizon. A lone traveler in a pale coat steps into frame near the carriage door, fabric moving in the breeze. Rich contrast, realistic textures, elegant shot continuity from the input frame, subtle atmospheric depth, premium film look, immersive ambient night audio with wind, metal creaks, low train engine rumble, and a faint mournful whistle.",
"width": 1920,
"height": 1080,
"duration": 8,
"seed": 3967,
"providerSettings": {
"google": {
"enhancePrompt": true,
"generateAudio": true,
"resizeMode": "crop"
}
},
"inputs": {
"frameImages": [
{
"inputImage": "https://assets.runware.ai/assets/inputs/c5f27ba0-48e9-4d95-b584-c49b1d6cd0d5.jpg",
"frame": "first"
}
]
}
}{
"taskType": "videoInference",
"taskUUID": "5c2130bb-19f0-48fd-8d99-1d7b1da9d508",
"videoUUID": "28d61059-f5bd-4df4-bf49-c3747776c06b",
"videoURL": "https://vm.runware.ai/video/os/a05d22/ws/5/vi/28d61059-f5bd-4df4-bf49-c3747776c06b.mp4",
"seed": 3967,
"cost": 3.2
}Bioluminescent Cliffside Lighthouse Twilight
import { createClient } from '@runware/sdk'
const client = await createClient({ apiKey: process.env.RUNWARE_API_KEY })
await client.connect()
const [result] = await client.run({
model: 'google:3@2',
positivePrompt: 'A cinematic 8-second evolution between two anchored frames: begin at a tranquil cliffside lighthouse at twilight with glowing bioluminescent flowers and tide pools, then gradually transform into a stormy midnight seascape while preserving the same location, composition, and lighthouse identity. The camera performs a subtle slow push-in from a wide shot. Wind rises through the grass, fog thickens, waves become rougher, the lighthouse beacon starts rotating, seabirds disappear, clouds gather, rain begins lightly and intensifies, and a distant lightning flash reveals dramatic ocean spray near the end. Natural, physically believable motion, rich environmental detail, cohesive continuity between frames, high-fidelity cinematic realism, atmospheric depth, volumetric mist, dynamic water simulation, synchronized ambient audio with ocean surf, wind, faint gulls at the start, then thunder, rain, and the lighthouse horn in the final moments.',
width: 1920,
height: 1080,
duration: 8,
seed: 21150,
providerSettings: {
google: {
enhancePrompt: true,
generateAudio: true
}
},
inputs: {
frameImages: [
{
inputImage: 'https://assets.runware.ai/assets/inputs/17246021-8303-4a4c-8a50-6c14f28d1162.jpg',
frame: 'first'
},
{
inputImage: 'https://assets.runware.ai/assets/inputs/dad0315b-c7b4-41b4-aeea-014069121823.jpg',
frame: 'last'
}
]
}
})import asyncio
import os
from runware import Runware
async def main():
async with Runware(api_key=os.environ["RUNWARE_API_KEY"]) as client:
results = await client.run({
"model": "google:3@2",
"positivePrompt": "A cinematic 8-second evolution between two anchored frames: begin at a tranquil cliffside lighthouse at twilight with glowing bioluminescent flowers and tide pools, then gradually transform into a stormy midnight seascape while preserving the same location, composition, and lighthouse identity. The camera performs a subtle slow push-in from a wide shot. Wind rises through the grass, fog thickens, waves become rougher, the lighthouse beacon starts rotating, seabirds disappear, clouds gather, rain begins lightly and intensifies, and a distant lightning flash reveals dramatic ocean spray near the end. Natural, physically believable motion, rich environmental detail, cohesive continuity between frames, high-fidelity cinematic realism, atmospheric depth, volumetric mist, dynamic water simulation, synchronized ambient audio with ocean surf, wind, faint gulls at the start, then thunder, rain, and the lighthouse horn in the final moments.",
"width": 1920,
"height": 1080,
"duration": 8,
"seed": 21150,
"providerSettings": {
"google": {
"enhancePrompt": True,
"generateAudio": True
}
},
"inputs": {
"frameImages": [
{
"inputImage": "https://assets.runware.ai/assets/inputs/17246021-8303-4a4c-8a50-6c14f28d1162.jpg",
"frame": "first"
},
{
"inputImage": "https://assets.runware.ai/assets/inputs/dad0315b-c7b4-41b4-aeea-014069121823.jpg",
"frame": "last"
}
]
}
})
asyncio.run(main())curl https://api.runware.ai/v1 \
-H "Authorization: Bearer $RUNWARE_API_KEY" \
-H "Content-Type: application/json" \
-d '[
{
"taskType": "videoInference",
"taskUUID": "f212d8ca-ed2d-43f8-9ca5-00f725c866bb",
"model": "google:3@2",
"positivePrompt": "A cinematic 8-second evolution between two anchored frames: begin at a tranquil cliffside lighthouse at twilight with glowing bioluminescent flowers and tide pools, then gradually transform into a stormy midnight seascape while preserving the same location, composition, and lighthouse identity. The camera performs a subtle slow push-in from a wide shot. Wind rises through the grass, fog thickens, waves become rougher, the lighthouse beacon starts rotating, seabirds disappear, clouds gather, rain begins lightly and intensifies, and a distant lightning flash reveals dramatic ocean spray near the end. Natural, physically believable motion, rich environmental detail, cohesive continuity between frames, high-fidelity cinematic realism, atmospheric depth, volumetric mist, dynamic water simulation, synchronized ambient audio with ocean surf, wind, faint gulls at the start, then thunder, rain, and the lighthouse horn in the final moments.",
"width": 1920,
"height": 1080,
"duration": 8,
"seed": 21150,
"providerSettings": {
"google": {
"enhancePrompt": true,
"generateAudio": true
}
},
"inputs": {
"frameImages": [
{
"inputImage": "https://assets.runware.ai/assets/inputs/17246021-8303-4a4c-8a50-6c14f28d1162.jpg",
"frame": "first"
},
{
"inputImage": "https://assets.runware.ai/assets/inputs/dad0315b-c7b4-41b4-aeea-014069121823.jpg",
"frame": "last"
}
]
}
}
]'runware run google:3@2 \
positivePrompt="A cinematic 8-second evolution between two anchored frames: begin at a tranquil cliffside lighthouse at twilight with glowing bioluminescent flowers and tide pools, then gradually transform into a stormy midnight seascape while preserving the same location, composition, and lighthouse identity. The camera performs a subtle slow push-in from a wide shot. Wind rises through the grass, fog thickens, waves become rougher, the lighthouse beacon starts rotating, seabirds disappear, clouds gather, rain begins lightly and intensifies, and a distant lightning flash reveals dramatic ocean spray near the end. Natural, physically believable motion, rich environmental detail, cohesive continuity between frames, high-fidelity cinematic realism, atmospheric depth, volumetric mist, dynamic water simulation, synchronized ambient audio with ocean surf, wind, faint gulls at the start, then thunder, rain, and the lighthouse horn in the final moments." \
width=1920 \
height=1080 \
duration=8 \
seed=21150 \
providerSettings.google.enhancePrompt=true \
providerSettings.google.generateAudio=true \
inputs.frameImages.0.inputImage=https://assets.runware.ai/assets/inputs/17246021-8303-4a4c-8a50-6c14f28d1162.jpg \
inputs.frameImages.0.frame=first \
inputs.frameImages.1.inputImage=https://assets.runware.ai/assets/inputs/dad0315b-c7b4-41b4-aeea-014069121823.jpg \
inputs.frameImages.1.frame=last{
"taskType": "videoInference",
"taskUUID": "f212d8ca-ed2d-43f8-9ca5-00f725c866bb",
"model": "google:3@2",
"positivePrompt": "A cinematic 8-second evolution between two anchored frames: begin at a tranquil cliffside lighthouse at twilight with glowing bioluminescent flowers and tide pools, then gradually transform into a stormy midnight seascape while preserving the same location, composition, and lighthouse identity. The camera performs a subtle slow push-in from a wide shot. Wind rises through the grass, fog thickens, waves become rougher, the lighthouse beacon starts rotating, seabirds disappear, clouds gather, rain begins lightly and intensifies, and a distant lightning flash reveals dramatic ocean spray near the end. Natural, physically believable motion, rich environmental detail, cohesive continuity between frames, high-fidelity cinematic realism, atmospheric depth, volumetric mist, dynamic water simulation, synchronized ambient audio with ocean surf, wind, faint gulls at the start, then thunder, rain, and the lighthouse horn in the final moments.",
"width": 1920,
"height": 1080,
"duration": 8,
"seed": 21150,
"providerSettings": {
"google": {
"enhancePrompt": true,
"generateAudio": true
}
},
"inputs": {
"frameImages": [
{
"inputImage": "https://assets.runware.ai/assets/inputs/17246021-8303-4a4c-8a50-6c14f28d1162.jpg",
"frame": "first"
},
{
"inputImage": "https://assets.runware.ai/assets/inputs/dad0315b-c7b4-41b4-aeea-014069121823.jpg",
"frame": "last"
}
]
}
}{
"taskType": "videoInference",
"taskUUID": "f212d8ca-ed2d-43f8-9ca5-00f725c866bb",
"videoUUID": "43fb21c7-2c81-4dfe-9ea1-b22222ee06c6",
"videoURL": "https://vm.runware.ai/video/os/a18d05/ws/5/vi/43fb21c7-2c81-4dfe-9ea1-b22222ee06c6.mp4",
"seed": 21150,
"cost": 3.2
}