Как использовать API Runway Gen-4.5? Первое видео за 5 минут

TL;DR

• Runway Gen-4.5 — это видеомодель Runway. В HiAPI есть два входа: текст-в-видео и изображение-в-видео. Откройте страницу модели, чтобы попробовать онлайн; новым пользователям при регистрации дают 200 кредитов.
• Оба входа стоят $0.1715 за секунду: 5 секунд — $0.8575, 8 секунд — $1.372, 10 секунд — $1.715.
• Как вызывать: отправьте POST /v1/tasks, получите taskId и проверяйте результат; готовое видео находится в output[0].url.

Что умеет Runway Gen-4.5

• Три длительности: 5, 8 и 10 секунд: 8 секунд как раз хватает на один наезд камеры, облёт или медленный подъём.
• Фиксированное 720p: горизонтальное 1280×720, вертикальное 720×1280, разрешение выбирать не нужно.
• В изображение-в-видео есть 5 форматов: 16:9, 9:16, 4:3, 3:4, 1:1 — из одного изображения можно получить версии для разных платформ.
• В готовом видео нет звуковой дорожки: картинку отдаём модели, звук добавляем при монтаже.

She turns her head toward the camera and smiles, hair moves in a light breeze, slow push-in

Сгенерировать с этим промптом → (загрузите первый кадр с портретом, выберите 5 секунд, 3:4)

runway-gen-4.5/image-to-video, 3:4, 832×1104, 5 секунд, $0.8575. Первый кадр: .

Она поворачивает голову от профиля к камере и улыбается, волосы слегка колышутся, камера плавно наезжает до крупного плана лица. В промпте описаны только движение и работа камеры — внешность персонажа и свет у окна целиком взяты из первого кадра.

Как выбрать между двумя входами

ID модели	Вход	Длительность	Формат	Когда подходит
runway-gen-4.5/text-to-video	промпт	5 / 8 / 10 секунд (9:16 только 5 / 10)	16:9, 9:16	нет материала, начинаете с текста
runway-gen-4.5/image-to-video	1 первый кадр + промпт	5 / 8 / 10 секунд	16:9, 9:16, 4:3, 3:4, 1:1	объект должен совпадать с исходным изображением, или нужен квадрат, 4:3, 3:4

Оба входа стоят одинаково — $0.1715 за секунду.

Два пути к первому результату

Попробовать в браузере (3 шага)

1. Откройте страницу модели текст-в-видео или изображение-в-видео и войдите.
2. Напишите промпт; для изображение-в-видео сначала загрузите первый кадр.
3. Выберите 5 секунд и формат, нажмите запуск.

Вызвать через API (3 шага)

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

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

curl -X POST https://api.hiapi.ai/v1/tasks \
  -H "Authorization: Bearer $HIAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "runway-gen-4.5/text-to-video",
    "input": {
      "prompt": "A lone stone lighthouse on a rugged sea cliff at dusk, heavy waves crashing against the rocks, the lamp beam sweeping across dark storm clouds, slow cinematic push-in, drifting sea mist, dramatic lighting",
      "duration": 5,
      "aspect_ratio": "16:9"
    }
  }'

5 секунд, 16:9, $0.8575. Готовое видео выглядит так:

A lone stone lighthouse on a rugged sea cliff at dusk, heavy waves crashing against the rocks, the lamp beam sweeping across dark storm clouds, slow cinematic push-in, drifting sea mist, dramatic lighting

Сгенерировать с этим промптом → (выберите 5 секунд, 16:9)

runway-gen-4.5/text-to-video, 16:9, 1280×720, 5 секунд, $0.8575.

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

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

API = "https://api.hiapi.ai/v1/tasks"
H = {"Authorization": f"Bearer {os.environ['HIAPI_KEY']}"}

