К содержимому
Блог

Нейросеть для генерации видео по тексту: путь через API

Нейросеть для генерации видео по тексту: путь через API

Нейросеть для генерации видео по тексту получает описание сцены и создаёт задачу для ожидания. В Relay Videos API возвращает её ID и статус queued. Ниже разберём бриф, создание, ожидание и сохранение результата. Учтите ограничение до запуска: по документации Relay видео доступно после оплаченных пополнений на $10; приветственный бонус в этот порог не входит.

Коротко

  • Описывайте одну сцену с одним действием и понятным движением камеры.

  • Сохраняйте ID задачи: повтор создания может запустить другую генерацию.

  • Заберите MP4 сразу после completed: задача хранится 30 минут после создания.

Как выбрать нейросеть для генерации видео по тексту

Ищите модель с текстовым входом, если у вас нет исходного кадра. Модель image-to-video требует другого входа и не становится текстовой только от изменения промта. В каталоге Relay проверьте тип, протокол и описание. В этой статье используется seedance-2.0: для текстового входа у неё доступны ролики на 5 или 10 секунд с разрешением 480p, 720p, 1080p или 4K.

Seedance 2.00,225 $ за секунду видео

До отправки выберите длительность и проверьте требования модели к параметрам. Шлюз читает seconds как целое число секунд, а size передают только когда его значение есть в документации выбранной модели. В примере запрошены пять секунд. Общий формат API не означает, что любой вариант примет одинаковый набор.

Если вам нужен ролик с озвучкой, титрами и монтажом, разделите эти задачи. Создание видео по тексту не подтверждает поддержку голоса или точных надписей. Сначала получите нужный кадр, затем добавляйте остальные части подходящими инструментами.

Как написать описание сцены

Рабочий бриф: «Бумажный кораблик медленно плывёт по луже слева направо. Крупный план, камера неподвижна на уровне воды. Пасмурное утро, мягкие отражения. Без людей, текста и логотипов». Здесь можно проверить объект, направление, кадр и ограничения.

Не смешивайте в первом запросе несколько локаций и монтажных переходов. Если кораблик должен пройти весь кадр, не просите одновременно смену плана и облёт камеры. При ошибке меняйте конкретную часть описания: направление движения, положение объекта или поведение камеры.

Для серии сцен отдельно зафиксируйте внешний вид объекта и условия света. Одинаковые слова в нескольких запросах не гарантируют визуальную непрерывность. Просмотрите стыки до того, как оплачивать все варианты продолжения.

Как создать задачу и сохранить результат через API

Пример Python использует стандартную библиотеку. Он сохраняет ID задачи и скачивает файл только с известного адреса Relay. Демонстрационный ключ нужно заменить локально. Предел ожидания в десять минут выбран для примера и не задаёт серверный срок выполнения.

python
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 call(path, payload=None):
    body = json.dumps(payload).encode("utf-8") if payload is not None else None
    request = Request(base + path, data=body, headers=headers)
    with urlopen(request, timeout=60) as response:
        return response.status, json.load(response)

code, result = call("/videos", {
    "model": "seedance-2.0",
    "prompt": "Бумажный кораблик плывёт слева направо. Камера неподвижна у воды. Без текста.",
    "seconds": 5,
})
if code != 202 or result["status"] != "queued":
    raise RuntimeError(f"Неожиданный ответ: {code} {result}")

Path("video-job.json").write_text(json.dumps(result), encoding="utf-8")
job_id = result["id"]
deadline = time.monotonic() + 600
while time.monotonic() < deadline:
    time.sleep(5)
    _, state = call(f"/videos/{job_id}")
    if state["status"] == "completed":
        request = Request(base + f"/videos/{job_id}/content", headers=headers)
        with urlopen(request, timeout=60) as response:
            video = response.read()
        break
    if state["status"] == "failed":
        raise RuntimeError(state["error"]["code"])
    if state["status"] not in {"queued", "in_progress"}:
        raise ValueError("Неизвестный статус задачи")
else:
    raise TimeoutError("Проверьте сохранённую задачу позже")

with Path("video.mp4").open("xb") as file:
    file.write(video)

При HTTP-ошибке скрипт завершится исключением. ID останется в video-job.json: продолжайте проверку его статуса, а не запускайте скрипт создания заново.

Как обработать ожидание и ошибки

Статусы queued и in_progress требуют ожидания; completed позволяет получить файл; failed завершает обработку с ошибкой. Метод проверки статуса не создаёт новую генерацию и не стоит денег, но ограничен окном служебных запросов. Опрос без паузы может получить 429.

Сохраняйте x-request-id и ID задачи отдельно. Первый нужен для разбора конкретного вызова, второй для проверки видео. Готовый файл забирайте сразу после completed: задача хранится 30 минут после создания. Срок хранения своего скачанного файла определяет ваше приложение.

Если потерян ответ самого создания и ID неизвестен, не обещайте восстановить задачу по произвольному локальному идентификатору: такого механизма этот пример не реализует. Сначала разберите вызов по журналу приложения и доступным данным. Повторный POST может создать ещё один ролик.

Как проверить качество и цену

Просмотрите ролик целиком: объект не должен исчезать, направление движения должно совпадать с брифом. Проверьте фактическую длительность и формат перед использованием в продукте. Красивый первый кадр не подтверждает качество остальных секунд.

По документации Videos API оплата идёт за секунду готового ролика, задача failed не списывает деньги. Обрыв соединения не отменяет успешную генерацию. Ставку смотрите в карточке модели, фактические вызовы в журнале, причины 402 и 429 в справочнике ошибок.

Нейросеть для генерации видео по тексту всегда возвращает задачу?

Да. Relay возвращает ID и статус queued; опрашивайте задачу до completed или failed.

Можно ли начать генерацию видео на приветственный бонус?

По документации Relay видео открывается после оплаченных пополнений на $10. Приветственный бонус не учитывается в этом пороге.

Закрытие вкладки отменяет генерацию?

Нет. Успешная генерация может завершиться и списаться после обрыва клиентского соединения. Сохраняйте ID и проверяйте уже созданную задачу.

Посмотреть модель видео по тексту

Модели из статьи

Готовы подключиться?Войдите в консоль, пополните баланс и создайте API-ключ.