Настройка Runway Video API
Runway — это платформа для генерации видео. Обычно ее нельзя просто вставить как Base URL в Chatbox. Вместо этого создайте API Key на платформе Runway, а затем используйте официальный SDK или HTTP-запросы для запуска задач генерации видео.
Официальная информация Загрузки и документация приведены согласно официальному сайту.
Для каких сценариев подходит
Text-to-VideoImage-to-VideoАсинхронные задачиОфициальный SDK
Сначала разберитесь с процессом обработки видеозадач
- Создайте API Key и убедитесь, что у вашего аккаунта есть права доступа к Video API и достаточный баланс.
- Выберите тип задачи: text-to-video, image-to-video или другие типы видеозадач, поддерживаемые официальной документацией на данный момент.
- Вы не получите готовый видеофайл сразу после отправки задачи; обычно сначала возвращается объект задачи или ее идентификатор (Task ID).
- Дождитесь завершения задачи, затем получите адрес готового файла или скачайте результат.
- В случае ошибки сначала проверьте статус задачи и детали ошибки, а не только валидность ключа.
Подготовка параметров
| Элемент конфигурации | Способ заполнения |
|---|---|
| API Key | Создается в личном кабинете Runway; официальный SDK по умолчанию считывает <code>RUNWAYML_API_SECRET</code> |
| Task | text-to-video / image-to-video |
| Prompt | Описание содержания видео |
| Ratio / Size | Альбомная, портретная ориентация или заданный размер |
| Duration | Длительность видео |
| Status | Опрос статуса задачи до ее завершения |
| Параметр | Описание | Советы новичкам |
|---|---|---|
| API Key | Учетные данные для запросов к Runway API | Сохраняйте только в переменных окружения на локальном компьютере или сервере с именем RUNWAYML_API_SECRET |
| Prompt | Описание содержания видео | Сначала пишите лаконично, а затем уточняйте детали после того, как определитесь со стилем |
| Image | Исходное изображение для image-to-video | Загружайте четкие изображения с выраженным объектом съемки |
| Duration | Длительность видео в секундах | Сначала протестируйте стоимость и результат на коротких видео |
| Status | Статус задачи | Генерация видео происходит асинхронно и требует времени до завершения. |
Пример работы с SDK
Имя переменной окружения Runway
RUNWAYML_API_SECRET=YOUR_RUNWAY_API_KEYПример задачи в Runway Node.js
import RunwayML, { TaskFailedError } from "@runwayml/sdk"; const client = new RunwayML(); try { const task = await client.imageToVideo.create({ model: "gen4.5", promptText: "A product introduction video on a white background with a slow camera push-in", ratio: "1280:720", duration: 5 }).waitForTaskOutput(); console.log(task.output[0]); } catch (error) { if (error instanceof TaskFailedError) { console.error(error.taskDetails); } }Поля видеоплатформы обновляются вместе с версиями моделей. Пример на странице предназначен для понимания структуры конфигурации, а конкретный список параметров сверяйте с актуальной официальной документацией.
| Проблема | Первичная проверка | Решение |
|---|---|---|
| Видео не возвращается сразу после отправки | Находится ли задача в очереди или в процессе генерации? | Генерация видео — это асинхронная задача; дождитесь изменения статуса на завершенный перед получением результата. |
| Ошибка выполнения задачи | Название модели, пропорции, длительность, соответствует ли исходное изображение требованиям текущей модели | Скорректируйте параметры согласно деталям возвращенной ошибки; не меняйте слишком много настроек одновременно. |
| Стоимость оказалась выше ожидаемой | Длительность, разрешение, версия модели | Сначала протестируйте генерацию с короткой длительностью и экономными параметрами, прежде чем запускать массовую обработку |