OpenMotion для создания видео, к какому разделу подключать ключ? Генерация изображений и озвучка идут через совместимый интерфейс, для кадров нужно отдельное подключение.

Примечание автора: разбираем пять этапов производства в OpenMotion по README, примечаниям к выпуску и документации провайдеров. Объясняем, какие из них можно подключить одним OpenAI-совместимым ключом, а видеосцены, которые так не подключить, — как сгенерировать снаружи и потом импортировать.

Когда вы делаете свой фильм в OpenMotion и у вас под рукой есть API-ключ, первая мысль обычно — вставить его в OpenAI-совместимое подключение в Model Settings и ждать, что изображения, озвучка, видеосцены и музыка заработают все сразу. Но по документации репозитория, один совместимый ключ в OpenMotion отвечает только за два протокола — генерацию изображений и озвучку. Транскрибация субтитров — третий, отдельный интерфейс, а видеосцены и музыка в совместимый слот не входят.

Это не очередная статья про хайп вокруг репозитория: здесь мы не делаем выводов по количеству звёзд, а сверяем README, примечания к выпуску v0.1.1 и документацию провайдеров — и по каждому пункту проверяем, куда можно подключить ключ. У каждого описания возможности указан источник; ни одно не основано на реальных тестах.

Главная ценность: после этой статьи вы сами сможете решать, какие этапы отдать совместимому интерфейсу, для каких сменить провайдера, а какие сначала сгенерировать снаружи и импортировать в OpenMotion.

openmotion-api-key-image-narration-video-setup-ru-image-0


Основные моменты подключения ключей для создания видео в OpenMotion

Сразу вынесу выводы в таблицу. «Ожидаемый протокол» в таблице взят из файлов репозитория docs/provider-settings.md и compatible.md — он показывает, что реализовано на стороне OpenMotion, но не означает, что каждая платформа предоставляет соответствующий эндпоинт.

Этап создания Ожидаемый протокол OpenMotion Можно ли подключить совместимый ключ напрямую Что делать, если подключить не удаётся
Генерация изображений POST base + /images/generations, читаем b64_json или url Да, при условии, что платформа предоставляет этот эндпоинт Выбрать платформу с эндпоинтом генерации изображений
Озвучка POST base + /audio/speech, в теле — input, обязательно voice, возвращает бинарный аудиофайл Протокол реализован, но у платформы должен реально существовать этот эндпоинт Сменить провайдера на того, у кого есть этот эндпоинт, или импортировать свою запись
Субтитры POST base + /audio/transcriptions, нужны реальные временные метки Это отдельный интерфейс, он не общий с озвучкой Написать вручную в Studio или импортировать файл субтитров
Видеоряд Через fal.ai, Atlas Cloud, WaveSpeedAI или OpenDesign Cloud Нет Сгенерировать готовый ролик вовне и импортировать
Музыка/звуковые эффекты Как и для видеоряда; в совместимом протоколе музыка и звуковые эффекты не реализованы Нет Сменить провайдера или импортировать своё аудио

Совмевимый интерфейс OpenMotion распознаёт только генерацию изображений и озвучку

В репозитории docs/provider-settings.md всё сказано прямо: через OpenAI-совместимое подключение можно выполнить /images/generations и бинарный /audio/speech, причём для речи обязательно нужен voice. Anthropic и Google Gemini здесь — только настройка каталога, универсального медиаадаптера нет, поэтому даже если вписать ключ Claude или Gemini, способности генерировать изображения или озвучивать текст сами собой не появятся. А видео и музыка явно отданы fal.ai, Atlas Cloud, WaveSpeedAI или OpenDesign Cloud.

В compatible.md тоже очерчены границы совместимого адаптера. Генерация изображений — только текст-в-изображение, без редактирования и загрузки картинок, без асинхронного видео; озвучка возвращает бинарное аудио, но протоколы для музыки и звуковых эффектов не реализованы. В docs/model-gateway.md (с пометкой об обновлении от 2026-11-15) добавлено: универсальное совместимое подключение реализует стандартный речевой протокол и вовсе не означает, что у таких подключений есть переносимый интерфейс для музыки или звуковых эффектов. Иными словами, «совместимость» заканчивается на речи.

