curl --request POST \
--url https://toapis.com/v1/videos/generations \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"model": "Veo3.1-quality-official",
"prompt": "Дельфин прыгает через кристально чистые голубые воды океана, брызги воды, солнечный свет блестит на поверхности",
"duration": 8,
"size": "16:9",
"resolution": "1080p",
"metadata": {
"generateAudio": true,
"negativePrompt": "размытый, низкое качество"
}
}'
import requests
response = requests.post(
"https://toapis.com/v1/videos/generations",
headers={
"Authorization": "Bearer your-ToAPIs-key",
"Content-Type": "application/json"
},
json={
"model": "Veo3.1-quality-official",
"prompt": "Дельфин прыгает через кристально чистые голубые воды океана, брызги воды, солнечный свет блестит на поверхности",
"duration": 8,
"size": "16:9",
"resolution": "1080p",
"metadata": {
"generateAudio": True,
"negativePrompt": "размытый, низкое качество"
}
}
)
task = response.json()
print(f"ID задачи: {task['id']}")
print(f"Статус: {task['status']}")
const response = await fetch('https://toapis.com/v1/videos/generations', {
method: 'POST',
headers: {
'Authorization': 'Bearer your-ToAPIs-key',
'Content-Type': 'application/json'
},
body: JSON.stringify({
model: 'Veo3.1-quality-official',
prompt: 'Дельфин прыгает через кристально чистые голубые воды океана, брызги воды, солнечный свет блестит на поверхности',
duration: 8,
size: '16:9',
resolution: '1080p',
metadata: {
generateAudio: true,
negativePrompt: 'размытый, низкое качество'
}
})
});
const task = await response.json();
console.log(`ID задачи: ${task.id}`);
console.log(`Статус: ${task.status}`);
{
"id": "video_01K8SGYNNNVBQTXNR4MM964S7K",
"object": "generation.task",
"model": "Veo3.1-quality-official",
"status": "queued",
"progress": 0,
"created_at": 1768380224,
"metadata": {}
}
Veo3 Official (including Veo3.1 Lite)
Veo3 Official Генерация видео
Генерация высококачественного видео с использованием моделей Google Veo3 Official с прямым подключением, поддержка генерации аудио, управления ключевыми кадрами и других расширенных функций
POST
/
v1
/
videos
/
generations
curl --request POST \
--url https://toapis.com/v1/videos/generations \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"model": "Veo3.1-quality-official",
"prompt": "Дельфин прыгает через кристально чистые голубые воды океана, брызги воды, солнечный свет блестит на поверхности",
"duration": 8,
"size": "16:9",
"resolution": "1080p",
"metadata": {
"generateAudio": true,
"negativePrompt": "размытый, низкое качество"
}
}'
import requests
response = requests.post(
"https://toapis.com/v1/videos/generations",
headers={
"Authorization": "Bearer your-ToAPIs-key",
"Content-Type": "application/json"
},
json={
"model": "Veo3.1-quality-official",
"prompt": "Дельфин прыгает через кристально чистые голубые воды океана, брызги воды, солнечный свет блестит на поверхности",
"duration": 8,
"size": "16:9",
"resolution": "1080p",
"metadata": {
"generateAudio": True,
"negativePrompt": "размытый, низкое качество"
}
}
)
task = response.json()
print(f"ID задачи: {task['id']}")
print(f"Статус: {task['status']}")
const response = await fetch('https://toapis.com/v1/videos/generations', {
method: 'POST',
headers: {
'Authorization': 'Bearer your-ToAPIs-key',
'Content-Type': 'application/json'
},
body: JSON.stringify({
model: 'Veo3.1-quality-official',
prompt: 'Дельфин прыгает через кристально чистые голубые воды океана, брызги воды, солнечный свет блестит на поверхности',
duration: 8,
size: '16:9',
resolution: '1080p',
metadata: {
generateAudio: true,
negativePrompt: 'размытый, низкое качество'
}
})
});
const task = await response.json();
console.log(`ID задачи: ${task.id}`);
console.log(`Статус: ${task.status}`);
{
"id": "video_01K8SGYNNNVBQTXNR4MM964S7K",
"object": "generation.task",
"model": "Veo3.1-quality-official",
"status": "queued",
"progress": 0,
"created_at": 1768380224,
"metadata": {}
}
Для пользователей из материкового Китая: используйте
https://toapis.cn в качестве эндпоинта (Base URL). Замените https://toapis.com на https://toapis.cn во всех примерах этого документа.- Асинхронный режим обработки, возвращает ID задачи для последующего запроса статуса
- Прямое подключение к Google Vertex AI с поддержкой всех нативных параметров Veo
- Поддержка генерации видео из текста, из изображения и интерполяции ключевых кадров
- Сгенерированные ссылки на видео действительны в течение 24 часов, пожалуйста, сохраните их заблаговременно
Важное изменение: Для улучшения производительности и контроля затрат мы больше не поддерживаем передачу данных изображений в формате base64 непосредственно в
image_urls. Пожалуйста, сначала используйте эндпоинт загрузки изображений для загрузки изображений, а затем используйте полученный URL в этом API.Авторизация
string
обязательно
Все эндпоинты требуют аутентификации Bearer TokenПолучить API Key: Перейдите на страницу управления API Key для получения вашего API KeyДобавьте в заголовки запроса:
Authorization: Bearer YOUR_API_KEY
Тело запроса
string
по умолчанию:"Veo3.1-quality-official"
обязательно
Название модели генерации видеоДоступные модели:
Veo3.1-quality-official- Модель высококачественной генерации, идеальна для финального производстваVeo3.1-fast-official- Модель быстрой генерации, идеальна для быстрого предпросмотра и итерацийVeo3.1-lite-official- Lite 720p Пример:"Veo3.1-quality-official"
string
обязательно
Текстовое описание для генерации видео
integer
Длительность видео в секундахПоддерживаемые значения:
4- 4 секунды6- 6 секунд8- 8 секунд (по умолчанию)
string
Соотношение сторон видеоПоддерживаемые форматы:
16:9(горизонтальное, по умолчанию)9:16(вертикальное)
string
Разрешение видеоПоддерживаемые значения:
720p(по умолчанию)1080p4k(preview)
string[]
Первый кадр для генерации видео из изображения. Видео будет начинаться с этого изображения. Используется только первый URL из массива.⚠️ Поддерживается только формат URL (base64 больше не поддерживается)
- Публично доступные URL изображений (http:// или https://)
- Используйте эндпоинт загрузки изображений для загрузки локальных изображений и получения URL
- Максимальный размер файла: 10MB
- Поддерживаемые форматы: .jpeg, .jpg, .png, .webp
image_urls и metadata.referenceImages нельзя использовать одновременно. Если указаны оба, image_urls (первый кадр) имеет приоритет, а referenceImages будет проигнорирован.object
Специальные параметры расширения Veo3 Official
Показать Показать поля metadata
Показать Показать поля metadata
boolean
Генерировать ли аудио. По умолчанию:
falseПри включении видео будет содержать сгенерированные ИИ звуковые эффекты и окружающий звукstring
Негативный промпт, описывающий контент, который вы не хотите видеть в видеоПример:
"размытый, низкое качество, искажённый"string
Настройка безопасности генерации людейПоддерживаемые значения:
allow_adult- Разрешить генерацию взрослых людейdont_allow- Не разрешать генерацию людей
string
URL изображения последнего кадра для генерации видео с интерполяцией ключевых кадровОбязательно используется вместе с
image_urls (первый кадр) для генерации переходного видео от первого кадра к последнему. Без image_urls не имеет эффекта.string[]
Массив URL справочных изображений стиля/ассетов. Видео будет учитывать визуальный стиль и элементы из этих изображений (они НЕ используются как начальный кадр).Ограничение: максимум 3 изображения⚠️ Нельзя использовать вместе с
image_urls — они взаимоисключающие в Veo API. Используйте image_urls для управления первым кадром.string
Качество сжатия видеоПоддерживаемые значения:
optimized(по умолчанию) - Оптимизированное сжатиеlossless- Сжатие без потерь
string
Режим изменения размера изображения при генерации видео из изображенияПоддерживаемые значения:
pad- Режим заполнения, сохраняет исходные пропорцииcrop- Режим обрезки, заполняет весь кадр
Ответ
string
Уникальный идентификатор задачи для запроса статуса
string
Тип объекта, всегда
generation.taskstring
Используемое название модели
string
Статус задачи
queued- В очереди на обработкуin_progress- Обрабатываетсяcompleted- Успешно завершенаfailed- Ошибка
integer
Процент выполнения задачи (0-100)
integer
Время создания задачи (Unix timestamp)
object
Метаданные задачи
curl --request POST \
--url https://toapis.com/v1/videos/generations \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"model": "Veo3.1-quality-official",
"prompt": "Дельфин прыгает через кристально чистые голубые воды океана, брызги воды, солнечный свет блестит на поверхности",
"duration": 8,
"size": "16:9",
"resolution": "1080p",
"metadata": {
"generateAudio": true,
"negativePrompt": "размытый, низкое качество"
}
}'
import requests
response = requests.post(
"https://toapis.com/v1/videos/generations",
headers={
"Authorization": "Bearer your-ToAPIs-key",
"Content-Type": "application/json"
},
json={
"model": "Veo3.1-quality-official",
"prompt": "Дельфин прыгает через кристально чистые голубые воды океана, брызги воды, солнечный свет блестит на поверхности",
"duration": 8,
"size": "16:9",
"resolution": "1080p",
"metadata": {
"generateAudio": True,
"negativePrompt": "размытый, низкое качество"
}
}
)
task = response.json()
print(f"ID задачи: {task['id']}")
print(f"Статус: {task['status']}")
const response = await fetch('https://toapis.com/v1/videos/generations', {
method: 'POST',
headers: {
'Authorization': 'Bearer your-ToAPIs-key',
'Content-Type': 'application/json'
},
body: JSON.stringify({
model: 'Veo3.1-quality-official',
prompt: 'Дельфин прыгает через кристально чистые голубые воды океана, брызги воды, солнечный свет блестит на поверхности',
duration: 8,
size: '16:9',
resolution: '1080p',
metadata: {
generateAudio: true,
negativePrompt: 'размытый, низкое качество'
}
})
});
const task = await response.json();
console.log(`ID задачи: ${task.id}`);
console.log(`Статус: ${task.status}`);
{
"id": "video_01K8SGYNNNVBQTXNR4MM964S7K",
"object": "generation.task",
"model": "Veo3.1-quality-official",
"status": "queued",
"progress": 0,
"created_at": 1768380224,
"metadata": {}
}