Skip to main content
Glama

gflow-studio

Tiếng Việt · English

Tạo ảnh và video bằng Google Flow ngay trong terminal. gflow-studio điều khiển Imagen, Nano Banana (ảnh) và Veo, Omni Flash (video) qua chính tài khoản Flow của bạn. Cả một storyboard chạy bằng một lệnh, thay cho một buổi chiều ngồi bấm chuột.

gflow-studio do ABM.DũngTQ xây dựng và phát triển cho dây chuyền làm phim hoạt hình: tải video 1080p, chạy Chrome ẩn trên macOS, lô ảnh tự dừng khi Google chặn, và lệnh chạy lô video. Lệnh là gflow. Danh sách đầy đủ ở mục Điểm nổi bật.

Release License: MIT Python 3.11+ Platforms

Công dụng · Điểm nổi bật · Cài đặt · Cách dùng · Chạy lô · Ẩn trình duyệt · Demo · Khi có lỗi · Tài liệu · Tác giả

⚠️ Đọc trước khi cài. gflow-studio không liên quan đến Google. Công cụ này dò ngược cách Flow hoạt động và điều khiển một cửa sổ Chrome thật đã đăng nhập tài khoản Google của bạn, nên mọi thao tác tự động diễn ra trên tài khoản đó và chịu điều khoản của Google. Flow có thể đổi giao diện bất cứ lúc nào. Tạo ảnh không tốn credit; tạo video Veo trừ credit Flow của bạn. Hãy đọc DISCLAIMER và docs/ACCOUNT_SAFETY.md.

Công dụng

Bạn muốn…

Lệnh

Tạo ảnh từ câu mô tả

gflow image t2i "a red paper lantern on a wooden table"

Sửa hoặc ghép ảnh

gflow image i2i "same cat, now wearing a scarf" --ref cat.png

Tạo video từ câu mô tả

gflow video t2v "slow push-in on a forest clearing" --aspect 16:9

Làm ảnh tĩnh chuyển động

gflow video i2v "the lantern sways" --initial-frame lantern.jpg

Tạo video từ ảnh tham chiếu

gflow video r2v "..." --ref hero.png --ref room.png

Lấy clip 1080p

thêm --upscale vào t2v, i2v, r2v hoặc video batch

Chạy cả storyboard ảnh

gflow run --config storyboard.json

Chạy nhiều clip ảnh-thành-video trong một phiên

gflow video batch --config videos.json

Giữ một nhân vật nhất quán qua nhiều cảnh

gflow character create ..., rồi tham chiếu nhân vật đó

Nối dài clip quá 8 giây

gflow video extend <media_id> "the camera keeps rising"

Xem số credit Veo

gflow credits user

Cho AI agent dùng Flow

gflow mcp run (stdio) hoặc gflow serve (HTTP)

Kiểm tra máy đã cài đúng chưa

gflow doctor

Lệnh nào cũng nhận --profile để chọn tài khoản Google và --project để làm việc trong một project Flow có sẵn. Phần lớn lệnh có --json để dùng trong script. gflow docs in tài liệu đi kèm, không cần mạng.

Prompt nên viết bằng tiếng Anh: các mô hình của Flow hiểu tiếng Anh ổn định nhất.

Related MCP server: google-flow-mcp

Điểm nổi bật

  • --upscale: giữ bản 1080p. Tải video xong, gflow lấy bản xuất 1080p của Flow (không tốn thêm credit) và ghi đè lên file 720p ở đúng đường dẫn đó. Nếu xuất 1080p lỗi, file 720p vẫn được giữ và lệnh in ra câu lệnh để thử lại. Có ở video t2v, i2v, r2v, video batch và tool MCP gflow_generate_video(upscale=True).

  • gflow video batch. Chạy 1–50 dòng ảnh-thành-video từ một file JSON trong cùng một phiên trình duyệt và một project Flow, có --resume, --jitter và --json. Clip nào đã tạo xong, đã bị trừ credit nhưng tải về lỗi thì được tải lại miễn phí chứ không mất.

  • Chrome chạy ẩn trên macOS. GFLOW_CLI_WINDOW_MODE=background chạy Chrome như một ứng dụng nền: không hiện biểu tượng trên Dock, không giành bàn phím khi bạn đang làm việc.

  • Lô dừng ngay khi Google chặn. gflow run, image batch và image t2i nhiều prompt sẽ dừng ở lần đầu gặp WAF 403, bị giới hạn tốc độ hoặc phiên đăng nhập hết hạn, kể cả khi có --continue-on-error, và thoát với mã lỗi của chính lỗi đó. Tài khoản đã bị để ý sẽ không phải nhận tiếp phần còn lại của lô.

  • Đặt tên cho ảnh tham chiếu trong gflow run. Khai báo {"name": "cuong", "path": "cuong.png"} rồi viết @cuong trong prompt. Mỗi dòng nhận được nhiều ảnh tham chiếu (refs) và có đường dẫn output riêng.

  • Tự gia hạn phiên đăng nhập. Nếu phiên Google hết hạn khi chưa gửi gì, gflow gia hạn một lần rồi chạy lại. Đã gửi lệnh tạo rồi thì không bao giờ gửi lại. Tắt bằng GFLOW_CLI_AUTO_RENEW=false.

  • Sửa lỗi. -o trỏ sang ổ đĩa khác không còn lỗi sau khi tạo xong. Lô ảnh dài tự tải lại ảnh tham chiếu đã trôi khỏi project. Tab Chrome chỉ được đưa lên trước khi nó thực sự bị ẩn.

