Veo 3.1 API

Veo 3.1 on Img2Vid is available as Fast and Quality variants for cinematic text-to-video, reference-to-video, and frame-controlled video generation.

Model keys

google/veo3.1-fast — Veo3.1 Fast
google/veo3.1-quality — Veo3.1 Quality

Supported modes and inputs

Model	Mode	Label	Input requirements
`google/veo3.1-fast`	`text_to_video`	Text to Video	Prompt max 2000 chars
`google/veo3.1-fast`	`reference_to_video`	Reference to Video	Prompt max 2000 chars Images `reference`: 1-3 files, 10 MB, formats jpg, png, webp
`google/veo3.1-fast`	`frames_to_video`	Frames to Video	Prompt max 2000 chars Images `start_frame,end_frame`: 1-2 files, 10 MB, formats jpg, png, webp
`google/veo3.1-quality`	`text_to_video`	Text to Video	Prompt max 2000 chars
`google/veo3.1-quality`	`reference_to_video`	Reference to Video	Prompt max 2000 chars Images `reference`: 1-3 files, 10 MB, formats jpg, png, webp
`google/veo3.1-quality`	`frames_to_video`	Frames to Video	Prompt max 2000 chars Images `start_frame,end_frame`: 1-2 files, 10 MB, formats jpg, png, webp

Options

Model	Option	Default	Allowed values	Applies to
`google/veo3.1-fast`	`duration`	`8s`	`8s`	All modes
`google/veo3.1-fast`	`resolution`	`720p`	`720p`, `1080p`, `4k`	All modes
`google/veo3.1-fast`	`aspect_ratio`	`16:9`	`16:9`, `9:16`	All modes
`google/veo3.1-quality`	`duration`	`8s`	`8s`	All modes
`google/veo3.1-quality`	`resolution`	`720p`	`720p`, `1080p`, `4k`	All modes
`google/veo3.1-quality`	`aspect_ratio`	`16:9`	`16:9`, `9:16`	All modes

Pricing

Model	Pricing
`google/veo3.1-fast`	5 credits per second; option multipliers: `resolution`=`{"4k":3,"720p":1,"1080p":1}`
`google/veo3.1-quality`	1 credit per second; option multipliers: `resolution`=`{"4k":80,"720p":26,"1080p":26}`

Production guidance

Pass mode explicitly.
Use only option values listed above.
Upload media with POST /api/v1/files before calling media-input modes.
Use the exact model key for the variant you want.

Example: text to video

curl https://img2vid.net/api/v1/generations \
  -H "Authorization: Bearer $BUBLE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "google/veo3.1-fast",
    "mode": "text_to_video",
    "prompt": "A cinematic product launch shot with slow camera movement, premium lighting, and realistic motion",
    "duration": "8s",
    "resolution": "720p",
    "aspect_ratio": "16:9"
  }'

Example: media-guided video

curl https://img2vid.net/api/v1/generations \
  -H "Authorization: Bearer $BUBLE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "google/veo3.1-fast",
    "mode": "frames_to_video",
    "prompt": "Animate the source into a polished cinematic motion shot with natural camera movement",
    "start_frame": "https://example.com/start.png",
    "duration": "8s",
    "resolution": "720p",
    "aspect_ratio": "16:9"
  }'

SDK examples

The examples below use this page's public model key, mode, and parameter values. They assume you have already initialized the SDK client as shown in the Quickstart and imported the required language SDK types. For media-input modes, upload local files first and pass the returned URL through public fields such as image_urls, start_frame, or video_urls.

JavaScript / TypeScript

const task = await buble.generations.create({
  model: 'google/veo3.1-fast',
  mode: 'text_to_video',
  prompt:
    'A cinematic product launch shot with slow camera movement, premium lighting, and realistic motion',
  duration: '8s',
  resolution: '720p',
  aspect_ratio: '16:9',
});

const result = await buble.generations.wait(task.data.id);
console.log(result.data.result?.videos?.[0]?.url);

Python

task = client.generations.create(
    model="google/veo3.1-fast",
    mode="text_to_video",
    prompt="A cinematic product launch shot with slow camera movement, premium lighting, and realistic motion",
    duration="8s",
    resolution="720p",
    aspect_ratio="16:9",
)

result = client.generations.wait(task["data"]["id"])
print(result["data"]["result"]["videos"][0]["url"])

