Как пользоваться Veo 3.1 API? Первое видео за 5 минут

TL;DR

• Veo 3.1 — видеомодель Google, на HiAPI доступна в трёх версиях: стандартная, Fast и Lite, с text-to-video и image-to-video, откройте страницу модели и генерируйте онлайн, новым пользователям при регистрации — 200 кредитов.
• Оплата по секундам: Lite 720p без звука — $0.06/сек, Fast 720p/1080p со звуком — $0.25/сек, стандартная — $0.57/сек; 4-секундный черновик на Lite стоит всего $0.24.
• API в два шага: POST /v1/tasks — отправка, затем по taskId — результат. Скопируйте curl и Python ниже и запускайте.

Что умеет Veo 3.1?

• Нативный звук: изображение и звук генерируются вместе — эмбиент, эффекты и звуки действий следуют за картинкой; generate_audio включён по умолчанию, при отключении дешевле.
• Три длительности: 4, 6 и 8 секунд, горизонтальный 16:9 или вертикальный 9:16.
• До 4K: стандартная версия и Fast поддерживают 720p, 1080p, 4K; Lite — 720p, 1080p.
• Image-to-video: передайте изображение как первый кадр, и модель оживит его; соотношение сторон может следовать за исходником.

Это 6-секундное вертикальное видео 1080p сгенерировано одним запросом из продуктового фото кроссовка — глухой удар при приземлении и басовые биты модель подобрала сама:

The sneaker slowly rotates about 90 degrees as the camera pushes in from a low angle. Dust particles drift through the rim light. The shoe settles onto the wet stone pedestal with a deep, satisfying thud, sending a soft ring of mist rolling off the edges. A warm light sweep travels across the suede texture. Subtle bass-heavy electronic pulse builds in the background with a low whoosh on the landing. Cinematic product commercial, smooth stabilized motion, no text overlays.

Сгенерировать с этим промптом → (сначала загрузите продуктовое фото 9:16)

veo-3.1/image-to-video, 1080p, 6 секунд, со звуком, $3.42, от отправки до готовности около 115 секунд.

Какую версию выбрать?

Версия	720p/1080p со звуком	720p/1080p без звука	4K со звуком	Для чего
Lite veo-3.1-lite	$0.1 (720p) / $0.14 (1080p)	$0.06 (720p) / $0.1 (1080p)	—	Настройка промптов, пакетные черновики
Fast veo-3.1-fast	$0.25	$0.17	$0.6	Готовые короткие видео для соцсетей
Стандартная veo-3.1	$0.57	$0.29	$0.86	Реклама, брендовые ролики

Все цены за секунду. 8 секунд со звуком: Lite 1080p — $1.12, Fast — $2, стандартная — $4.56. Подробнее о ценах — в статье Цены Veo 3.1 API.

Два способа начать

Онлайн (без кода)

1. Откройте страницу модели Veo 3.1 Lite text-to-video, зарегистрируйтесь или войдите.
2. Вставьте промпт, выберите длительность, разрешение, соотношение сторон и решите, нужен ли звук.
3. Нажмите «Сгенерировать» и скачайте готовое видео.

Вызов API

1. Создайте API Key в консоли.
2. Отправьте задачу через POST https://api.hiapi.ai/v1/tasks, в ответ придёт taskId.
3. Проверяйте статус через GET /v1/tasks/{taskId}; когда status станет success, скачайте видео из output[0].url.

curl: первое видео

Сначала запустите на самом дешёвом Lite: 4 секунды, 720p, без звука — $0.24:

curl -X POST https://api.hiapi.ai/v1/tasks \
  -H "Authorization: Bearer $HIAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "veo-3.1-lite/text-to-video",
    "input": {
      "prompt": "A matte-black wireless earbud case slowly rotates on a reflective black surface under a single overhead spotlight.",
      "duration": 4,
      "resolution": "720p",
      "aspect_ratio": "9:16",
      "generate_audio": false
    }
  }'

Ответ:

{"code": 200, "data": {"taskId": "tk-hiapi-..."}, "message": "success"}

Проверка результата:

curl https://api.hiapi.ai/v1/tasks/tk-hiapi-... \
  -H "Authorization: Bearer $HIAPI_KEY"

Python: отправка, опрос, скачивание

