Veo2 (Text-to-Video)

This documentation is valid for the following list of our models:

• veo2

Overview

Google’s cutting-edge AI model designed to generate highly realistic and cinematic video content from textual prompts or a combination of text and images. Leveraging advanced machine learning techniques, Veo2 excels in creating videos with natural motion, realistic physics, and professional-grade visual fidelity.

Key Features:

• Text-to-Video (T2V): Converts descriptive text into dynamic video content.

• High Resolution Support: Generates videos up to 4K resolution for professional-grade outputs.

• Multimodal Input Encoding: Integrates text and image inputs seamlessly for creative flexibility.

Setup your API Key

If you don’t have an API key for the AI/ML API yet, feel free to use our Quickstart guide.

How to Make a Call

Generating a video using this model involves sequentially calling two endpoints:

• The first one is for creating and sending a video generation task to the server (returns a generation ID).

• The second one is for requesting the generated video from the server using the generation ID received from the first endpoint.

Below, you can find two corresponding API schemas and examples for both endpoint calls.

API Schemas

Video Generation

You can generate a video using this API. In the basic setup, you only need a prompt, the aspect ratio, and the desired duration (5, 6, 7, or 8 seconds).

post

Authorizations

Body

modelundefined · enumrequired

Options: veo2

promptstringrequired

The text prompt describing the video you want to generate

aspect_ratiostring · enumoptional

The aspect ratio of the generated video

Options: 16:9, 9:16

durationstring · default: "5"optional

The duration of the generated video in seconds. Possible values: 5, 6, 7, 8

Responses

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url 'https://api.aimlapi.com/v2/generate/video/google/generation' \
  --header 'Authorization: Bearer <YOUR_AIMLAPI_KEY>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "veo2",
    "prompt": "text",
    "aspect_ratio": "16:9",
    "duration": "text"
  }'

201

201

No body

Fetch the video

get

Authorizations

Query parameters

generation_idstringrequired

Responses

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://api.aimlapi.com/v2/generate/video/google/generation?generation_id=text' \
  --header 'Authorization: Bearer <YOUR_AIMLAPI_KEY>'

200

200

No body

Examples

Video generation

import requests


def main():
    url = "https://api.aimlapi.com/v2/generate/video/google/generation"
    payload = {
        "model": "veo2",
        "prompt": "A DJ on the stand is playing, around a World War II battlefield, lots of explosions, thousands of dancing soldiers, between tanks shooting, barbed wire fences, lots of smoke and fire, black and white old video: hyper realistic, photorealistic, photography, super detailed, very sharp, on a very white background",
        "aspect_ratio": "16:9",
        "duration": "5",
    }
    headers = {"Authorization": "Bearer <YOUR_AIMLAPI_KEY>", "Content-Type": "application/json"}

    response = requests.post(url, json=payload, headers=headers)
    print("Generation:", response.json())


if __name__ == "__main__":
    main()

Fetch the video

import requests


def main():
    url = "https://api.aimlapi.com/v2/generate/video/google/generation"
    params = {
        "generation_id": "<YOUR_GENERATION_ID>",
    }
    headers = {"Authorization": "Bearer <YOUR_AIMLAPI_KEY>", "Content-Type": "application/json"}

    response = requests.get(url, params=params, headers=headers)
    print("Generation:", response.json())


if __name__ == "__main__":
    main()