API Veo 3: промпты и сценарии через один эндпоинт

Требования и аутентификация

Перед первым запросом убедитесь, что у вас есть API-ключ. Зарегистрируйтесь на странице Получить API-ключ, указав email и пароль. Вы сразу получите доступ к $0,50 пробного баланса на 7 дней без привязки карты. Для продакшена пополните баланс минимум на $10.

Наш базовый URL — https://api.veo3apis.com/v1. Включите ваш API-ключ в заголовок Authorization как Bearer-токен. Этот эндпоинт полностью совместим с OpenAI, поэтому вы можете использовать стандартные SDK, указав в них наш базовый URL.

Базовое завершение чата

Отправьте стандартный POST-запрос на /v1/chat/completions для генерации текста. ID модели — «uncensored». Это возвращает полный ответ в одном JSON-объекте, что идеально для простой генерации промптов или написания сценариев, где не нужны обновления в реальном времени.

Интеграция Python SDK

Используйте официальный Python SDK от OpenAI для чистой интеграции. Настройте клиент, указав наш базовый URL и ваш API-ключ. Этот подход упрощает обработку ошибок и подсчет токенов для ваших мультимодальных конвейеров.

Интеграция Node SDK

Для проектов на JavaScript/TypeScript Node SDK от OpenAI работает из коробки. Укажите клиенту наш базовый URL. Это полезно для генерации сценариев на стороне сервера или шагов постобработки в вашем рабочем процессе Veo 3.

Потоковая передача ответов (SSE)

Для снижения воспринимаемой задержки включите потоковую передачу, установив stream: true. API возвращает поток Server-Sent Events (SSE) с частичными ответами. Это позволяет вашему приложению отображать токены по мере их генерации, что критично для длинных сценариев или сложных задач рассуждения.

Лимиты, ошибки и контекст

Лимит запросов — 300 запросов в минуту на ключ. При превышении вы получите ошибку 429. Ошибки аутентификации возвращают 401, а нехватка баланса — 402. Контекстное окно — 100 000 токенов (промпт + завершение). Размер полезной нагрузки — до 8 МБ. Единственное жесткое ограничение контента — сексуальный контент с участием несовершеннолетних, который всегда блокируется.

cURL

Copycurl https://api.veo3apis.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Write a blunt product review of a cheap VPN."}]
  }'

Python

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.veo3apis.com/v1", api_key="YOUR_KEY")

resp = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Summarise this thread without softening it."}],
)
print(resp.choices[0].message.content)

Node.js

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.veo3apis.com/v1", apiKey: process.env.API_KEY });

const resp = await client.chat.completions.create({
  model: "uncensored",
  messages: [{ role: "user", content: "Draft a villain monologue for my game." }],
});
console.log(resp.choices[0].message.content);

Потоковая передача

Copystream = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Tell the story in second person."}],
    stream=True,
)
for chunk in stream:
    if chunk.choices and chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="", flush=True)