Chi tiết ở CHANGELOG.md mục Unreleased. Số đo về chế độ không cửa sổ (headless) nằm ở docs/superpowers/spikes/2026-10-28-headless-generation.md.

Cài đặt

Cần có

  • Một tài khoản Google dùng được Google Flow. Muốn tạo video thì tài khoản cần có credit Flow.

  • Google Chrome cài theo cách thông thường.

  • uv; uv tự cài Python 3.11 trở lên.

  • macOS, Windows hoặc Linux có giao diện đồ hoạ. Lần đăng nhập đầu tiên cần Chrome mở được cửa sổ.

1. Cài

uv tool install "git+https://github.com/abm-dungtq/gflow-studio.git@main"
uvx --from "git+https://github.com/abm-dungtq/gflow-studio.git@main" playwright install chromium
gflow --version

Muốn nâng cấp, chạy lại đúng lệnh uv tool install ở trên và thêm --force.

2. Đăng nhập một lần

gflow auth login --browser chrome --profile main

Một cửa sổ Chrome sẽ mở ra. Đăng nhập Google và chờ đến khi thấy màn hình làm việc của Flow; gflow lưu phiên đăng nhập vào thư mục profile riêng của nó. Phải có --browser chrome, vì về sau mỗi lần tạo ảnh hay video, gflow mở lại profile này bằng Chrome thật. Mỗi tài khoản Google dùng một tên --profile khác nhau.

3. Kiểm tra

gflow auth status
gflow credits user --profile main
gflow doctor

Ba lệnh này không tốn credit. gflow doctor thoát với mã 33 khi thấy chỗ cần sửa và nói rõ phải sửa gì.

4. Cấu hình thêm (tuỳ chọn)

Chép .env.template thành .env trong thư mục bạn chạy gflow, hoặc vào thư mục gốc của gflow để áp dụng cho cả máy. Các thiết lập hay dùng:

Thiết lập

Tác dụng

GFLOW_CLI_WINDOW_MODE=background

macOS: chạy Chrome ẩn, không giành bàn phím

GFLOW_CLI_OUTPUT_DIR=./out

Nơi lưu file khi không truyền -o

GFLOW_CLI_PROJECT=<id>

Project Flow mặc định, để mỗi lần chạy không sinh project mới

GFLOW_CLI_JITTER_RANGE=10-30

Khoảng nghỉ giữa các lần gửi trong lô; nới rộng ra nếu gặp WAF 403

GFLOW_CLI_LEASE_WAIT_SECONDS=600

Chờ khi profile đang bị một lệnh gflow khác dùng, thay vì báo lỗi

Mọi thiết lập được giải thích trong docs/CONFIGURATION.md. gflow chỉ đọc file .env; file .env.local bị bỏ qua.

Cách dùng

Ảnh (miễn phí)

gflow image t2i "a hot air balloon over Tokyo at sunrise" --aspect 16:9 -o out/balloon.png
gflow image t2i "a cat mom, flat 2D" --model nano2 -n 4 --out out/cats/
gflow image i2i "the same cockroach, now sitting on a keyboard" --ref refs/cuong.png -o out/k1.png

Mô hình: nano2 (Nano Banana 2.1, mặc định), nano2-lite, nano-pro, imagen4. Tỉ lệ khung: 16:9, 4:3, 1:1, 3:4, 9:16. -n tạo 1–4 biến thể.

Video (tốn credit)

gflow video t2v "slow cinematic push-in on a sunlit forest clearing" --aspect 16:9 -o out/forest.mp4
gflow video i2v "the paper lantern sways gently, slow push in" \
  --initial-frame out/lantern.jpg --model veo-lite --aspect 16:9 --upscale -o out/lantern.mp4
gflow video upscale <media_id> --scale 1080p      # lấy 1080p cho clip đã làm trước đó