Три списка моделей в README OpenMotion не стоит смешивать

В README в разных местах приведены три списка, у них разное назначение, и их нельзя объединять в одну «таблицу поддерживаемых моделей OpenMotion».

  • Пример в начале: генерация изображений, добавление кадра, музыкальное сопровождение и озвучка иллюстрируются как GPT Image 2.6, Seedance 2.5, Suno, Eleven v4 — чтобы показать, как выглядит рабочий процесс.
  • Раздел каталога fal.ai: после подключения fal.ai в Model Settings и обновления каталога можно найти GPT Image 2.6, Nano Banana 2.1, FLUX.3, Seedance 2.5, Kling 4.0, Wan 3.0, Eleven v4. Это каталог, доступный через fal.ai.
  • Таблица возможностей: изображения — Codex Image, Nano Banana 2 via Atlas Cloud, FLUX Schnell via fal.ai; видео — Seedance 2.0 via Atlas Cloud, Wan 2.2 via fal.ai; музыка — Suno v4 via Atlas Cloud; речь — Kokoro via fal.ai.

Эти три списка отвечают на три разных вопроса: «как выглядит рабочий процесс», «что есть в каталоге конкретного провайдера» и «какие варианты подключения описаны в документации». Если в начале упомянут Seedance 2.5, это не значит, что ваш совместимый ключ позволит в OpenMotion напрямую получить кадр Seedance.

openmotion-api-key-image-narration-video-setup-ru-image-1


OpenMotion: быстрое начало работы с видео — подключаем ключи по шагам

Давайте пройдём весь путь создания ролика по порядку. На каждом шаге сначала разберём, чего ждёт OpenMotion, а потом — подходит ли ваш ключ.

Шаг 1: подготовка локального окружения OpenMotion

В разделе установки README перечислены такие требования — лучше убедиться, что всё на месте, ещё до подключения ключей:

  1. Node.js 26.11.1: версия, прямо указанная в README.
  2. Установка из исходников — способ по умолчанию: опубликованное приложение в npm — лишь опция; README отдельно предупреждает, что published versions can lag, то есть новые функции могут появляться с опозданием.
  3. Chrome или Chromium, а также FFmpeg: от них зависят и локальный предпросмотр, и экспорт.
  4. Docker Compose (необязательно): в заметках к релизу v0.1.1 написано, что Studio можно локально открыть из исходников через Docker Compose.

В README также сказано, что само ПО не берёт денег за подписку и не взимает плату за рендеринг по каждому запросу — каждый провайдер тарифицирует по вашему собственному аккаунту. Кроме того, можно вообще не обращаться к интерфейсам генерации, а просто импортировать свои видео, изображения и аудио — этот вариант ещё не раз пригодится на этапах, где подключиться не получится.

Шаг 2. Настройка совместимого подключения в слоте генерации изображений OpenMotion

Генерация изображений — самая надёжная часть при работе с совместимым ключом. Возьмём для примера APIYI: это OpenAI-совместимая платформа-агрегатор моделей, где один ключ даёт доступ к моделям нескольких крупных провайдеров, а endpoint генерации изображений /v1/images/generations как раз совпадает с путём, который нужен адаптеру генерации изображений OpenMotion. В Model Settings заполняем примерно так:

Поле Что заполнить Комментарий
Тип подключения OpenAI-совместимое Только этот тип использует /images/generations
Base URL https://api.apiyi.com/v1 Адаптер допишет к нему /images/generations
API Key Токен, созданный в консоли платформы Убедитесь, что группа токена включает группу выбранной модели
Модель изображений gpt-image-2.6-all, gpt-image-2.6-flare или gpt-image-2.6-sunburst Соответствует GPT Image 2.6 из примеров в README
Формат ответа b64_json или url Адаптер понимает оба варианта