def generate(model, timeout_s=900, **inp):
    # При повторной попытке с той же задачей передавайте тот же Idempotency-Key, чтобы избежать двойного списания
    r = requests.post(API, json={"model": model, "input": inp},
                      headers={**H, "Idempotency-Key": str(uuid.uuid4())}, timeout=30)
    r.raise_for_status()
    task_id = r.json()["data"]["taskId"]
    deadline = time.time() + timeout_s
    while time.time() < deadline:
        d = requests.get(f"{API}/{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)

# Изображение-в-видео: версия 1:1 из того же изображения, 8 секунд ($1.372)
url = generate(
    "runway-gen-4.5/image-to-video",
    prompt="The scene slowly comes alive: clouds drift, light shifts across the mountain lake, gentle forward camera move",
    image_urls=["https://ваш-хостинг/lake.jpg"],
    duration=8, aspect_ratio="1:1",
)
with open("clip.mp4", "wb") as f:
    f.write(requests.get(url).content)

Таблица параметров

Поле	Обязательно	Значения	Описание
prompt	да	1–1000 символов	Опишите объект, действие и камеру; для изображение-в-видео только действие и камеру
duration	нет	5 (по умолчанию) / 8 / 10	В текст-в-видео для 9:16 только 5 / 10
aspect_ratio	нет	текст: 16:9 (по умолчанию) 9:16; изображение: 16:9 (по умолчанию) 9:16 4:3 3:4 1:1	В изображение-в-видео первый кадр обрезается по центру под выбранный формат
image_urls	обязательно для изображение-в-видео	только 1, jpeg/png/webp, ≤10MB	Первый кадр; в текст-в-видео это поле не принимается

Нет resolution, seed, negative_prompt, а также последнего кадра.

Ошибки, которые вы встретите

Если при отправке параметры неверны, интерфейс сразу возвращает 400, задача не создаётся и деньги не списываются:

• duration: value must be one of 5, 10: в текст-в-видео выбран 9:16 и передано 8 секунд.
• duration: value must be one of 5, 8, 10: длительность бывает только из этих трёх вариантов.
• image_urls: maxItems: got 2, want 1: изображение-в-видео принимает только один первый кадр, последний кадр не поддерживается.
• image_urls: missing required field "image_urls": в изображение-в-видео не передан первый кадр.
• prompt: maxLength: got 3,000, want 1,000: промпт длиной не более 1000 символов.
• additional properties 'negative_prompt', 'cfg_scale' not allowed: этих полей в Runway Gen-4.5 не существует.

Перед запуском в продакшен

• Используйте callback вместо опроса: на верхнем уровне запроса (на одном уровне с input) добавьте "callback": {"url": "https://ваш-домен/hiapi/callback"} и дедуплицируйте по taskId.
• Скачивайте вовремя: output[0].url истекает примерно через 7 дней, сохраняйте результат в своё хранилище сразу после получения.
• Явно указывайте duration и aspect_ratio: для вертикального текст-в-видео избегайте 8 секунд, надёжнее всего прописать это в коде.
• При повторных попытках используйте ключ идемпотентности: добавьте в заголовки Idempotency-Key, один ключ создаёт задачу только один раз.

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

Можно ли получить 1080p или 4K?

Нет, вывод фиксированно 720p. Для 1080p можно использовать Kling 2.5 Turbo, сравнение смотрите в статье Сравнение Runway Gen-4.5 и Kling 2.5 Turbo.

Есть ли звук в готовом видео?

Нет, на выходе только изображение. Музыку, звуковые эффекты и закадровый голос добавляйте при монтаже.

Можно ли добавить последний кадр в изображение-в-видео?

Нет, image_urls принимает только одно изображение. Чтобы управлять концовкой с помощью последнего кадра, используйте изображение-в-видео в Kling 2.5 Turbo.

Что будет, если пропорции первого кадра и формата не совпадают?

Первый кадр обрезается по центру под выбранный формат; надёжнее всего размещать объект по центру.

Подробности о ценах смотрите в статье Цены API Runway Gen-4.5, больше сценариев — в статье Полный гид по промптам Runway Gen-4.5. Хотите сначала увидеть результат — скопируйте промпт с маяком выше и сгенерируйте первое видео на странице модели.