Image Extender là một công cụ AI outpainting và tạo game art 2D mã nguồn mở, giúp bạn mở rộng ảnh theo bất kỳ hướng nào và xây dựng toàn bộ bộ art game 2D (parallax background, autotiles, sprite animation, props) từ một studio duy nhất. Repo này giải quyết bài toán mở rộng ảnh với Poisson-blended seams và tạo tài nguyên game đồng bộ, dành cho lập trình viên game indie và nhà thiết kế.
Thank you for reading this post, don't forget to subscribe!Những điểm chính
- Mở rộng ảnh theo 4 hướng với Poisson blending, tự động chọn variant tốt nhất trong 3 lần sinh.
- Tích hợp 5 studio chuyên biệt: Extender, Parallax Studio, Tile Studio, Sprite Studio và Props Studio.
- Sử dụng mô hình Gemini qua OpenRouter, mã nguồn mở, API key chỉ lưu trong trình duyệt.
- Có AI art director QA loop cho tile và props, giúp chất lượng đầu ra ổn định.
- Xuất file sẵn sàng cho engine game (Unity, Godot, Phaser) kèm manifest JSON.
Image Extender là gì và giải quyết vấn đề gì?
Image Extender giải quyết hai nỗi đau lớn của game dev indie: thứ nhất, mở rộng ảnh ngoài khung hình gốc (outpainting) mà không để lại đường seam thấy được; thứ hai, tạo bộ asset game 2D (parallax, tile, sprite, prop) có phong cách nhất quán từ một prompt duy nhất. Công cụ dùng mô hình Gemini của Google thông qua OpenRouter, xử lý blending bằng kỹ thuật Poisson image editing, cho kết quả mượt mà. Bạn có thể xem chi tiết tại repository gốc trên GitHub.
Những tính năng nổi bật của Image Extender
Extender – Outpainting cơ bản
Cho phép mở rộng ảnh lên/xuống/trái/phải, mỗi lần mở rộng 38% kích thước hiện tại. Hệ thống tạo 3 variant, đo seam residual rồi sắp xếp, bạn có thể chọn variant ưng ý. Poisson blend kết hợp với pre-correction màu để tránh hiện tượng ‘bầu trời xanh hơn’.
Parallax Studio – Nhiều lớp nền
Xây dựng background sidescroller với 4 lớp Sky/Far/Mid/Near, mỗi lớp có thể chỉnh tốc độ cuộn riêng. Hỗ trợ auto-extend đến độ rộng mục tiêu, tạo tileable loop và harmonize để loại bỏ banding màu. Xuất ZIP kèm manifest cho Unity/Godot.
Tile Studio – Autotile 13 tile
Sinh toàn bộ 13 tile (body, edge, outer corner, inner corner) trong một lần gọi API dưới dạng sheet 4×4. Tự động căn chỉnh, chroma key, và xử lý corner graft để khớp grain. Có AI art director review và repaint nếu cần.
Sprite Studio – Animation nhân vật
Two-pass workflow: tạo anchor reference trước, sau đó vẽ sheet animation theo body plan (humanoid, quadruped, serpent/fish, flyer/bird, blob). Hỗ trợ các animation idle/walk/run/jump/attack/hurt/death. Có live player và export dạng strip hoặc sheet.
Props Studio – Đồ trang trí ngẫu nhiên
Two-call pipeline: art director (text model) đề xuất ý tưởng mới, image model vẽ 8 prop mỗi lần. Tự động dedup, style-locked qua các batch. Xuất atlas PNG + manifest với tên mô tả.
Các tính năng chung: BYOK, 40+ art style, model picker (Gemini 3 Pro/Flash, GPT-5.4), keyboard-first, generate từ text prompt, shared scene brief.
Hướng dẫn cài đặt và sử dụng cơ bản
- Clone repo:
git clone https://github.com/boona13/image-extender.git cd image-extendernpm installnpm run dev- Mở
http://localhost:3000, nhập OpenRouter API key (lưu trong localStorage).
Sau đó kéo thả ảnh hoặc generate từ text. Click vào cạnh ảnh để mở rộng, dùng phím mũi tên để chọn variant, Enter chấp nhận, Esc hủy. Có thể chọn mode từ thanh trên cùng. Nếu không muốn nhập key mỗi lần, có thể set env OPENROUTER_API_KEY trong file .env.local.
Ai nên dùng và ai không nên dùng Image Extender?
Công cụ này rất phù hợp cho game dev indie, pixel artist, và người làm prototype cần nhanh bộ art đồng bộ. Đặc biệt hữu ích khi bạn muốn mở rộng ảnh concept thành background cinematic hay tạo tile set platformer chỉ với vài cú click. Tuy nhiên, không phù hợp cho người muốn outpainting offline (cần internet vì gọi API), hoặc cần số lượng lớn asset miễn phí (mỗi lần gọi tốn $0.03). Nếu bạn muốn kiểm soát hoàn toàn từng pixel, công cụ này thiên về AI sinh, không thay thế hoàn toàn vẽ tay.
Câu hỏi thường gặp
Chi phí sử dụng Image Extender là bao nhiêu?
Mỗi lần mở rộng ảnh với Gemini Flash Image (mặc định) tốn khoảng $0.03 US. Bạn trả tiền qua OpenRouter, không có phí ẩn. Các model khác có giá khác.
Có cần kết nối internet không?
Có, vì ứng dụng gửi yêu cầu đến OpenRouter để gọi mô hình Gemini. Không có cơ chế chạy local model.
Tôi có thể dùng model AI khác ngoài Gemini không?
Trong Settings có thể chọn giữa Gemini 3 Pro, Gemini 3 Flash, Gemini 2.5 Flash và GPT-5.4 Image. Các model khác chưa được hỗ trợ.
API key của tôi có an toàn không?
Key chỉ lưu trong localStorage trình duyệt, không ghi vào server hay log. Server chỉ proxy request và xoá key sau mỗi lần dùng.
Làm sao để xuất asset cho Unity?
Mỗi studio có nút Export: Parallax xuất ZIP với các layer PNG và manifest.json; Tile xuất atlas có extrude padding; Sprite xuất strip/sheet; Props xuất atlas PNG. Các file này tương thích với Unity, Godot, Phaser.
Kết luận
Image Extender là một công cụ mã nguồn mở mạnh mẽ, kết hợp AI outpainting chất lượng cao với các pipeline tạo game art chuyên sâu. Nếu bạn đang phát triển game 2D và cần một bộ asset nhanh, đồng bộ, hãy thử ngay repo này. Fork, góp ý hoặc đóng góp code để cộng đồng cùng phát triển.
