Veo API Examples

Since the Veo model is a multimodal model, the OpenAI SDK currently does not support direct access to this model. You need to use the request method to access the Veo model.

Basic Configuration

Before starting to use the API, please ensure you have obtained an API Key. If not, please refer to Create API Key.

⚠️ Important: Address Change Notice

The old address https://api.agentsflare.com/googleapi/google/v1/models/ will no longer be updated. Please migrate as soon as possible!

The new address https://api.agentsflare.com/google/v1/models/ offers the following advantages:

• ✅ Supports automatic channel switching on 429 errors, more stable
• ✅ Continuous updates and optimizations
• ✅ Better performance

Basic Information

• API Base URL: https://api.agentsflare.com/google/v1/models/veo-3.1-fast-generate-preview:predictLongRunning
• Authentication Method: Bearer Token
• Content Type: application/json

Request Examples

Generate Video

cURL

curl -X POST "https://api.agentsflare.com/google/v1/models/veo-3.1-fast-generate-preview:predictLongRunning" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "instances": [
      {
        "prompt": "The camera slowly pushes in, the character starts to turn their head and smile"
      }
    ],
    "parameters": {
      "resolution": "720p",
      "durationSeconds": 6
    }
  }'

Python

import requests

API_KEY = "your API Key"

url = "https://api.agentsflare.com/google/v1/models/veo-3.1-fast-generate-preview:predictLongRunning"

headers = {
    "Authorization": f"Bearer {API_KEY}",
    "Content-Type": "application/json"
}

payload = {
    "instances": [
        {
            "prompt": "The camera slowly pushes in, the character starts to turn their head and smile"
        }
    ],
    "parameters": {
        "resolution": "720p",
        "durationSeconds": 6
    }
}

response = requests.post(url, headers=headers, json=payload)
result = response.json()

print("Operation ID:", result.get("name"))

Node.js

const axios = require('axios');

const API_KEY = 'your API Key';

const url = 'https://api.agentsflare.com/google/v1/models/veo-3.1-fast-generate-preview:predictLongRunning';

const headers = {
    'Authorization': `Bearer ${API_KEY}`,
    'Content-Type': 'application/json'
};

const payload = {
    instances: [
        {
            prompt: 'The camera slowly pushes in, the character starts to turn their head and smile'
        }
    ],
    parameters: {
        resolution: '720p',
        durationSeconds: 6
    }
};

axios.post(url, payload, { headers })
    .then(response => {
        console.log('Operation ID:', response.data.name);
    })
    .catch(error => {
        console.error('Error:', error.message);
    });

Go

package main

import (
	"bytes"
	"encoding/json"
	"fmt"
	"io"
	"net/http"
)

func main() {
	url := "https://api.agentsflare.com/google/v1/models/veo-3.1-fast-generate-preview:predictLongRunning"

	payload := map[string]interface{}{
		"instances": []map[string]interface{}{
			{"prompt": "The camera slowly pushes in, the character starts to turn their head and smile"},
		},
		"parameters": map[string]interface{}{
			"resolution":      "720p",
			"durationSeconds": 6,
		},
	}
	jsonPayload, _ := json.Marshal(payload)

	req, err := http.NewRequest("POST", url, bytes.NewBuffer(jsonPayload))
	if err != nil {
		fmt.Println("Error creating request:", err)
		return
	}

	req.Header.Set("Authorization", "Bearer {API-KEY}")
	req.Header.Set("Content-Type", "application/json")

	client := &http.Client{}
	resp, err := client.Do(req)
	if err != nil {
		fmt.Println("Error sending request:", err)
		return
	}
	defer resp.Body.Close()

	body, err := io.ReadAll(resp.Body)
	if err != nil {
		fmt.Println("Error reading response:", err)
		return
	}

	fmt.Println("Status:", resp.StatusCode)
	fmt.Println("Response:", string(body))
}

Response Example

{
  "name": "models/veo-3.1-fast-generate-preview/operations/********" // Generated ID
}

Get Video Status

cURL

curl -s -H "Authorization: Bearer $API_KEY" \
  "https://api.agentsflare.com/google/v1/models/veo-3.1-fast-generate-preview/operations/********"

Python

import requests

API_KEY = "your API Key"
NAME = "models/veo-3.1-fast-generate-preview/operations/********"

url = f"https://api.agentsflare.com/google/v1/{NAME}"

headers = {
    "Authorization": f"Bearer {API_KEY}"
}

response = requests.get(url, headers=headers)
result = response.json()

print("Status:", result)
print("Is completed:", result.get("done"))

Node.js

const axios = require('axios');

const API_KEY = 'your API Key';
const NAME = 'models/veo-3.1-fast-generate-preview/operations/********';

const url = `https://api.agentsflare.com/google/v1/${NAME}`;

const headers = {
    'Authorization': `Bearer ${API_KEY}`,
    'Content-Type': 'application/json'
};

axios.get(url, { headers })
    .then(response => {
        console.log('Status:', response.data);
        console.log('Is completed:', response.data.done);
    })
    .catch(error => {
        console.error('Error:', error.message);
    });

Go

package main

import (
	"fmt"
	"io"
	"net/http"
)

func main() {
    NAME := "models/veo-3.1-fast-generate-preview/operations/********"
	url := fmt.Sprintf("https://api.agentsflare.com/google/v1/%s", NAME)

	req, err := http.NewRequest("GET", url, nil)
	if err != nil {
		fmt.Println("Error creating request:", err)
		return
	}

	req.Header.Set("Authorization", "Bearer {API-KEY}")
	req.Header.Set("Content-Type", "application/json")

	client := &http.Client{}
	resp, err := client.Do(req)
	if err != nil {
		fmt.Println("Error sending request:", err)
		return
	}
	defer resp.Body.Close()

	body, err := io.ReadAll(resp.Body)
	if err != nil {
		fmt.Println("Error reading response:", err)
		return
	}

	fmt.Println("Status:", resp.StatusCode)
	fmt.Println("Response:", string(body))
}

Response Example

{
  "name": "models/veo-3.1-fast-generate-preview/operations/************",
  "done": true,
  "response": {
    "@type": "type.googleapis.com/google.ai.generativelanguage.v1beta.PredictLongRunningResponse",
    "generateVideoResponse": {
      "generatedSamples": [
        {
          "video": {
            "uri": "https://api.agentsflare.com/google/v1/files/7u798kq1mncf:download?alt=media"
          }
        }
      ]
    }
  }
}

Request Parameters

For detailed parameters, see Veo video generation.

Parameter	Required	Description
prompt	Yes	Text description of the video to generate
resolution	Optional	Output resolution, e.g. 720p
durationSeconds	Optional	Video duration in seconds
aspectRatio	Optional	Aspect ratio, e.g. 16:9, 9:16, 1:1
generateAudio	Optional	Whether to generate audio (true / false)
sampleCount	Optional	Number of samples to generate, range 1–4
addWatermark	Optional	Whether to add a watermark (true / false)

For detailed parameters, see Videos API.

Supported Models

The following models are available through this interface (sorted by recommendation):

• veo-3.1-generate-preview Retired
• veo-3.1-fast-generate-preview Retired
• veo-3.0-generate-001 Retired
• veo-3.0-fast-generate-001 Retired

💡 Tip

The model field in the request example can be replaced with any model name above.