Mô hình: omni-flash, veo-lite, veo-fast, veo-quality. --duration nhận 4, 6 hoặc 8 giây; 10 giây chỉ có ở Omni Flash. --end-frame đặt khung hình cuối cho i2v. Nếu không truyền --aspect, video mặc định là dọc 9:16.

Project, nhân vật và kho dữ liệu

gflow project list --profile main          # các project gflow đã ghi lại
gflow character create --project <id> --name "Aria" --face-prompt "..." --body-prompt "..."
gflow data --help                          # tra cứu mọi thứ bạn đã tạo

Dành cho AI agent (MCP)

gflow mcp setup          # đăng ký server stdio với agent của bạn
gflow mcp run --no-spend # server không có các tool tạo ảnh, video

CLI và server MCP có cùng một bộ tính năng. docs/MCP.md liệt kê đủ các tool.

Chạy lô

Storyboard ảnh: gflow run

storyboard.json:

{
  "prompts": [
    {"text": "@cuong stands on a desk at night, flat 2D", "aspect_ratio": "16:9",
     "refs": [{"name": "cuong", "path": "refs/cuong.png"}], "output": "gen/k1.jpg"},
    {"text": "@cuong jumps onto the keyboard", "aspect_ratio": "16:9",
     "refs": [{"name": "cuong", "path": "refs/cuong.png"}], "output": "gen/k2.jpg"}
  ]
}
gflow run --config storyboard.json --profile main --project <id>
gflow run --config storyboard.json --profile main --project <id> --resume

Mỗi file ảnh tham chiếu chỉ tải lên một lần cho cả lượt chạy. --resume bỏ qua những dòng đã có file đầu ra, nên chạy lại sau khi lỗi chỉ tạo phần còn thiếu. Dòng nào đã sửa prompt, thông số hay ảnh tham chiếu thì được tạo lại, vì gflow ghi đầu vào của mỗi file vào một file ẩn .<tên>.gflow.json bên cạnh. Muốn làm lại một ảnh thì dùng --redo k3 thay cho việc tự xoá file.

Nhiều clip ảnh-thành-video trong một phiên: gflow video batch

videos.json:

{
  "project": "<existing-flow-project-id>",
  "videos": [
    {"start": "gen/k1.jpg", "prompt": "the cockroach looks around, slow push in",
     "model": "omni-flash", "duration": 4, "aspect": "16:9", "output": "clips/v1.mp4"},
    {"start": "gen/k2.jpg", "prompt_file": "prompts/v2.txt",
     "model": "omni-flash", "duration": 6, "aspect": "16:9", "output": "clips/v2.mp4"}
  ]
}
gflow video batch --config videos.json --profile main --upscale --json

Dòng nào đã gửi thì không bao giờ gửi lại, vì clip Flow đã nhận có thể đã bị trừ credit. Nếu một dòng lỗi, chạy lại với --resume. Clip có prompt hay khung đầu đã đổi sẽ được tạo lại; --redo v3 ép làm lại một clip.

Có hai profile đăng nhập cùng một tài khoản Google thì chạy song song bằng --profiles meo-muop,meo-muop-2 --project <id>. gflow chia đều các dòng còn thiếu cho hai profile, mỗi profile một trình duyệt, khởi động cách nhau 25 giây, và in ra dòng nào chạy ở profile nào. Một profile gặp WAF hay hết phiên thì cả lô dừng sau dòng đang làm. gflow run cũng nhận --profiles.

Ẩn trình duyệt

Google chỉ phục vụ Flow cho trình duyệt thật, nên gflow phải điều khiển một cửa sổ Chrome thật. Bạn nhìn thấy nó nhiều hay ít tuỳ hệ điều hành:

Hệ điều hành

Thiết lập

Kết quả

macOS

GFLOW_CLI_WINDOW_MODE=background

Ẩn hoàn toàn, không có biểu tượng trên Dock, không bao giờ giành bàn phím. Nên dùng.

macOS, Windows, Linux

offscreen (mặc định)

Cửa sổ được thu nhỏ ngay sau khi mở, kể cả khi máy có nhiều màn hình, nhưng Chrome giành bàn phím lúc khởi động.

mọi hệ

GFLOW_CLI_HEADLESS=true

Không có cửa sổ nào. Đang thử nghiệm, xem bên dưới.

mọi hệ

normal

Cửa sổ hiện bình thường, tiện khi muốn xem gflow làm gì.

