Veo 3

Text-to-Video • Google • Proxied

Google's video generation model capable of producing high-quality videos with optional audio from text prompts.

Model Info
Terms and License	link ↗
More information	link ↗

Usage

const response = await env.AI.run(
  'google/veo-3',
  {
    prompt:
      'A golden retriever running through a field of sunflowers on a sunny day',
    duration: '6s',
    aspect_ratio: '16:9',
    resolution: '720p',
    generate_audio: true,
  },
  {
    gateway: { id: 'default' },
  }
)
console.log(response)

Response 200

Examples

Cinematic Scene — Widescreen cinematic video in 1080p

const response = await env.AI.run(
  'google/veo-3',
  {
    prompt:
      'A dramatic drone shot flying through misty mountain peaks at sunrise, with clouds rolling through valleys below',
    duration: '8s',
    aspect_ratio: '16:9',
    resolution: '1080p',
    generate_audio: true,
  },
  {
    gateway: { id: 'default' },
  }
)
console.log(response)

Response 200

Vertical Video — Portrait orientation for social media

const response = await env.AI.run(
  'google/veo-3',
  {
    prompt:
      'A barista expertly pouring latte art, close-up shot with shallow depth of field',
    duration: '6s',
    aspect_ratio: '9:16',
    resolution: '720p',
    generate_audio: true,
  },
  {
    gateway: { id: 'default' },
  }
)
console.log(response)

Response 200

Short Format — Short video for social media posts

const response = await env.AI.run(
  'google/veo-3',
  {
    prompt: 'A timelapse of a flower blooming, soft natural lighting',
    duration: '4s',
    aspect_ratio: '16:9',
    resolution: '720p',
    generate_audio: true,
  },
  {
    gateway: { id: 'default' },
  }
)
console.log(response)

Response 200

Silent Video — Video without audio generation

const response = await env.AI.run(
  'google/veo-3',
  {
    prompt: 'Abstract flowing liquid metal morphing into geometric shapes',
    duration: '6s',
    aspect_ratio: '16:9',
    resolution: '720p',
    generate_audio: false,
  },
  {
    gateway: { id: 'default' },
  }
)
console.log(response)

Response 200

prompt

stringrequiredText prompt describing the video to generate

image_input

stringBase64-encoded reference image for i2v

duration

stringrequireddefault: 6senum: 4s, 6s, 8sVideo duration

aspect_ratio

stringrequireddefault: 16:9enum: 16:9, 9:16, 1:1Video aspect ratio

resolution

stringrequireddefault: 720penum: 720p, 1080pVideo resolution

generate_audio

booleanrequireddefault: trueWhether to generate audio with the video

video

stringformat: uriURL to the generated video

API Schemas

Input
Output

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "prompt": {
      "description": "Text prompt describing the video to generate",
      "type": "string"
    },
    "image_input": {
      "description": "Base64-encoded reference image for i2v",
      "type": "string"
    },
    "duration": {
      "description": "Video duration",
      "default": "6s",
      "type": "string",
      "enum": [
        "4s",
        "6s",
        "8s"
      ]
    },
    "aspect_ratio": {
      "description": "Video aspect ratio",
      "default": "16:9",
      "type": "string",
      "enum": [
        "16:9",
        "9:16",
        "1:1"
      ]
    },
    "resolution": {
      "description": "Video resolution",
      "default": "720p",
      "type": "string",
      "enum": [
        "720p",
        "1080p"
      ]
    },
    "generate_audio": {
      "description": "Whether to generate audio with the video",
      "default": true,
      "type": "boolean"
    }
  },
  "required": [
    "prompt",
    "duration",
    "aspect_ratio",
    "resolution",
    "generate_audio"
  ],
  "additionalProperties": false
}

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "video": {
      "description": "URL to the generated video",
      "type": "string",
      "format": "uri"
    }
  },
  "required": [
    "video"
  ],
  "additionalProperties": false
}