После заполнения сначала сгенерируйте один статичный кадр, чтобы убедиться, что цепочка работает. Учтите: совместимый адаптер генерации изображений OpenMotion не поддерживает загрузку изображений для редактирования — операция «изменить уже существующую картинку» по этой цепочке не пройдёт. Можно только сгенерировать изображение заново или импортировать уже подготовленное во внешнем редакторе.

🚀 Быстрый старт: на этапе генерации изображений советую сначала прогнать одну картинку в APIYI apiyi.com на бесплатном тестовом лимите для новых пользователей — убедитесь, что Base URL, группа токена и ID модели совпадают, — а уже потом массово генерировать статичные кадры для раскадровки.

Шаг 3. Для озвучки и субтитров OpenMotion сначала проверяем эндпоинты

Слоту озвучки нужен /v1/audio/speech, а слоту субтитров — /v1/audio/transcriptions; это два разных интерфейса. Если смотреть на интерфейс цен APIYI по состоянию на 2026-11-20, публично доступны только /v1/messages, /v1/embeddings, Gemini generateContent, /v1/images/generations, /v1/chat/completions и /v1/responses. Ни /v1/audio/speech, ни /v1/audio/transcriptions там нет.

В сводной таблице у эндпоинтов tts-1 и tts-1-hd указан только chat, а адаптер озвучки OpenMotion отправляет запросы на /audio/speech. Так что просто вписать эти ID моделей в слот озвучки и надеяться, что звук появится, нельзя. Здесь есть два пути: найти провайдера, который действительно даёт /audio/speech и поддерживает параметр voice, или записать аудио самостоятельно и импортировать его напрямую.

А вот с субтитрами в v0.1.1 всё даже проще. В примечаниях к релизу написано, что в Studio можно создавать, импортировать или вручную писать субтитры, а затем экспортировать их в SRT или VTT. В разделе про субтитры в compatible.md (проверено 2026-11-17) напоминают: экспортировать SRT или VTT можно только при наличии реальных временных меток; из одного текста таймлайн не собрать. Если эндпоинта транскрипции нет, самый прямой вариант — написать субтитры вручную или импортировать файл с уже готовым таймлайном.

Шаг 4: генерируем кадры OpenMotion на стороне и импортируем их

Сегмент кадра нельзя вставить в слот совместимости. Кадры в OpenMotion всё равно генерируются через fal.ai, Atlas Cloud или WaveSpeedAI. Если ваш лимит на видео висит на другой платформе — генерируйте готовый фрагмент там, а потом импортируйте файл в Studio. Экспорт отдельного MP4-фрагмента, который появился в v0.1.1, тоже удобен: можно отдельно проверить кусок с заменёнными кадрами. Как именно генерировать Seedance 2.5 вовне — расскажем в следующем разделе.

openmotion-api-key-image-narration-video-setup-ru-image-2


Как сопоставить модели генерации изображений OpenMotion и цены

Когда проверяешь модели и сверяешь цены, проще всего ошибиться, если смешать цифры с разных страниц в одну цену. Ниже данные из трёх источников APIYI приведены отдельно; даты чтения указаны в заголовках таблицы, а при расхождениях сохранены оба варианта.

ID модели Сводная таблица (данные на 2026-11-19 10:59) Интерфейс цен (прочитано 2026-11-20) Страница описания
gpt-image-2.6-all 0.025 USD за вызов; эндпоинты chat, images; группы Default, image2_OSS, SVIP model_price 0.025; эндпоинты image-generation, openai на странице описания указано gpt-image-2-all — 0.025 USD/изображение, а не 2.6
gpt-image-2.6-flare 0.2 USD за вызов; из эндпоинтов указаны только images; группы Default, image2Enterprise, image2_OSS, SVIP model_price 0.2, также с billing_expr (p * 5 + cr * 1.25 + img * 8 + img_cr * 2 + c * 30); эндпоинты image-generation, openai официальный маршрут по токенам: текст на входе 5, изображения на входе 8, изображения на выходе 30 USD за миллион токенов; чтение из кэша: текст 1.25, изображения 2 USD
gpt-image-2.6-sunburst как у flare: 0.2 USD за вызов, из эндпоинтов указаны только images как у flare как выше, по токенам