Trên một tài khoản thử (macOS, 28/10/2026), Chrome thật chạy headless tạo ảnh thành công 6/6 lần, không gặp 403 hay lỗi reCAPTCHA. Chrome headless vốn tự ghi HeadlessChrome trong user agent; gflow giờ thay chuỗi đó bằng user agent của Chrome thường, nên trang Flow không thấy dấu headless nào ở user agent. Lần thử ngày 30/10/2026 tạo ảnh bình thường, không mở cửa sổ và không giành bàn phím. Ngoài ra chưa ai đo với video, trên Windows hay về lâu dài với tài khoản. Vì thế mặc định vẫn là Chrome có cửa sổ. Muốn dùng headless, hãy thử trên tài khoản phụ trước. Nếu Chrome vẫn hiện hoặc giành bàn phím, kể cả trên Windows, cách tìm nguyên nhân và sửa nằm ở docs/HIDDEN_BROWSER.md.

Demo

gflow image t2i chạy một prompt 9:16, in log và ghi ra một file PNG

Một lượt gflow run thật gồm hai dòng, trên tài khoản thử (29/10/2026, khoảng một phút, không tốn credit):

$ gflow run --config run.json --profile thu-headless --project <project-id> --output-dir tmp/f7/out
  project: <project-id> (existing)
                                   gflow run
┏━━━┳━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┳━━━━━━━┳━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━━━━━┓
┃ # ┃ prompt                      ┃ ratio ┃ status ┃ detail                    ┃
┡━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━╇━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━━━┩
│ 0 │ a small red paper lantern   │ 16:9  │ OK     │ tmp/f7/out/prompt_0_0.jpg │
│   │ on a wooden table, soft     │       │        │                           │
│   │ light                       │       │        │                           │
│ 1 │ a green ceramic teapot on a │ 16:9  │ OK     │ tmp/f7/out/prompt_1_0.jpg │
│   │ windowsill, morning light   │       │        │                           │
└───┴─────────────────────────────┴───────┴────────┴───────────────────────────┘

2/2 succeeded · 0 failure(s) · 0 skipped

Sau đó ảnh đèn lồng đầu tiên được làm thành video bằng gflow video i2v --model veo-lite --upscale trên cùng tài khoản. Kết quả là một clip 4 giây, độ phân giải 1920×1080; kết quả JSON có "upscaled": "1080p".

Ví dụ: tạo ảnh từ chữ và biến đổi khung hình trước/sau

Khi có lỗi

Khi lỗi, gflow dừng hẳn và trả về một mã thoát cố định chứ không tự gửi lại, để lượt chạy hỏng không âm thầm tiêu credit.

Mã thoát

Ý nghĩa

Nên làm gì

3 / 8

Phiên đăng nhập hết hạn hoặc chưa có

gflow auth renew, hoặc chạy lại gflow auth login

4

Bị giới hạn tốc độ

Chờ một lúc, rồi nới --jitter

5

Bị chính sách nội dung từ chối

Viết lại prompt đó; lô vẫn chạy tiếp các dòng khác

10

WAF 403: Google chặn yêu cầu

Dừng lại và chờ. Đừng chạy lại liên tục trên tài khoản này

11

Sai cấu hình, hoặc profile đang bận

Đọc thông báo; nó ghi rõ trường nào sai hoặc ai đang giữ khoá

23

Flow đã đổi giao diện

Chạy gflow update, rồi báo lỗi

37

Không đủ credit Veo

Nạp thêm, hoặc dùng mô hình rẻ hơn

Mọi lỗi được in theo chuẩn RFC 9457 (problem details) kèm gợi ý cách xử lý. KNOWN_ISSUES.md liệt kê các lỗi hiện có và cách né.

Tài liệu

Tài liệu chi tiết hiện chỉ có bằng tiếng Anh.

docs/INDEX.md là mục lục của toàn bộ tài liệu.

Tác giả

  • gflow-studio: ABM.DũngTQ · 0976202028 · github.com/abm-dungtq/gflow-studio

  • Giấy phép: MIT. Giấy phép chỉ áp dụng cho mã nguồn. Flow và mọi thứ bạn tạo bằng Flow chịu điều khoản của Google. Xem DISCLAIMER.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables an AI agent to drive Google Flow through a real logged-in browser session: read projects, media, characters, scenes and credits, create and delete them, upload media, generate Veo video and Nano Banana images, and assemble scenes into a film. Every paid action is priced in its tool description and written to a spend ledger before the click, with a job-id guard against double charges.
      3
      MIT
    • A
      license
      B
      quality
      B
      maintenance
      Enables users to generate images and videos on Google Flow through browser automation of an already signed-in Chrome session, downloading the finished media to disk without any API keys. It drives Flow's agent with a range of image and video models, plus reference images, first/last frames, and ingredient-based video jobs, while reusing the user's own Google AI Pro credits.
      17
      MIT