Go

task, err := client.Generations.Create(ctx, &buble.CreateGenerationRequest{
	Model:  "google/veo3.1-fast",
	Mode:   "text_to_video",
	Prompt: "A cinematic product launch shot with slow camera movement, premium lighting, and realistic motion",
	Params: map[string]any{
		"duration": "8s",
		"resolution": "720p",
		"aspect_ratio": "16:9",
	},
})
if err != nil {
	return err
}

result, err := client.Generations.Wait(ctx, task.Data.ID)
if err != nil {
	return err
}
fmt.Println(result.Data.Result.Videos[0].URL)

Rust

let task = client.generations().create(
    CreateGenerationRequest::new("google/veo3.1-fast")
        .mode("text_to_video")
        .prompt("A cinematic product launch shot with slow camera movement, premium lighting, and realistic motion")
        .param("duration", "8s")?
        .param("resolution", "720p")?
        .param("aspect_ratio", "16:9")?,
).await?;

let result = client
    .generations()
    .wait(&task.data.id, WaitOptions::default())
    .await?;

Swift

let task = try await client.generations.create(
    try CreateGenerationRequest(model: "google/veo3.1-fast")
        .mode("text_to_video")
        .prompt("A cinematic product launch shot with slow camera movement, premium lighting, and realistic motion")
        .param("duration", "8s")
        .param("resolution", "720p")
        .param("aspect_ratio", "16:9")
)

let result = try await client.generations.wait(task.data.id)
print(result.data.result?.videos?.first?.url.absoluteString ?? "")

Dart / Flutter

final task = await client.generations.create(
  CreateGenerationRequest(
    model: 'google/veo3.1-fast',
    mode: 'text_to_video',
    prompt: 'A cinematic product launch shot with slow camera movement, premium lighting, and realistic motion',
  ).withParam('duration', '8s').withParam('resolution', '720p').withParam('aspect_ratio', '16:9'),
);

final result = await client.generations.wait(task.data.id);
print(result.data.result?.videos.firstOrNull?.url);

Elixir

{:ok, task} =
  Buble.Generations.create(client, %{
    model: "google/veo3.1-fast",
    mode: "text_to_video",
    prompt: "A cinematic product launch shot with slow camera movement, premium lighting, and realistic motion",
    duration: "8s",
    resolution: "720p",
    aspect_ratio: "16:9"
  })

{:ok, result} = Buble.Generations.wait(client, task["data"]["id"])
IO.puts(result["data"]["result"]["videos"] |> List.first() |> Map.fetch!("url"))

Java

Envelope<GenerationTask> task = client.generations().create(
        CreateGenerationRequest.builder()
                .model("google/veo3.1-fast")
                .mode("text_to_video")
                .prompt("A cinematic product launch shot with slow camera movement, premium lighting, and realistic motion")
                .param("duration", "8s")
                .param("resolution", "720p")
                .param("aspect_ratio", "16:9")
                .build());

Envelope<GenerationTask> result = client.generations().wait(task.getData().getId());

.NET

var task = await client.Generations.CreateAsync(new CreateGenerationRequest
{
    Model = "google/veo3.1-fast",
    Mode = "text_to_video",
    Prompt = "A cinematic product launch shot with slow camera movement, premium lighting, and realistic motion"
}.WithParam("duration", "8s").WithParam("resolution", "720p").WithParam("aspect_ratio", "16:9"));

var result = await client.Generations.WaitAsync(task!.Data!.Id!);

PHP

$task = $client->generations()->create(
    CreateGenerationRequest::make(
        model: 'google/veo3.1-fast',
        mode: 'text_to_video',
        prompt: 'A cinematic product launch shot with slow camera movement, premium lighting, and realistic motion',
    )
    ->withParam('duration', '8s')
    ->withParam('resolution', '720p')
    ->withParam('aspect_ratio', '16:9')
);

$result = $client->generations()->wait($task['data']['id']);

Ruby

task = client.generations.create(
  model: "google/veo3.1-fast",
  mode: "text_to_video",
  prompt: "A cinematic product launch shot with slow camera movement, premium lighting, and realistic motion",
  duration: "8s",
  resolution: "720p",
  aspect_ratio: "16:9"
)

result = client.generations.wait(task.dig("data", "id"))
puts result.dig("data", "result", "videos", 0, "url")