Нейросеть для генерации видео: как вызвать модель по API
Нейросеть для генерации видео через API нужна, когда приложение само отправляет сценарий и получает ролик для дальнейшей обработки. В Relay запрос отправляют на POST /v1/videos. Он создаёт асинхронную задачу, статус которой нужно проверять отдельно. Начните с выбора модели, проверки доступа и одного короткого сценария.
Коротко
До оплаченных пополнений на $10 генерация видео закрыта; приветственный бонус не учитывается.
Создание возвращает идентификатор задачи со статусом
queued.Скачайте результат сразу после
completed: задача хранится 30 минут после создания.
Как выбрать нейросеть для генерации видео под задачу
Сначала определите вход: текстовое описание или исходный кадр. Для текстовой пробы выбирайте модель, принимающую текст. Модель для оживления изображения может требовать кадр; название семейства этого не объясняет. Проверяйте назначение в каталоге видео.
Затем определите, нужен ли звук, какое разрешение требуется и как ролик будет размещён. Не добавляйте параметры наугад. Шлюз принимает model, prompt, seconds и необязательный size. Единый маршрут не означает одинаковую поддержку всех параметров.
В примере используется veo-3.1, существующая модель каталога. Для неё доступны длительности 4, 6 или 8 секунд, а разрешение выбирают из 720p, 1080p и 4k. Не считайте имя модели гарантией времени генерации. Перед запуском проверьте её доступность и цену.
Что проверить до первого платного запроса
Создайте ключ Relay и сохраните секрет при создании. Подтвердите почту, если кабинет требует этого для выпуска ключа. Проверьте доступный баланс и лимит ключа: все ключи используют общий баланс аккаунта.
Для нового аккаунта действует отдельное ограничение. До суммы оплаченных пополнений $10 создание видео получает 402 new_account_limit при любой цене. Бонус не снимает этот запрет. Условия и способы пополнения смотрите на странице цен и в кабинете.
Задайте длительность в seconds. Это целое число секунд; допустимые для конкретной модели значения проверяйте отдельно. Небольшое число в примере служит параметром учебного запроса, а не обещанием универсальной длительности для всех моделей.
Как создать запрос и сохранить ролик
Пример использует стандартную библиотеку Python и полный базовый адрес https://relay-llm.ru/v1. Сохраните его в make_video.py и запускайте в отдельной папке: результат будет записан в video.mp4. Повторный запуск перезапишет этот файл.
import json
import time
from pathlib import Path
from urllib.request import Request, urlopen
base = "https://relay-llm.ru/v1"
headers = {
"Authorization": "Bearer sk-demo-not-a-real-key",
"Content-Type": "application/json",
}
def get_json(method, path, payload=None):
body = None if payload is None else json.dumps(payload).encode("utf-8")
request = Request(base + path, data=body, headers=headers, method=method)
with urlopen(request, timeout=60) as response:
return response.status, json.load(response)
code, job = get_json("POST", "/videos", {
"model": "veo-3.1",
"prompt": "Белая кружка на столе, камера плавно приближается, без надписей",
"seconds": 8,
})
if code != 202 or job["status"] != "queued":
raise RuntimeError(f"Неожиданный ответ: {code} {job}")
job_id = job["id"]
Path("video-job.json").write_text(json.dumps(job), encoding="utf-8")
deadline = time.monotonic() + 600
while time.monotonic() < deadline:
time.sleep(5)
_, job = get_json("GET", f"/videos/{job_id}")
if job["status"] == "failed":
raise RuntimeError(json.dumps(job["error"], ensure_ascii=False))
if job["status"] == "completed":
request = Request(base + f"/videos/{job_id}/content", headers=headers)
with urlopen(request, timeout=60) as response:
Path("video.mp4").write_bytes(response.read())
break
if job["status"] not in {"queued", "in_progress"}:
raise ValueError(f"Неизвестный статус: {job['status']}")
else:
raise TimeoutError(f"Прекращён опрос, сохраните id задачи: {job_id}")Для реального вызова замените учебный ключ чтением секрета из окружения сервера. В коде ограничены число проверок и время одного HTTP-запроса. Это параметры примера, не пределы шлюза. Ошибка HTTP останавливает скрипт без автоматического создания новой генерации.
Создание возвращает id и статус queued; сохраните их до опроса. Для задачи статусы queued и in_progress означают ожидание, completed разрешает получение файла, failed завершает работу с ошибкой. Полный контракт есть в документации Video API.
Что делать при обрыве и ошибке
Если скрипт прекратил опрос, задача не обязательно остановилась. Сохраните её идентификатор и проверьте статус отдельным запросом GET /v1/videos/ID. Не повторяйте POST автоматически: новая генерация может создать ещё один платный результат.
Запрос статуса не обращается к модели и не стоит денег, но использует окно служебных методов. Выдерживайте паузу; при 429 учитывайте заголовки повтора. Файл забирают через /content с ключом аккаунта сразу после completed: задача хранится 30 минут после создания.
При 400 проверьте поля и длительность. При 402 различайте запрет нового аккаунта, нехватку доступного баланса и лимит ключа. При 404 проверьте модель, маршрут, принадлежность задачи аккаунту и срок доступа к файлу. Сохраняйте x-request-id, если он есть в ответе. Разбор кодов находится в справочнике ошибок.
Как проверить результат и списание
Просмотрите ролик целиком. Проверьте, что предмет сохраняет форму, движение соответствует запросу, а важные детали не исчезают между кадрами. Сохраните промпт и параметры вместе с файлом, чтобы повторить проверку.
Видео оплачивается за секунду готового ролика по цене каталога. Задача со статусом failed не списывается. Ролик, который завершился успешно, но не подошёл по творческим критериям, не равен технически неудачной задаче. Учитывайте такие попытки в стоимости принятого результата.
Нейросеть для генерации видео всегда отвечает задачей?
Да. POST /v1/videos возвращает идентификатор и статус queued; затем опрашивайте задачу до completed или failed.
Можно ли начать только с приветственного бонуса?
Для видео нужен выход из ограничений нового аккаунта через оплаченные пополнения. Бонус в порог $10 не входит.
Прекращение опроса отменяет генерацию?
Нет. Оно прекращает только ожидание в этом скрипте. Сохраните идентификатор и проверьте состояние задачи позже.
Можно ли хранить ссылку вместо файла?
Для долговременного использования сохраните файл у себя: задача хранится 30 минут после создания.