Veo 3.1 Fast API — цены и подключение
Veo 3.1 Fast: API генерации видео. Подключайте модель через Point API с точным model ID и указанными ниже параметрами. Перед генерацией сравните опубликованные тарифы для нужного набора настроек.
ID модели: veo
Включено в опубликованной конфигурации
Открыть в песочницеЦены API в USD
Цены «Creator −10%» на 10% ниже стоимости генераций по тарифу Studio Creator в пересчёте на USD. У моделей, доступных только через API, отдельные тарифы. Тариф за запрос или диапазон символов — полная стоимость для указанных настроек; цены за изображение и секунду умножаются на количество и длительность. Токеновые ставки применяются только там, где указаны явно. Отсутствующая или устаревшая цена означает недоступность, а не бесплатный доступ.
Creator −10%
| Цена | Цены API в USD | Параметры тарифа |
|---|---|---|
| 0.701143 USD | за запрос | {"duration": 8, "mode": "animate-photo"} |
| 0.701143 USD | за запрос | {"duration": 8, "mode": "prompt-to-video"} |
Поддерживаемые параметры API
| Параметр | Тип | Допустимые значения |
|---|---|---|
prompt | stringОбязательный | Минимум (minLength): 1Максимум ( maxLength): 4000 |
mode | stringНеобязательный | Допустимые значения ["animate-photo", "prompt-to-video"]По умолчанию ( default): "prompt-to-video" |
ratio | stringНеобязательный | Допустимые значения ["9:16", "1:1", "16:9"]По умолчанию ( default): "16:9" |
duration | integerОбязательный | Допустимые значения [8] |
images | arrayНеобязательный | Максимум элементов (maxItems): 1items: {"format": "data-url", "type": "string"} |
capabilities
{
"additionalProperties": false,
"max_reference_images": 1,
"quality_durations": {}
}Опубликованный контракт допускает до 1 изображений-референсов. Используйте только описанные для модели поля и роли референсов; этот лимит не означает поддержку других типов медиа.
Подключение модели
Point API использует собственный контракт REST JSON и асинхронные задания генерации. Храните API-ключи на своём сервере, а не в публичном коде сайта.
- Запросите GET /v1/models и выберите точный model ID, допустимые входные поля и опубликованный тариф.
- Создайте в кабинете API-ключ с доступом к модели и проверьте, что баланса в USD хватает на запрос.
- Отправьте REST JSON на POST /v1/generations с Authorization: Bearer и Idempotency-Key. При повторе той же операции используйте прежний ключ только с тем же телом запроса.
- Опрашивайте GET /v1/generations/{id} с тем же полученным ID генерации. Запрос выполняется асинхронно; при состоянии unknown продолжайте проверять этот ID, а не создавайте новую платную генерацию.
POST https://pointgpt.io/v1/generations
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
Idempotency-Key: YOUR_UNIQUE_REQUEST_ID
{
"model": "veo",
"input": {
"prompt": "Бумажный кораблик плывёт по спокойному пруду; лёгкий ветер создаёт мелкую рябь.",
"duration": 8
}
}Первый ответ подтверждает приём запроса, а не готовый результат. Проверяйте состояние и результат по тому же ID генерации. Формат результата и доступ к медиа зависят от модели и прав аккаунта.
Документация APIcURL / Python
POINT_API_KEY · POINT_REQUEST_ID
cURL
curl https://pointgpt.io/v1/generations \
-H "Authorization: Bearer $POINT_API_KEY" \
-H 'Content-Type: application/json' \
-H "Idempotency-Key: $POINT_REQUEST_ID" \
--data-raw '{
"model": "veo",
"input": {
"prompt": "Бумажный кораблик плывёт по спокойному пруду; лёгкий ветер создаёт мелкую рябь.",
"duration": 8
}
}'Python
import json
import os
from urllib.request import Request, urlopen
payload = json.loads('{\n "model": "veo",\n "input": {\n "prompt": "Бумажный кораблик плывёт по спокойному пруду; лёгкий ветер создаёт мелкую рябь.",\n "duration": 8\n }\n}')
request = Request('https://pointgpt.io/v1/generations', method='POST',
data=json.dumps(payload).encode('utf-8'),
headers={
'Authorization': 'Bearer ' + os.environ['POINT_API_KEY'],
'Content-Type': 'application/json',
'Idempotency-Key': os.environ['POINT_REQUEST_ID'],
})
with urlopen(request, timeout=60) as response:
job = json.load(response)
print(job['id'])Вопросы об API
Как рассчитывается стоимость запроса?
Цены «Creator −10%» на 10% ниже стоимости генераций по тарифу Studio Creator в пересчёте на USD. У моделей, доступных только через API, отдельные тарифы. Тариф за запрос или диапазон символов — полная стоимость для указанных настроек; цены за изображение и секунду умножаются на количество и длительность. Токеновые ставки применяются только там, где указаны явно. Отсутствующая или устаревшая цена означает недоступность, а не бесплатный доступ. Стоимость фиксируется при приёме запроса.
Можно ли использовать OpenAI-совместимый клиент или потоковую выдачу?
Подключайте документированные REST JSON-методы Point API. Этот контракт не заявляет OpenAI-совместимость или потоковую выдачу. Используйте форматы запросов и ответов из документации API.
Как получить результат генерации?
Отправка создаёт асинхронное задание. Сохраните его ID и опрашивайте GET /v1/generations/{id}, чтобы получить состояние и результат. Состояние unknown не означает, что нужно отправить запрос заново: продолжайте проверять прежний ID.