# pip install requests；сначала export HIAPI_KEY=ваш ключ
import os, time, uuid, requests

KEY = os.environ["HIAPI_KEY"]
H = {"Authorization": f"Bearer {KEY}"}

def generate(prompt, model="veo-3.1-lite/text-to-video", timeout_s=900, **params):
    body = {"model": model, "input": {"prompt": prompt, **params}}
    # при повторной отправке той же задачи передавайте тот же Idempotency-Key, чтобы избежать двойного списания
    headers = {**H, "Idempotency-Key": str(uuid.uuid4())}
    r = requests.post("https://api.hiapi.ai/v1/tasks", json=body, headers=headers, timeout=30)
    r.raise_for_status()
    res = r.json()
    if res.get("code") != 200:
        raise RuntimeError(res)
    task_id = res["data"]["taskId"]
    deadline = time.time() + timeout_s
    while time.time() < deadline:
        d = requests.get(f"https://api.hiapi.ai/v1/tasks/{task_id}", headers=H, timeout=30).json()["data"]
        if d["status"] == "success":
            return d["output"][0]["url"]
        if d["status"] == "fail":
            raise RuntimeError(d)
        time.sleep(10)
    raise TimeoutError(task_id)

url = generate(
    "A barista pours hot water in a slow spiral over ground coffee, steam rising in morning light",
    duration=4, resolution="720p", aspect_ratio="16:9", generate_audio=True,
)
with open("clip.mp4", "wb") as f:
    f.write(requests.get(url).content)

Когда промпт готов, замените model на veo-3.1-fast/text-to-video или veo-3.1/text-to-video, чтобы получить финальный ролик — остальные параметры не меняются.

Image-to-video

Замените имя модели на …/image-to-video и добавьте изображение в input (image_url — строка, принимается только одно изображение):

{
  "model": "veo-3.1/image-to-video",
  "input": {
    "prompt": "The sneaker slowly rotates and settles onto the wet stone pedestal with a deep thud",
    "image_url": "https://your-cdn.example.com/sneaker-916.jpg",
    "aspect_ratio": "auto",
    "resolution": "1080p",
    "duration": 6
  }
}

• aspect_ratio со значением auto следует за исходным изображением; можно указать 16:9 или 9:16, изображения других пропорций будут обрезаны.
• Исходное изображение рекомендуется от 720p, 16:9 или 9:16; SVG не поддерживается.
• В промпте описывайте, «что происходит в следующие несколько секунд», не переописывайте всё изображение.

Что учесть перед запуском в продакшен

• Используйте callback вместо опроса: добавьте на верхний уровень запроса "callback": {"url": "https://ваш-домен/hiapi/callback"} — по завершении задачи HiAPI уведомит вас; дедуплицируйте по taskId.
• Сразу сохраняйте: output[0].url — временная ссылка, сохраните файл в своё хранилище сразу после получения.
• Указывайте все параметры: duration по умолчанию 8 секунд, для стандартной версии и Fast resolution обязателен; явно указывайте длительность, разрешение и generate_audio, чтобы расходы совпадали с бюджетом.
• Не нужен звук — отключите: с generate_audio: false Lite 720p дешевеет с $0.1 до $0.06 за секунду, стандартная — с $0.57 до $0.29.
• Автоматический возврат при ошибке: платите только за успешно сгенерированные видео.

Частые вопросы

Можно ли писать промпт по-китайски?

Да, можно по-китайски и по-английски. Наиболее стабильный результат — когда камера, действие и звук описаны отдельными фразами.

Можно ли сгенерировать 10-секундное видео?

За один раз поддерживаются только 4, 6 или 8 секунд. Более длинные ролики можно сгенерировать по частям и смонтировать.

Можно ли управлять звуком отдельно?

Опишите в промпте каждый слой звука (близкие звуки действий, голоса в окружении, ветер) — модель сгенерирует их отдельно; если звук не нужен, установите generate_audio в false.

Что менять при переходе с Lite на стандартную версию?

Только имя модели. prompt, duration, aspect_ratio, generate_audio универсальны; для 4K измените resolution на 4k (в Lite 4K нет).

Хотите готовые промпты — смотрите Примеры промптов Veo 3.1; также можно скопировать промпт про кроссовок выше и сгенерировать на странице модели.