Как видно, в сводной таблице flare и sunburst записаны как 0.2 USD за вызов, а из эндпоинтов указаны только images. В интерфейсе цен, помимо 0.2, есть ещё формула расчёта по токенам, а среди эндпоинтов добавился openai. На странице описания цена официального маршрута указана по токенам, а также сказано, что text-to-image через официальный маршрут идёт по /v1/images/generations и возвращает b64_json. Эти описания не полностью совпадают, и мы не сводим их в единую цену. Фактическое списание проверяйте по списку моделей в консоли apiyi.com на момент оформления заказа.

Для слота генерации изображений в OpenMotion ключевая информация — это, собственно, эндпоинты: у всех трёх моделей эндпоинт изображений совпадает с /images/generations, а формат ответа — b64_json, который адаптер умеет читать.

Что касается музыки и озвучки: Suno и Eleven v4 из примера в README не встречаются ни в сводной таблице на 2026-11-19, ни в интерфейсе цен, прочитанном 2026-11-20; в сводной таблице нет и whisper. Suno и Eleven v4 пока не добавлены в каталог — мы как можно скорее добавим эти модели. Модели и цены — по списку моделей на платформе.

openmotion-api-key-image-narration-video-setup-ru-image-3


Сегмент кадров OpenMotion: почему Seedance 2.5 не попадает в слот совместимости

ID модели Seedance 2.5 в APIYI — doubao-seedance-2-5-260628. В слот совместимости OpenMotion она не попадает по двум причинам: адаптер совместимости OpenMotion в принципе не работает с асинхронным видео, а doubao-seedance-2-5-260628 в APIYI тоже идёт через собственный интерфейс задач, а не через совместимый видеоинтерфейс.

Пункт Сводная таблица (2026-11-19) Интерфейс цен (2026-11-20) Страница описания Seedance2
Эндпоинт указан только chat только openai (то есть chat) POST /seedance/api/v3/contents/generations/tasks
Группа SeeDance2 только SeeDance2; множители групп SeeDance2, SD2Fast и SD2Mini — все 0.18 в токене нужно отметить SeeDance2, множитель 0.18x
Как записана цена по объёму: вход 70, выход 70 долларов за миллион токенов, по чтению из кеша данных нет та же модель, пересчёт по множителю группы пример 720p, 5 секунд, без входного видео — 1.3721 доллара
Режим тарификации по объёму по объёму по объёму (приоритет) или по объёму

Здесь два числа не стоит путать. 70 долларов за миллион токенов в сводной таблице — это прайс-листовая цена; а 1.3721 доллара на странице описания — конкретный пример, в котором уже применён множитель 0.18 группы SeeDance2. Умножаем цену из сводной таблицы на 0.18 — получаем 12.60 долларов за миллион токенов; умножаем на 108900 токенов, которые фигурируют в примере на странице описания, — выходит примерно 1.37 доллара, что точно соответствует тому примеру. То есть это два уровня одной и той же схемы тарификации, а не два разных прайса, между которыми можно выбирать.

С названиями групп тоже есть расхождения: в сводной таблице fast и mini записаны как SD2-Fast-Cheap и SD2-Mini-Cheap, а в интерфейсе цен они называются SD2Fast и SD2Mini. При создании токена ориентируйтесь на название группы, которое реально показывает консоль, а не вписывайте вслепую имя с какой-то одной страницы.

Если перейти к практике создания ролика: сначала отправляем задачу на кадр в интерфейс задач Seedance от APIYI, после завершения скачиваем готовый ролик, затем импортируем видеофайл на таймлайн OpenMotion и монтируем вместе со стоп-кадрами, сгенерированными через интерфейс совместимости, и закадровым голосом, записанным снаружи.

💡 Совет по выбору: если квоты на кадры и квоты на генерацию изображений хочется вести под одним ключом, можно в APIYI apiyi.com отметить в токене сразу и группу генерации изображений, и группу SeeDance2: изображения подставляем в OpenMotion, кадры генерируем через интерфейс задач и импортируем — и счёт сверяется в одной панели.


Часто задаваемые вопросы (FAQ)

