openFlow — MCP для Google Flow

Почему openFlow

Google Flow без браузера — как программный API.

Реверс-инжиниринг приватного API Google Flow, обёрнутый в очередь задач, REST и MCP. Мультитенантно: каждый ключ видит только свои аккаунты.

// pure-http

Без эмулятора

Токены минтятся по чистому HTTP через gpsoauth. Никакого Android-устройства на хосте.

// your-account

Твой аккаунт

Привязываешь свой Google-аккаунт со своими кредитами. Пароль не покидает твой Mac.

// agent-native

Внутри агента

Работает в Claude Code и Codex как MCP. Генерация — обычный вызов инструмента.

// multi-tenant

Изоляция

Каждый ключ — своя owner-группа. Чужие аккаунты и медиа недоступны by design.

Возможности

Полный набор инструментов Flow.

Каждый инструмент — асинхронная задача: быстрый результат приходит сразу, долгий отдаёт job_id для опроса.

Изображение

generate_image()

Текст → изображение. Модель NARWHAL, любые пропорции, edit-in-place по mediaId.

promptmodelaspectimage_inputs

Видео

generate_video()

Текст → видео. Тиры Omni Flash и Veo 3.1 (Lite/Fast/Quality), 4–10 секунд.

promptvideo_model_keyaspect

Видео · reference

…with_reference()

r2v: до 3 референс-изображений задают персонажа/субъект для консистентного видео.

reference_imagesprompt

Видео · кадр

…from_image()

i2v: видео начинается с заданного стартового кадра. Управляемая анимация из картинки.

start_imageprompt

Апскейл

upscale_image()

Апскейл изображения 1K → 2K/4K через реальный клик в UI Flow (валидная reCAPTCHA).

media_idtarget_resolution

Апскейл

upscale_video()

Видео до 1080p/4K. Кикофф через браузер, поллинг и скачивание — по чистому HTTP.

media_idtarget_resolution

Персонаж

create_character()

Персонаж из фото: портрет + тело + описание. Консистентные развороты и эмоции.

photo_base64physical_description

Сцена

generate_character_scene()

Генерация сцены с персонажем через реальный веб-композер — держит консистентность.

entity_idprompt

Статус · медиа

check_job · fetch_media()

Опрос статуса асинхронной задачи и скачивание готового медиа в base64.

job_idpath

Подключение

От ссылки до генерации — четыре шага.

Проще всего — отдай эту страницу своему агенту и скажи «подключи мне этот openFlow MCP». Он пройдёт шаги сам. Или вручную:

Получить ключ

Один запрос без авторизации создаёт твой персональный ключ в статусе pending. Подключиться и привязать аккаунт можно сразу.

# вернёт key (показывается один раз) + строку claude mcp add
curl -sX POST https://openflowmcp.com/flow-api/register \
  -H "Content-Type: application/json" -d '{"name":"Твоё имя"}'

Добавить MCP в агента

Одна команда для Claude Code. Для Codex — блок [mcp_servers.openflow] в ~/.codex/config.toml.

claude mcp add --transport http openflow \
  https://openflowmcp.com/mcp \
  --header "Authorization: Bearer <ТВОЙ_КЛЮЧ>"

Привязать свой Google-аккаунт

На своей машине — пароль и 2FA никуда не уходят. Скрипт откроет Chrome, ты войдёшь и нажмёшь «Принимаю», он заберёт одноразовый токен.

curl -sO https://openflowmcp.com/flow-api/onboard_local.js
npm init -y && npm i playwright-core
node onboard_local.js
# → отдай {email, oauth_token} в инструмент:
add_account_token(email="…", oauth_token="…")

Аппрув — и генерируешь

Оператор одобряет твой ключ. Генерация включается без переподключения. Проверка — flow_dashboard покажет твой аккаунт и кредиты, дальше generate_image.

Токен из шага 3 одноразовый. Если привязка не удалась — запусти node onboard_local.js заново за свежим токеном.

Документация

Справочник инструментов.

Все инструменты доступны через MCP после подключения ключа. Ниже — ключевые сигнатуры.

generate_image→ {urls, media_ids} | job_id

prompt — текст. model (NARWHAL), aspect, image_inputs — mediaId'ы для правки существующего кадра на месте.

generate_video→ job_id → check_job

video_model_key — abra_t2v_4s…10s, veo_3_1_t2v_lite/fast. Блокирует очередь на время генерации — одно устройство на всех.

…with_reference / …from_image→ job_id

reference_images (r2v, до 3, base64) — консистентный субъект. start_image (i2v, один кадр) — стартовый кадр. Взаимоисключающие.

upscale_image / upscale_video→ job_id

media_id + target_resolution (2K/4K для фото, 1080p/4K для видео). 4K может требовать платного тарифа на аккаунте.

add_account_token→ {ok, project}

email + oauth_token (одноразовый, снят локально). Привязывает твой аккаунт к твоему ключу. Работает уже на pending-ключе.

flow_dashboard / flow_health→ credits, queue_depth

flow_dashboard — кредиты, тариф и проекты по каждому твоему аккаунту. flow_health — доступность бэкенда и глубина очереди.