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
Examples5
CODE
Ready-to-use code snippets for common workflows
text-to-video
Ultrasonic Vinyl Cleaning Social Reel$1.60~1m 30simport { 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: 'Create a polished four-second landscape social video ad for a professional ultrasonic vinyl-record cleaning service. One continuous extreme-macro shot inside a refined record-cleaning studio with a retro 1970s hi-fi aesthetic: brushed aluminum, smoked acrylic, warm cream highlights, deep burgundy shadows. A dusty translucent red vinyl record rotates vertically through a narrow ultrasonic bath. Begin tight on lint and fingerprints clinging to the illuminated grooves as the camera tracks smoothly alongside the spinning surface. At one second, the record enters the liquid; perfectly synchronized concentric ripples shimmer across the bath, microscopic dust blooms away from the grooves, and a slim metal cleaning arm glides into frame. Follow the rotation as the vinyl emerges visibly spotless, glossy, and jewel-like, catching a sharp ribbon of warm light. End on the pristine grooves sweeping past the lens with confident commercial polish. Shallow depth of field, tactile photorealism, precise mechanical movement, restrained premium color grade, no people, no text, no logos. Synchronized sound: faint dusty record crackle at the opening, a crisp mechanical click as the cleaner engages, soft ultrasonic hum and liquid fizz during cleaning, then the crackle resolves into one rich, clean soul-jazz chord on the spotless reveal.',
width: 1920,
height: 1080,
duration: 4,
providerSettings: {
google: {
generateAudio: true
}
}
})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": "Create a polished four-second landscape social video ad for a professional ultrasonic vinyl-record cleaning service. One continuous extreme-macro shot inside a refined record-cleaning studio with a retro 1970s hi-fi aesthetic: brushed aluminum, smoked acrylic, warm cream highlights, deep burgundy shadows. A dusty translucent red vinyl record rotates vertically through a narrow ultrasonic bath. Begin tight on lint and fingerprints clinging to the illuminated grooves as the camera tracks smoothly alongside the spinning surface. At one second, the record enters the liquid; perfectly synchronized concentric ripples shimmer across the bath, microscopic dust blooms away from the grooves, and a slim metal cleaning arm glides into frame. Follow the rotation as the vinyl emerges visibly spotless, glossy, and jewel-like, catching a sharp ribbon of warm light. End on the pristine grooves sweeping past the lens with confident commercial polish. Shallow depth of field, tactile photorealism, precise mechanical movement, restrained premium color grade, no people, no text, no logos. Synchronized sound: faint dusty record crackle at the opening, a crisp mechanical click as the cleaner engages, soft ultrasonic hum and liquid fizz during cleaning, then the crackle resolves into one rich, clean soul-jazz chord on the spotless reveal.",
"width": 1920,
"height": 1080,
"duration": 4,
"providerSettings": {
"google": {
"generateAudio": True
}
}
})
asyncio.run(main())curl https://api.runware.ai/v1 \
-H "Authorization: Bearer $RUNWARE_API_KEY" \
-H "Content-Type: application/json" \
-d '[
{
"taskType": "videoInference",
"taskUUID": "72d3cad0-f9c2-4040-bbc1-754406323614",
"model": "google:3@2",
"positivePrompt": "Create a polished four-second landscape social video ad for a professional ultrasonic vinyl-record cleaning service. One continuous extreme-macro shot inside a refined record-cleaning studio with a retro 1970s hi-fi aesthetic: brushed aluminum, smoked acrylic, warm cream highlights, deep burgundy shadows. A dusty translucent red vinyl record rotates vertically through a narrow ultrasonic bath. Begin tight on lint and fingerprints clinging to the illuminated grooves as the camera tracks smoothly alongside the spinning surface. At one second, the record enters the liquid; perfectly synchronized concentric ripples shimmer across the bath, microscopic dust blooms away from the grooves, and a slim metal cleaning arm glides into frame. Follow the rotation as the vinyl emerges visibly spotless, glossy, and jewel-like, catching a sharp ribbon of warm light. End on the pristine grooves sweeping past the lens with confident commercial polish. Shallow depth of field, tactile photorealism, precise mechanical movement, restrained premium color grade, no people, no text, no logos. Synchronized sound: faint dusty record crackle at the opening, a crisp mechanical click as the cleaner engages, soft ultrasonic hum and liquid fizz during cleaning, then the crackle resolves into one rich, clean soul-jazz chord on the spotless reveal.",
"width": 1920,
"height": 1080,
"duration": 4,
"providerSettings": {
"google": {
"generateAudio": true
}
}
}
]'runware run google:3@2 \
positivePrompt="Create a polished four-second landscape social video ad for a professional ultrasonic vinyl-record cleaning service. One continuous extreme-macro shot inside a refined record-cleaning studio with a retro 1970s hi-fi aesthetic: brushed aluminum, smoked acrylic, warm cream highlights, deep burgundy shadows. A dusty translucent red vinyl record rotates vertically through a narrow ultrasonic bath. Begin tight on lint and fingerprints clinging to the illuminated grooves as the camera tracks smoothly alongside the spinning surface. At one second, the record enters the liquid; perfectly synchronized concentric ripples shimmer across the bath, microscopic dust blooms away from the grooves, and a slim metal cleaning arm glides into frame. Follow the rotation as the vinyl emerges visibly spotless, glossy, and jewel-like, catching a sharp ribbon of warm light. End on the pristine grooves sweeping past the lens with confident commercial polish. Shallow depth of field, tactile photorealism, precise mechanical movement, restrained premium color grade, no people, no text, no logos. Synchronized sound: faint dusty record crackle at the opening, a crisp mechanical click as the cleaner engages, soft ultrasonic hum and liquid fizz during cleaning, then the crackle resolves into one rich, clean soul-jazz chord on the spotless reveal." \
width=1920 \
height=1080 \
duration=4 \
providerSettings.google.generateAudio=true{
"taskType": "videoInference",
"taskUUID": "72d3cad0-f9c2-4040-bbc1-754406323614",
"model": "google:3@2",
"positivePrompt": "Create a polished four-second landscape social video ad for a professional ultrasonic vinyl-record cleaning service. One continuous extreme-macro shot inside a refined record-cleaning studio with a retro 1970s hi-fi aesthetic: brushed aluminum, smoked acrylic, warm cream highlights, deep burgundy shadows. A dusty translucent red vinyl record rotates vertically through a narrow ultrasonic bath. Begin tight on lint and fingerprints clinging to the illuminated grooves as the camera tracks smoothly alongside the spinning surface. At one second, the record enters the liquid; perfectly synchronized concentric ripples shimmer across the bath, microscopic dust blooms away from the grooves, and a slim metal cleaning arm glides into frame. Follow the rotation as the vinyl emerges visibly spotless, glossy, and jewel-like, catching a sharp ribbon of warm light. End on the pristine grooves sweeping past the lens with confident commercial polish. Shallow depth of field, tactile photorealism, precise mechanical movement, restrained premium color grade, no people, no text, no logos. Synchronized sound: faint dusty record crackle at the opening, a crisp mechanical click as the cleaner engages, soft ultrasonic hum and liquid fizz during cleaning, then the crackle resolves into one rich, clean soul-jazz chord on the spotless reveal.",
"width": 1920,
"height": 1080,
"duration": 4,
"providerSettings": {
"google": {
"generateAudio": true
}
}
}Response
{
"taskType": "videoInference",
"taskUUID": "72d3cad0-f9c2-4040-bbc1-754406323614",
"videoUUID": "d5e1709f-6e96-4245-8ae6-e954bd1adb8c",
"videoURL": "https://vm.runware.ai/video/os/a08dlim3/ws/5/vi/d5e1709f-6e96-4245-8ae6-e954bd1adb8c.mp4",
"seed": 734251117,
"cost": 1.6
}first-frame
Oyster Grading Machine Demo$2.40~58simport { 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: 'Create a polished single-shot product demonstration for an aquaculture equipment supplier. Begin from the provided first frame exactly, preserving the worker, oyster basket, stainless-steel grader, seafoam rollers, coral collection crates, lighting, spatial layout, and three-quarter camera angle. The worker smoothly tips the basket forward and wet oysters tumble into the feed hopper. The motor starts; rollers rotate steadily and carry the oysters toward camera-right. Small oysters drop first into the nearest crate, medium oysters fall into the center crate, and the largest continue to the final crate, clearly demonstrating progressive size grading. Keep the sorting physically accurate: shells roll and jostle with believable weight, occasional seawater droplets catch the light, and each oyster falls only when it reaches the appropriate roller gap. Use a subtle slow dolly forward while keeping the entire sorting path and all three crates visible. Bright, practical coastal workshop atmosphere; cool silver and seafoam palette with restrained coral accents; premium industrial documentary realism rather than an advertisement. End with several oysters still moving through the rollers and visibly separated batches accumulating below. Native synchronized audio: gentle electric motor hum, rhythmic clatter of shells on steel rollers, shells landing in plastic crates, faint gulls and harbor ambience through the open bay. No speech, music, text, logos, graphics, cuts, time-lapse, slow motion, extra limbs, or camera shake.',
resolution: '720p',
duration: 6,
providerSettings: {
google: {
resizeMode: 'crop',
generateAudio: true
}
},
inputs: {
frameImages: [
{
image: 'https://assets.runware.ai/assets/inputs/c9155a93-c15d-4ecb-badf-b7ffdd435529.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": "Create a polished single-shot product demonstration for an aquaculture equipment supplier. Begin from the provided first frame exactly, preserving the worker, oyster basket, stainless-steel grader, seafoam rollers, coral collection crates, lighting, spatial layout, and three-quarter camera angle. The worker smoothly tips the basket forward and wet oysters tumble into the feed hopper. The motor starts; rollers rotate steadily and carry the oysters toward camera-right. Small oysters drop first into the nearest crate, medium oysters fall into the center crate, and the largest continue to the final crate, clearly demonstrating progressive size grading. Keep the sorting physically accurate: shells roll and jostle with believable weight, occasional seawater droplets catch the light, and each oyster falls only when it reaches the appropriate roller gap. Use a subtle slow dolly forward while keeping the entire sorting path and all three crates visible. Bright, practical coastal workshop atmosphere; cool silver and seafoam palette with restrained coral accents; premium industrial documentary realism rather than an advertisement. End with several oysters still moving through the rollers and visibly separated batches accumulating below. Native synchronized audio: gentle electric motor hum, rhythmic clatter of shells on steel rollers, shells landing in plastic crates, faint gulls and harbor ambience through the open bay. No speech, music, text, logos, graphics, cuts, time-lapse, slow motion, extra limbs, or camera shake.",
"resolution": "720p",
"duration": 6,
"providerSettings": {
"google": {
"resizeMode": "crop",
"generateAudio": True
}
},
"inputs": {
"frameImages": [
{
"image": "https://assets.runware.ai/assets/inputs/c9155a93-c15d-4ecb-badf-b7ffdd435529.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": "2e56a6d2-f9a8-4a48-8262-1d259110acb5",
"model": "google:3@2",
"positivePrompt": "Create a polished single-shot product demonstration for an aquaculture equipment supplier. Begin from the provided first frame exactly, preserving the worker, oyster basket, stainless-steel grader, seafoam rollers, coral collection crates, lighting, spatial layout, and three-quarter camera angle. The worker smoothly tips the basket forward and wet oysters tumble into the feed hopper. The motor starts; rollers rotate steadily and carry the oysters toward camera-right. Small oysters drop first into the nearest crate, medium oysters fall into the center crate, and the largest continue to the final crate, clearly demonstrating progressive size grading. Keep the sorting physically accurate: shells roll and jostle with believable weight, occasional seawater droplets catch the light, and each oyster falls only when it reaches the appropriate roller gap. Use a subtle slow dolly forward while keeping the entire sorting path and all three crates visible. Bright, practical coastal workshop atmosphere; cool silver and seafoam palette with restrained coral accents; premium industrial documentary realism rather than an advertisement. End with several oysters still moving through the rollers and visibly separated batches accumulating below. Native synchronized audio: gentle electric motor hum, rhythmic clatter of shells on steel rollers, shells landing in plastic crates, faint gulls and harbor ambience through the open bay. No speech, music, text, logos, graphics, cuts, time-lapse, slow motion, extra limbs, or camera shake.",
"resolution": "720p",
"duration": 6,
"providerSettings": {
"google": {
"resizeMode": "crop",
"generateAudio": true
}
},
"inputs": {
"frameImages": [
{
"image": "https://assets.runware.ai/assets/inputs/c9155a93-c15d-4ecb-badf-b7ffdd435529.jpg",
"frame": "first"
}
]
}
}
]'runware run google:3@2 \
positivePrompt="Create a polished single-shot product demonstration for an aquaculture equipment supplier. Begin from the provided first frame exactly, preserving the worker, oyster basket, stainless-steel grader, seafoam rollers, coral collection crates, lighting, spatial layout, and three-quarter camera angle. The worker smoothly tips the basket forward and wet oysters tumble into the feed hopper. The motor starts; rollers rotate steadily and carry the oysters toward camera-right. Small oysters drop first into the nearest crate, medium oysters fall into the center crate, and the largest continue to the final crate, clearly demonstrating progressive size grading. Keep the sorting physically accurate: shells roll and jostle with believable weight, occasional seawater droplets catch the light, and each oyster falls only when it reaches the appropriate roller gap. Use a subtle slow dolly forward while keeping the entire sorting path and all three crates visible. Bright, practical coastal workshop atmosphere; cool silver and seafoam palette with restrained coral accents; premium industrial documentary realism rather than an advertisement. End with several oysters still moving through the rollers and visibly separated batches accumulating below. Native synchronized audio: gentle electric motor hum, rhythmic clatter of shells on steel rollers, shells landing in plastic crates, faint gulls and harbor ambience through the open bay. No speech, music, text, logos, graphics, cuts, time-lapse, slow motion, extra limbs, or camera shake." \
resolution=720p \
duration=6 \
providerSettings.google.resizeMode=crop \
providerSettings.google.generateAudio=true \
inputs.frameImages.0.image=https://assets.runware.ai/assets/inputs/c9155a93-c15d-4ecb-badf-b7ffdd435529.jpg \
inputs.frameImages.0.frame=first{
"taskType": "videoInference",
"taskUUID": "2e56a6d2-f9a8-4a48-8262-1d259110acb5",
"model": "google:3@2",
"positivePrompt": "Create a polished single-shot product demonstration for an aquaculture equipment supplier. Begin from the provided first frame exactly, preserving the worker, oyster basket, stainless-steel grader, seafoam rollers, coral collection crates, lighting, spatial layout, and three-quarter camera angle. The worker smoothly tips the basket forward and wet oysters tumble into the feed hopper. The motor starts; rollers rotate steadily and carry the oysters toward camera-right. Small oysters drop first into the nearest crate, medium oysters fall into the center crate, and the largest continue to the final crate, clearly demonstrating progressive size grading. Keep the sorting physically accurate: shells roll and jostle with believable weight, occasional seawater droplets catch the light, and each oyster falls only when it reaches the appropriate roller gap. Use a subtle slow dolly forward while keeping the entire sorting path and all three crates visible. Bright, practical coastal workshop atmosphere; cool silver and seafoam palette with restrained coral accents; premium industrial documentary realism rather than an advertisement. End with several oysters still moving through the rollers and visibly separated batches accumulating below. Native synchronized audio: gentle electric motor hum, rhythmic clatter of shells on steel rollers, shells landing in plastic crates, faint gulls and harbor ambience through the open bay. No speech, music, text, logos, graphics, cuts, time-lapse, slow motion, extra limbs, or camera shake.",
"resolution": "720p",
"duration": 6,
"providerSettings": {
"google": {
"resizeMode": "crop",
"generateAudio": true
}
},
"inputs": {
"frameImages": [
{
"image": "https://assets.runware.ai/assets/inputs/c9155a93-c15d-4ecb-badf-b7ffdd435529.jpg",
"frame": "first"
}
]
}
}Response
{
"taskType": "videoInference",
"taskUUID": "2e56a6d2-f9a8-4a48-8262-1d259110acb5",
"videoUUID": "eeeadd55-dec1-48a9-93cb-c940958fd886",
"videoURL": "https://vm.runware.ai/video/os/a02d21/ws/5/vi/eeeadd55-dec1-48a9-93cb-c940958fd886.mp4",
"seed": 1271036451,
"cost": 2.4
}first-last-frame
Underwater Camera Housing Colorway Reveal$2.40~1m 20simport { 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: 'Create a polished six-second colorway reveal for a professional underwater cinema-camera housing. Begin exactly from the supplied first frame: the safety-orange housing centered on its volcanic-stone slab inside the dark navy test tank. Preserve the product\'s precise identity, proportions and components throughout, including the glass dome, handles, controls, fasteners and monitor mount.\n\nThe camera makes one smooth, slow arc from the front-left view toward the front-right view, traveling consistently to the right with subtle parallax. At the same time, a controlled curtain of aerated water enters from the left and sweeps across the housing toward the right. As this opaque ribbon of bubbles crosses each exterior aluminum panel, use it as a seamless practical wipe: the panel emerges behind it in the new matte kelp-green colorway. The recolor must progress continuously from left to right rather than flashing or morphing. Only the orange aluminum shell changes color; the black handles and controls, steel hardware, transparent dome glass, stone slab and environment remain unchanged. Keep the housing rigid and mechanically accurate with no warping, replacement parts or extra controls.\n\nAs the bubble curtain clears, reduce the turbulence to a few rising microbubbles and let cyan caustic highlights travel naturally over the new green finish. Complete the camera arc and settle exactly into the supplied last frame, holding the finished kelp-green product clearly for the final moment. Maintain premium commercial-product sharpness, deep navy negative space, restrained cyan illumination and realistic underwater refraction. No people, hands, logos, captions or on-screen text.\n\nSynchronized native audio only: a soft underwater rush moving left to right with the bubble curtain, delicate bubble crackle, a subdued waterproof camera-rig motor hum during the arc, then calm filtered tank ambience at the finish. No speech and no music.',
resolution: '720p',
duration: 6,
providerSettings: {
google: {
generateAudio: true
}
},
inputs: {
frameImages: [
{
image: 'https://assets.runware.ai/assets/inputs/daa8b042-aff3-47c1-b5e5-e041a526b815.jpg',
frame: 'first'
},
{
image: 'https://assets.runware.ai/assets/inputs/e83b9d23-45fb-46a2-87aa-ed3b1ff854ed.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": "Create a polished six-second colorway reveal for a professional underwater cinema-camera housing. Begin exactly from the supplied first frame: the safety-orange housing centered on its volcanic-stone slab inside the dark navy test tank. Preserve the product's precise identity, proportions and components throughout, including the glass dome, handles, controls, fasteners and monitor mount.\n\nThe camera makes one smooth, slow arc from the front-left view toward the front-right view, traveling consistently to the right with subtle parallax. At the same time, a controlled curtain of aerated water enters from the left and sweeps across the housing toward the right. As this opaque ribbon of bubbles crosses each exterior aluminum panel, use it as a seamless practical wipe: the panel emerges behind it in the new matte kelp-green colorway. The recolor must progress continuously from left to right rather than flashing or morphing. Only the orange aluminum shell changes color; the black handles and controls, steel hardware, transparent dome glass, stone slab and environment remain unchanged. Keep the housing rigid and mechanically accurate with no warping, replacement parts or extra controls.\n\nAs the bubble curtain clears, reduce the turbulence to a few rising microbubbles and let cyan caustic highlights travel naturally over the new green finish. Complete the camera arc and settle exactly into the supplied last frame, holding the finished kelp-green product clearly for the final moment. Maintain premium commercial-product sharpness, deep navy negative space, restrained cyan illumination and realistic underwater refraction. No people, hands, logos, captions or on-screen text.\n\nSynchronized native audio only: a soft underwater rush moving left to right with the bubble curtain, delicate bubble crackle, a subdued waterproof camera-rig motor hum during the arc, then calm filtered tank ambience at the finish. No speech and no music.",
"resolution": "720p",
"duration": 6,
"providerSettings": {
"google": {
"generateAudio": True
}
},
"inputs": {
"frameImages": [
{
"image": "https://assets.runware.ai/assets/inputs/daa8b042-aff3-47c1-b5e5-e041a526b815.jpg",
"frame": "first"
},
{
"image": "https://assets.runware.ai/assets/inputs/e83b9d23-45fb-46a2-87aa-ed3b1ff854ed.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": "1a737e8e-6035-48da-9dd4-9da95455e6e5",
"model": "google:3@2",
"positivePrompt": "Create a polished six-second colorway reveal for a professional underwater cinema-camera housing. Begin exactly from the supplied first frame: the safety-orange housing centered on its volcanic-stone slab inside the dark navy test tank. Preserve the product's precise identity, proportions and components throughout, including the glass dome, handles, controls, fasteners and monitor mount.\n\nThe camera makes one smooth, slow arc from the front-left view toward the front-right view, traveling consistently to the right with subtle parallax. At the same time, a controlled curtain of aerated water enters from the left and sweeps across the housing toward the right. As this opaque ribbon of bubbles crosses each exterior aluminum panel, use it as a seamless practical wipe: the panel emerges behind it in the new matte kelp-green colorway. The recolor must progress continuously from left to right rather than flashing or morphing. Only the orange aluminum shell changes color; the black handles and controls, steel hardware, transparent dome glass, stone slab and environment remain unchanged. Keep the housing rigid and mechanically accurate with no warping, replacement parts or extra controls.\n\nAs the bubble curtain clears, reduce the turbulence to a few rising microbubbles and let cyan caustic highlights travel naturally over the new green finish. Complete the camera arc and settle exactly into the supplied last frame, holding the finished kelp-green product clearly for the final moment. Maintain premium commercial-product sharpness, deep navy negative space, restrained cyan illumination and realistic underwater refraction. No people, hands, logos, captions or on-screen text.\n\nSynchronized native audio only: a soft underwater rush moving left to right with the bubble curtain, delicate bubble crackle, a subdued waterproof camera-rig motor hum during the arc, then calm filtered tank ambience at the finish. No speech and no music.",
"resolution": "720p",
"duration": 6,
"providerSettings": {
"google": {
"generateAudio": true
}
},
"inputs": {
"frameImages": [
{
"image": "https://assets.runware.ai/assets/inputs/daa8b042-aff3-47c1-b5e5-e041a526b815.jpg",
"frame": "first"
},
{
"image": "https://assets.runware.ai/assets/inputs/e83b9d23-45fb-46a2-87aa-ed3b1ff854ed.jpg",
"frame": "last"
}
]
}
}
]'runware run google:3@2 \
positivePrompt="Create a polished six-second colorway reveal for a professional underwater cinema-camera housing. Begin exactly from the supplied first frame: the safety-orange housing centered on its volcanic-stone slab inside the dark navy test tank. Preserve the product's precise identity, proportions and components throughout, including the glass dome, handles, controls, fasteners and monitor mount.
The camera makes one smooth, slow arc from the front-left view toward the front-right view, traveling consistently to the right with subtle parallax. At the same time, a controlled curtain of aerated water enters from the left and sweeps across the housing toward the right. As this opaque ribbon of bubbles crosses each exterior aluminum panel, use it as a seamless practical wipe: the panel emerges behind it in the new matte kelp-green colorway. The recolor must progress continuously from left to right rather than flashing or morphing. Only the orange aluminum shell changes color; the black handles and controls, steel hardware, transparent dome glass, stone slab and environment remain unchanged. Keep the housing rigid and mechanically accurate with no warping, replacement parts or extra controls.
As the bubble curtain clears, reduce the turbulence to a few rising microbubbles and let cyan caustic highlights travel naturally over the new green finish. Complete the camera arc and settle exactly into the supplied last frame, holding the finished kelp-green product clearly for the final moment. Maintain premium commercial-product sharpness, deep navy negative space, restrained cyan illumination and realistic underwater refraction. No people, hands, logos, captions or on-screen text.
Synchronized native audio only: a soft underwater rush moving left to right with the bubble curtain, delicate bubble crackle, a subdued waterproof camera-rig motor hum during the arc, then calm filtered tank ambience at the finish. No speech and no music." \
resolution=720p \
duration=6 \
providerSettings.google.generateAudio=true \
inputs.frameImages.0.image=https://assets.runware.ai/assets/inputs/daa8b042-aff3-47c1-b5e5-e041a526b815.jpg \
inputs.frameImages.0.frame=first \
inputs.frameImages.1.image=https://assets.runware.ai/assets/inputs/e83b9d23-45fb-46a2-87aa-ed3b1ff854ed.jpg \
inputs.frameImages.1.frame=last{
"taskType": "videoInference",
"taskUUID": "1a737e8e-6035-48da-9dd4-9da95455e6e5",
"model": "google:3@2",
"positivePrompt": "Create a polished six-second colorway reveal for a professional underwater cinema-camera housing. Begin exactly from the supplied first frame: the safety-orange housing centered on its volcanic-stone slab inside the dark navy test tank. Preserve the product's precise identity, proportions and components throughout, including the glass dome, handles, controls, fasteners and monitor mount.\n\nThe camera makes one smooth, slow arc from the front-left view toward the front-right view, traveling consistently to the right with subtle parallax. At the same time, a controlled curtain of aerated water enters from the left and sweeps across the housing toward the right. As this opaque ribbon of bubbles crosses each exterior aluminum panel, use it as a seamless practical wipe: the panel emerges behind it in the new matte kelp-green colorway. The recolor must progress continuously from left to right rather than flashing or morphing. Only the orange aluminum shell changes color; the black handles and controls, steel hardware, transparent dome glass, stone slab and environment remain unchanged. Keep the housing rigid and mechanically accurate with no warping, replacement parts or extra controls.\n\nAs the bubble curtain clears, reduce the turbulence to a few rising microbubbles and let cyan caustic highlights travel naturally over the new green finish. Complete the camera arc and settle exactly into the supplied last frame, holding the finished kelp-green product clearly for the final moment. Maintain premium commercial-product sharpness, deep navy negative space, restrained cyan illumination and realistic underwater refraction. No people, hands, logos, captions or on-screen text.\n\nSynchronized native audio only: a soft underwater rush moving left to right with the bubble curtain, delicate bubble crackle, a subdued waterproof camera-rig motor hum during the arc, then calm filtered tank ambience at the finish. No speech and no music.",
"resolution": "720p",
"duration": 6,
"providerSettings": {
"google": {
"generateAudio": true
}
},
"inputs": {
"frameImages": [
{
"image": "https://assets.runware.ai/assets/inputs/daa8b042-aff3-47c1-b5e5-e041a526b815.jpg",
"frame": "first"
},
{
"image": "https://assets.runware.ai/assets/inputs/e83b9d23-45fb-46a2-87aa-ed3b1ff854ed.jpg",
"frame": "last"
}
]
}
}Response
{
"taskType": "videoInference",
"taskUUID": "1a737e8e-6035-48da-9dd4-9da95455e6e5",
"videoUUID": "ba3d0f30-054f-44cd-82d9-c3518980f7d5",
"videoURL": "https://vm.runware.ai/video/os/a10dlim3/ws/5/vi/ba3d0f30-054f-44cd-82d9-c3518980f7d5.mp4",
"seed": 349345168,
"cost": 2.4
}reference-to-video
Antique Automaton Background Replacement$3.20~1m 32simport { 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: 'Create a finished 8-second vertical auction-house showcase using all three reference images only as identity and design references for the same antique singing-bird automaton; none of the references is a first frame. Preserve the exact kingfisher proportions, iridescent teal feathers, rust-orange breast, black beak and glass eyes, gilt branch, winding key, engraved fern motifs, dark green enamel panels, porcelain water lily, age patina, and mechanical construction throughout.\n\nReplace the plain studio surroundings completely with a refined Belle Époque conservatory at early morning. The automaton stands naturally on a slim veined-cream-marble pedestal among out-of-focus palms, wrought-iron window frames, pale condensation on glass panes, and restrained botanical shadows. Warm low sunlight passes through the foliage, creating soft moving highlights across the brass and enamel. Use an elegant palette of verdigris, cream, aged gold, dusty coral, and fresh leaf green. The result should feel like a premium provenance-film insert for a specialist mechanical-arts auction, not fantasy.\n\nOne continuous cinematic shot composed for 9:16. Begin with a close full view of the automaton centered in the lower two-thirds, then perform a very slow clockwise camera arc and subtle push-in. After two seconds, the mechanism activates: the bird turns its head once, opens its beak, gently flutters its wings, and flicks its tail while remaining securely attached to the branch. Keep motion precise, delicate, and mechanically plausible. A faint breeze moves only the conservatory leaves and shifting sunlight in the replacement background. Maintain clean, believable contact shadows on the marble, accurate reflections, stable object geometry, and crisp separation around every feather and winding key. Shallow depth of field, polished 35mm commercial cinematography, realistic materials, no people, no lettering, no logos, no borders. Synchronized audio: quiet glasshouse room tone, distant morning birds, tiny clockwork clicks and whirs, followed by two delicate mechanical bird chirps.',
width: 1080,
height: 1920,
duration: 8,
providerSettings: {
google: {
generateAudio: true
}
},
inputs: {
referenceImages: [
'https://assets.runware.ai/assets/inputs/7b2556e1-31aa-4832-8281-cb43dd19fc39.jpg',
'https://assets.runware.ai/assets/inputs/5da88154-aa2c-4ccd-b71b-06ac3092115d.jpg',
'https://assets.runware.ai/assets/inputs/5e73dfd0-ed7c-44f9-9df0-a17a56f002f9.jpg'
]
}
})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": "Create a finished 8-second vertical auction-house showcase using all three reference images only as identity and design references for the same antique singing-bird automaton; none of the references is a first frame. Preserve the exact kingfisher proportions, iridescent teal feathers, rust-orange breast, black beak and glass eyes, gilt branch, winding key, engraved fern motifs, dark green enamel panels, porcelain water lily, age patina, and mechanical construction throughout.\n\nReplace the plain studio surroundings completely with a refined Belle Époque conservatory at early morning. The automaton stands naturally on a slim veined-cream-marble pedestal among out-of-focus palms, wrought-iron window frames, pale condensation on glass panes, and restrained botanical shadows. Warm low sunlight passes through the foliage, creating soft moving highlights across the brass and enamel. Use an elegant palette of verdigris, cream, aged gold, dusty coral, and fresh leaf green. The result should feel like a premium provenance-film insert for a specialist mechanical-arts auction, not fantasy.\n\nOne continuous cinematic shot composed for 9:16. Begin with a close full view of the automaton centered in the lower two-thirds, then perform a very slow clockwise camera arc and subtle push-in. After two seconds, the mechanism activates: the bird turns its head once, opens its beak, gently flutters its wings, and flicks its tail while remaining securely attached to the branch. Keep motion precise, delicate, and mechanically plausible. A faint breeze moves only the conservatory leaves and shifting sunlight in the replacement background. Maintain clean, believable contact shadows on the marble, accurate reflections, stable object geometry, and crisp separation around every feather and winding key. Shallow depth of field, polished 35mm commercial cinematography, realistic materials, no people, no lettering, no logos, no borders. Synchronized audio: quiet glasshouse room tone, distant morning birds, tiny clockwork clicks and whirs, followed by two delicate mechanical bird chirps.",
"width": 1080,
"height": 1920,
"duration": 8,
"providerSettings": {
"google": {
"generateAudio": True
}
},
"inputs": {
"referenceImages": [
"https://assets.runware.ai/assets/inputs/7b2556e1-31aa-4832-8281-cb43dd19fc39.jpg",
"https://assets.runware.ai/assets/inputs/5da88154-aa2c-4ccd-b71b-06ac3092115d.jpg",
"https://assets.runware.ai/assets/inputs/5e73dfd0-ed7c-44f9-9df0-a17a56f002f9.jpg"
]
}
})
asyncio.run(main())curl https://api.runware.ai/v1 \
-H "Authorization: Bearer $RUNWARE_API_KEY" \
-H "Content-Type: application/json" \
-d '[
{
"taskType": "videoInference",
"taskUUID": "9a47544c-5b21-4c09-bcca-bcda87ecb082",
"model": "google:3@2",
"positivePrompt": "Create a finished 8-second vertical auction-house showcase using all three reference images only as identity and design references for the same antique singing-bird automaton; none of the references is a first frame. Preserve the exact kingfisher proportions, iridescent teal feathers, rust-orange breast, black beak and glass eyes, gilt branch, winding key, engraved fern motifs, dark green enamel panels, porcelain water lily, age patina, and mechanical construction throughout.\n\nReplace the plain studio surroundings completely with a refined Belle Époque conservatory at early morning. The automaton stands naturally on a slim veined-cream-marble pedestal among out-of-focus palms, wrought-iron window frames, pale condensation on glass panes, and restrained botanical shadows. Warm low sunlight passes through the foliage, creating soft moving highlights across the brass and enamel. Use an elegant palette of verdigris, cream, aged gold, dusty coral, and fresh leaf green. The result should feel like a premium provenance-film insert for a specialist mechanical-arts auction, not fantasy.\n\nOne continuous cinematic shot composed for 9:16. Begin with a close full view of the automaton centered in the lower two-thirds, then perform a very slow clockwise camera arc and subtle push-in. After two seconds, the mechanism activates: the bird turns its head once, opens its beak, gently flutters its wings, and flicks its tail while remaining securely attached to the branch. Keep motion precise, delicate, and mechanically plausible. A faint breeze moves only the conservatory leaves and shifting sunlight in the replacement background. Maintain clean, believable contact shadows on the marble, accurate reflections, stable object geometry, and crisp separation around every feather and winding key. Shallow depth of field, polished 35mm commercial cinematography, realistic materials, no people, no lettering, no logos, no borders. Synchronized audio: quiet glasshouse room tone, distant morning birds, tiny clockwork clicks and whirs, followed by two delicate mechanical bird chirps.",
"width": 1080,
"height": 1920,
"duration": 8,
"providerSettings": {
"google": {
"generateAudio": true
}
},
"inputs": {
"referenceImages": [
"https://assets.runware.ai/assets/inputs/7b2556e1-31aa-4832-8281-cb43dd19fc39.jpg",
"https://assets.runware.ai/assets/inputs/5da88154-aa2c-4ccd-b71b-06ac3092115d.jpg",
"https://assets.runware.ai/assets/inputs/5e73dfd0-ed7c-44f9-9df0-a17a56f002f9.jpg"
]
}
}
]'runware run google:3@2 \
positivePrompt="Create a finished 8-second vertical auction-house showcase using all three reference images only as identity and design references for the same antique singing-bird automaton; none of the references is a first frame. Preserve the exact kingfisher proportions, iridescent teal feathers, rust-orange breast, black beak and glass eyes, gilt branch, winding key, engraved fern motifs, dark green enamel panels, porcelain water lily, age patina, and mechanical construction throughout.
Replace the plain studio surroundings completely with a refined Belle Époque conservatory at early morning. The automaton stands naturally on a slim veined-cream-marble pedestal among out-of-focus palms, wrought-iron window frames, pale condensation on glass panes, and restrained botanical shadows. Warm low sunlight passes through the foliage, creating soft moving highlights across the brass and enamel. Use an elegant palette of verdigris, cream, aged gold, dusty coral, and fresh leaf green. The result should feel like a premium provenance-film insert for a specialist mechanical-arts auction, not fantasy.
One continuous cinematic shot composed for 9:16. Begin with a close full view of the automaton centered in the lower two-thirds, then perform a very slow clockwise camera arc and subtle push-in. After two seconds, the mechanism activates: the bird turns its head once, opens its beak, gently flutters its wings, and flicks its tail while remaining securely attached to the branch. Keep motion precise, delicate, and mechanically plausible. A faint breeze moves only the conservatory leaves and shifting sunlight in the replacement background. Maintain clean, believable contact shadows on the marble, accurate reflections, stable object geometry, and crisp separation around every feather and winding key. Shallow depth of field, polished 35mm commercial cinematography, realistic materials, no people, no lettering, no logos, no borders. Synchronized audio: quiet glasshouse room tone, distant morning birds, tiny clockwork clicks and whirs, followed by two delicate mechanical bird chirps." \
width=1080 \
height=1920 \
duration=8 \
providerSettings.google.generateAudio=true \
inputs.referenceImages.0=https://assets.runware.ai/assets/inputs/7b2556e1-31aa-4832-8281-cb43dd19fc39.jpg \
inputs.referenceImages.1=https://assets.runware.ai/assets/inputs/5da88154-aa2c-4ccd-b71b-06ac3092115d.jpg \
inputs.referenceImages.2=https://assets.runware.ai/assets/inputs/5e73dfd0-ed7c-44f9-9df0-a17a56f002f9.jpg{
"taskType": "videoInference",
"taskUUID": "9a47544c-5b21-4c09-bcca-bcda87ecb082",
"model": "google:3@2",
"positivePrompt": "Create a finished 8-second vertical auction-house showcase using all three reference images only as identity and design references for the same antique singing-bird automaton; none of the references is a first frame. Preserve the exact kingfisher proportions, iridescent teal feathers, rust-orange breast, black beak and glass eyes, gilt branch, winding key, engraved fern motifs, dark green enamel panels, porcelain water lily, age patina, and mechanical construction throughout.\n\nReplace the plain studio surroundings completely with a refined Belle Époque conservatory at early morning. The automaton stands naturally on a slim veined-cream-marble pedestal among out-of-focus palms, wrought-iron window frames, pale condensation on glass panes, and restrained botanical shadows. Warm low sunlight passes through the foliage, creating soft moving highlights across the brass and enamel. Use an elegant palette of verdigris, cream, aged gold, dusty coral, and fresh leaf green. The result should feel like a premium provenance-film insert for a specialist mechanical-arts auction, not fantasy.\n\nOne continuous cinematic shot composed for 9:16. Begin with a close full view of the automaton centered in the lower two-thirds, then perform a very slow clockwise camera arc and subtle push-in. After two seconds, the mechanism activates: the bird turns its head once, opens its beak, gently flutters its wings, and flicks its tail while remaining securely attached to the branch. Keep motion precise, delicate, and mechanically plausible. A faint breeze moves only the conservatory leaves and shifting sunlight in the replacement background. Maintain clean, believable contact shadows on the marble, accurate reflections, stable object geometry, and crisp separation around every feather and winding key. Shallow depth of field, polished 35mm commercial cinematography, realistic materials, no people, no lettering, no logos, no borders. Synchronized audio: quiet glasshouse room tone, distant morning birds, tiny clockwork clicks and whirs, followed by two delicate mechanical bird chirps.",
"width": 1080,
"height": 1920,
"duration": 8,
"providerSettings": {
"google": {
"generateAudio": true
}
},
"inputs": {
"referenceImages": [
"https://assets.runware.ai/assets/inputs/7b2556e1-31aa-4832-8281-cb43dd19fc39.jpg",
"https://assets.runware.ai/assets/inputs/5da88154-aa2c-4ccd-b71b-06ac3092115d.jpg",
"https://assets.runware.ai/assets/inputs/5e73dfd0-ed7c-44f9-9df0-a17a56f002f9.jpg"
]
}
}Response
{
"taskType": "videoInference",
"taskUUID": "9a47544c-5b21-4c09-bcca-bcda87ecb082",
"videoUUID": "4528bb62-facd-47c4-8562-7950567f727d",
"videoURL": "https://vm.runware.ai/video/os/a08dlim3/ws/5/vi/4528bb62-facd-47c4-8562-7950567f727d.mp4",
"seed": 123909071,
"cost": 3.2
}video-edit
Arborist Helmet Colorway Reveal$2.80~1m 16simport { 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: 'Create a seamless seven-second continuation from the source clip. Preserve the exact arborist helmet geometry, proportions, materials, turntable speed, clockwise rotation, camera height, slow rightward dolly, warm-gray cyclorama, lighting direction, exposure, and temporal rhythm. Continue the narrow vertical band of light sweeping smoothly from left to right across the helmet. As the band crosses the rigid burnt-orange outer shell, reveal the production-ready alternate colorway behind it: a refined muted eucalyptus green with the same satin polymer finish. Recolor only the rigid outer shell. Keep the matte-black earmuffs, suspension hardware, straps, vents, raised stainless-steel mesh visor, shadows, highlights, and reflections unchanged. The transition must be crisp and physically coherent, with no morphing, added parts, logos, lettering, hands, or camera cuts. After the sweep completes, continue the measured rotation and dolly long enough to present the fully green helmet in a premium three-quarter hero angle, ending with stable motion that could continue into another shot. Native audio: quiet turntable motor, subtle studio room tone, and one soft precision click as the new colorway is fully revealed; no speech and no music.',
duration: 7,
inputs: {
video: 'https://assets.runware.ai/assets/inputs/c5b7c799-6c8b-4a83-bfb5-545ee1c5c22d.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": "Create a seamless seven-second continuation from the source clip. Preserve the exact arborist helmet geometry, proportions, materials, turntable speed, clockwise rotation, camera height, slow rightward dolly, warm-gray cyclorama, lighting direction, exposure, and temporal rhythm. Continue the narrow vertical band of light sweeping smoothly from left to right across the helmet. As the band crosses the rigid burnt-orange outer shell, reveal the production-ready alternate colorway behind it: a refined muted eucalyptus green with the same satin polymer finish. Recolor only the rigid outer shell. Keep the matte-black earmuffs, suspension hardware, straps, vents, raised stainless-steel mesh visor, shadows, highlights, and reflections unchanged. The transition must be crisp and physically coherent, with no morphing, added parts, logos, lettering, hands, or camera cuts. After the sweep completes, continue the measured rotation and dolly long enough to present the fully green helmet in a premium three-quarter hero angle, ending with stable motion that could continue into another shot. Native audio: quiet turntable motor, subtle studio room tone, and one soft precision click as the new colorway is fully revealed; no speech and no music.",
"duration": 7,
"inputs": {
"video": "https://assets.runware.ai/assets/inputs/c5b7c799-6c8b-4a83-bfb5-545ee1c5c22d.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": "148bd2ca-3405-4dae-aa78-a2c1e936ceaf",
"model": "google:3@2",
"positivePrompt": "Create a seamless seven-second continuation from the source clip. Preserve the exact arborist helmet geometry, proportions, materials, turntable speed, clockwise rotation, camera height, slow rightward dolly, warm-gray cyclorama, lighting direction, exposure, and temporal rhythm. Continue the narrow vertical band of light sweeping smoothly from left to right across the helmet. As the band crosses the rigid burnt-orange outer shell, reveal the production-ready alternate colorway behind it: a refined muted eucalyptus green with the same satin polymer finish. Recolor only the rigid outer shell. Keep the matte-black earmuffs, suspension hardware, straps, vents, raised stainless-steel mesh visor, shadows, highlights, and reflections unchanged. The transition must be crisp and physically coherent, with no morphing, added parts, logos, lettering, hands, or camera cuts. After the sweep completes, continue the measured rotation and dolly long enough to present the fully green helmet in a premium three-quarter hero angle, ending with stable motion that could continue into another shot. Native audio: quiet turntable motor, subtle studio room tone, and one soft precision click as the new colorway is fully revealed; no speech and no music.",
"duration": 7,
"inputs": {
"video": "https://assets.runware.ai/assets/inputs/c5b7c799-6c8b-4a83-bfb5-545ee1c5c22d.mp4"
}
}
]'runware run google:3@2 \
positivePrompt="Create a seamless seven-second continuation from the source clip. Preserve the exact arborist helmet geometry, proportions, materials, turntable speed, clockwise rotation, camera height, slow rightward dolly, warm-gray cyclorama, lighting direction, exposure, and temporal rhythm. Continue the narrow vertical band of light sweeping smoothly from left to right across the helmet. As the band crosses the rigid burnt-orange outer shell, reveal the production-ready alternate colorway behind it: a refined muted eucalyptus green with the same satin polymer finish. Recolor only the rigid outer shell. Keep the matte-black earmuffs, suspension hardware, straps, vents, raised stainless-steel mesh visor, shadows, highlights, and reflections unchanged. The transition must be crisp and physically coherent, with no morphing, added parts, logos, lettering, hands, or camera cuts. After the sweep completes, continue the measured rotation and dolly long enough to present the fully green helmet in a premium three-quarter hero angle, ending with stable motion that could continue into another shot. Native audio: quiet turntable motor, subtle studio room tone, and one soft precision click as the new colorway is fully revealed; no speech and no music." \
duration=7 \
inputs.video=https://assets.runware.ai/assets/inputs/c5b7c799-6c8b-4a83-bfb5-545ee1c5c22d.mp4{
"taskType": "videoInference",
"taskUUID": "148bd2ca-3405-4dae-aa78-a2c1e936ceaf",
"model": "google:3@2",
"positivePrompt": "Create a seamless seven-second continuation from the source clip. Preserve the exact arborist helmet geometry, proportions, materials, turntable speed, clockwise rotation, camera height, slow rightward dolly, warm-gray cyclorama, lighting direction, exposure, and temporal rhythm. Continue the narrow vertical band of light sweeping smoothly from left to right across the helmet. As the band crosses the rigid burnt-orange outer shell, reveal the production-ready alternate colorway behind it: a refined muted eucalyptus green with the same satin polymer finish. Recolor only the rigid outer shell. Keep the matte-black earmuffs, suspension hardware, straps, vents, raised stainless-steel mesh visor, shadows, highlights, and reflections unchanged. The transition must be crisp and physically coherent, with no morphing, added parts, logos, lettering, hands, or camera cuts. After the sweep completes, continue the measured rotation and dolly long enough to present the fully green helmet in a premium three-quarter hero angle, ending with stable motion that could continue into another shot. Native audio: quiet turntable motor, subtle studio room tone, and one soft precision click as the new colorway is fully revealed; no speech and no music.",
"duration": 7,
"inputs": {
"video": "https://assets.runware.ai/assets/inputs/c5b7c799-6c8b-4a83-bfb5-545ee1c5c22d.mp4"
}
}Response
{
"taskType": "videoInference",
"taskUUID": "148bd2ca-3405-4dae-aa78-a2c1e936ceaf",
"videoUUID": "f4f71823-0633-4ebe-9d74-a3001a0a2eba",
"videoURL": "https://vm.runware.ai/video/os/a06dlim3/ws/5/vi/f4f71823-0633-4ebe-9d74-a3001a0a2eba.mp4",
"seed": 2040258558,
"cost": 2.8
}