Q1: Что такое OpenMotion?

OpenMotion — это открытая Studio для создания видео от nexu-io, лицензия Apache-2.0, репозиторий создан 2026-05-11. В описании репозитория сказано, что поддерживаются 22 агента, среди них названы Claude Code, Codex, DSH и WorkBuddy. Согласно README, сама программа не берёт плату за подписку и рендеринг, а генерация через API оплачивается с вашего собственного аккаунта у провайдера.

Q2: Чем совместимый API OpenMotion отличается от fal.ai и Atlas Cloud?

В OpenMotion совместимый интерфейс реализует только два эндпоинта: `/images/generations` и `/audio/speech`, а для субтитров отдельно используется `/audio/transcriptions`. Именно fal.ai, Atlas Cloud, WaveSpeedAI и OpenDesign Cloud указаны в документации как каналы для видео и музыки. Если хотите генерировать сцены прямо внутри Studio, придётся использовать только этих провайдеров.

Q3: Когда вышел OpenMotion v0.1.1 и что изменилось?

v0.1.1 вышел 2026-11-18 в 19:32 по пекинскому времени. Согласно release notes: субтитры можно генерировать, импортировать или писать вручную и экспортировать в SRT или VTT; можно отдельно экспортировать нужный фрагмент в MP4; добавлено 96 Skills; можно локально запустить Studio из исходников через Docker Compose; опциональный плагин DeepSeek Harness размещает Studio рядом с чатом. Всё это взято из release notes, а не из результатов тестирования.

Q4: Можно ли указать tts-1 в слоте озвучки OpenMotion?

Напрямую — нет. Слот озвучки отправляет запросы на `/v1/audio/speech`, должен содержать `voice` и возвращает аудио в бинарном виде. А в сводной таблице APIYI у `tts-1` и `tts-1-hd` в эндпоинте указан только chat, и в публичных эндпоинтах интерфейса цен `/v1/audio/speech` тоже нет. Для озвучки лучше взять провайдера, у которого есть этот эндпоинт, либо записать аудио заранее и импортировать его.

Q5: Как быстро подключить генерацию изображений к OpenMotion через API?

Шаги короткие:

1. Зарегистрируйтесь на APIYI (apiyi.com) и получите бесплатный тестовый лимит.
2. Создайте токен; в его группе должна быть доступна нужная вам модель для изображений, например Default.
3. В OpenMotion Model Settings создайте подключение, совместимое с OpenAI: в Base URL укажите `https://api.apiyi.com/v1`, в поле модели — `gpt-image-2.6-all` или другой ID из списка доступных.
4. Сгенерируйте один статичный кадр для проверки — адаптер прочитает `b64_json` или `url` из ответа.

Q6: Как поместить сцены, созданные Seedance 2.5, в OpenMotion?

Отправьте задачу с моделью `doubao-seedance-2-5-260628` через эндпоинт задач `POST /seedance/api/v3/contents/generations/tasks`; в токене должна быть отмечена группа SeeDance2. После завершения задачи скачайте видеофайл и в OpenMotion добавьте его на таймлайн как импортированный материал. Цены смотрите отдельно в двух местах: в сводной таблице указано по 70 долларов США за миллион токенов на входе и на выходе, а в примере на странице описания для 720p и 5 секунд указано $1.3721 после пересчёта.

Q7: Какие известные ограничения есть у такого способа подключения?
  • Генерация изображений: адаптер совместимости не умеет загружать и редактировать картинки — доступно только текст-в-изображение.
  • Закадровый голос и субтитры: протокол OpenMotion уже реализован, но нужна платформа, которая реально предоставляет /audio/speech и /audio/transcriptions; без настоящих таймкодов субтитры не выгрузить в SRT или VTT.
  • Музыка и звуковые эффекты: в протоколе совместимости не реализованы, так что остаются только fal.ai, Atlas Cloud, WaveSpeedAI, OpenDesign Cloud или импорт собственного аудио.
  • Цены: в сводной таблице, в API ценообразования и на странице описания формулировки для одной и той же модели немного расходятся — перед заказом сверяйтесь со списком моделей на платформе.

