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 (
	"fmt"
	"io"
	"net/http"
)

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

	req, err := http.NewRequest("POST", 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/********" // 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

For detailed parameters, see Videos API