Ключевые выводы по подключению OpenMotion к видео по API-ключу

  • Слот совместимости признаёт только два протокола: генерация изображений /images/generations и закадровый голос /audio/speech; субтитры — это третий интерфейс.
  • Видеокадры и музыка в слот совместимости не попадают: генерация внутри Studio идёт через fal.ai, Atlas Cloud, WaveSpeedAI или OpenDesign Cloud.
  • Три списка в README не стоит объединять: примеры во вступлении, каталог fal.ai и таблица возможностей служат каждый своей цели.
  • Для генерации изображений есть готовые модели в каталоге: gpt-image-2.6-all, gpt-image-2.6-flare, gpt-image-2.6-sunburst — все они соответствуют эндпоинту изображений.
  • Цены смотрите отдельно по источникам: сводная таблица — за вызов, API ценообразования — с формулой, страница описания — за токены; не сводите всё в одну цену.
  • Если не подключается — генерируйте снаружи и импортируйте: Seedance 2.5 выдаёт видео через интерфейс задач, скачайте файл и импортируйте его на таймлайн.
  • Для старта прогоните одну картинку: проверьте Base URL и группу токена на бесплатной квоте APIYI, а потом расширяйтесь на остальные этапы.

Резюме

Если делать собственный ролик в OpenMotion, схему подключения ключей можно свести к трём пунктам:

  1. Генерация изображений — через совместимый интерфейс: Base URL указывает на платформу, у которой есть /images/generations, дальше достаточно вписать ID модели GPT Image 2.6, доступной на этой платформе.
  2. Закадровый голос и субтитры — сначала проверьте эндпоинты: протокол OpenMotion их поддерживает, но если на платформе нет /audio/speech и /audio/transcriptions, меняйте провайдера либо пишите вручную или импортируйте готовое.
  3. Кадры и музыкальное сопровождение подключаются отдельно: генерируйте материал вовне и импортируйте, либо подключайте в Studio fal.ai, Atlas Cloud, WaveSpeedAI.

Прежде чем что-то делать, выпишите по таблице разделов из этой статьи, какой интерфейс соответствует каждому этапу — это куда проще, чем набить все ключи подряд, а потом разбираться с ошибками. Генерацию изображений и кадры Seedance можно вести через один токен на APIYI apiyi.com: сначала проверить всю цепочку на бесплатной квоте, а уже потом решать, как разделить работу для финального ролика.


📚 Справочные материалы

  1. Репозиторий и README OpenMotion: требования к установке, три списка моделей, описание тарификации

    • Ссылка: github.com/nexu-io/openmotion
    • Описание: ветка main прочитана 2026-11-20; включает версию Node.js, зависимости Chrome и FFmpeg
  2. Примечания к релизу OpenMotion v0.1.1: субтитры, экспорт одного сегмента, Docker Compose и другие обновления

    • Ссылка: github.com/nexu-io/openmotion/releases/tag/v0.1.1
    • Описание: выпущен 2026-11-18; все описания возможностей версии в этой статье взяты с этой страницы
  3. Документация провайдеров OpenMotion: границы протокола, которые реализует совместимый интерфейс

    • Ссылка: github.com/nexu-io/openmotion/blob/main/docs/provider-settings.md
    • Описание: файлы docs/model-gateway.md и skills/openmotion-media/references/providers/compatible.md из того же каталога дополняют детали по трём интерфейсам — генерации изображений, озвучке и субтитрам
  4. Сводная таблица моделей APIYI, страницы описания возможностей и интерфейс цен: ID моделей, эндпоинты, группы и цены

    • Ссылка: docs.apiyi.com/models.md
    • Описание: на том же сайте /api-capabilities/gpt-image-2/overview.md и /api-capabilities/seedance2/overview.md — это страницы описаний; путь интерфейса цен — /api/pricing на поддомене api, pricing_version — shell-api-modelmak-v1

Автор: техническая команда APIYI
Обсуждение технических вопросов: если при подключении не сходятся модели, группы или эндпоинты — напишите нам через главную страницу сайта APIYI

Оставьте комментарий