# infinite-canvas: bảng vẽ vô hạn để tạo ảnh, video bằng AI — hướng dẫn cài đặt và dùng

> infinite-canvas là một ứng dụng web mã nguồn mở (MIT) dạng bảng vẽ vô hạn, dùng để tạo ảnh, sửa ảnh theo ảnh tham chiếu và tạo video bằng AI. Bạn tự điền Base URL và API Key của dịch vụ tương thích OpenAI để dùng. Cài khá dễ nếu đã có Docker: chỉ cần clone repo và chạy một lệnh.

- Tác giả: Ông T (https://ongt.vn/gioi-thieu)
- Chủ đề: Repo & Skill
- Đăng: 2026-08-30 · Cập nhật: 2026-11-13
- URL: https://ongt.vn/bai-viet/infinite-canvas-bang-ve-vo-han-tao-anh-video-ai

infinite-canvas (无限画布, "bảng vẽ vô hạn") là một ứng dụng web mã nguồn mở để làm việc với AI tạo ảnh. Bạn có một tấm bảng rộng không giới hạn. Trên đó bạn đặt các ô (node) chứa ảnh, prompt, kết quả, rồi nối chúng lại với nhau. Từ cùng một giao diện, bạn có thể tạo ảnh từ chữ, sửa ảnh theo ảnh tham chiếu, chat với trợ lý và lưu lại mọi thứ đã làm.

Repo hợp với người làm nội dung, chủ shop cần ảnh sản phẩm, nhân viên marketing, designer và lập trình viên muốn có một "xưởng" tạo ảnh AI đặt trên máy mình. Điểm đáng giá nhất là bạn không bị khoá vào một dịch vụ. Ứng dụng chạy trên máy bạn và gọi tới bất kỳ API nào tương thích OpenAI mà bạn cấu hình. Repo hiện có khoảng 10.267 sao và 2.387 fork, dùng giấy phép MIT.

Mình đã làm một video ngắn giới thiệu repo này, bạn có thể xem video ngắn bên dưới trước khi cài.

```repo
- repo | basketikun/infinite-canvas
- kind | Ứng dụng
- desc | infinite-canvas là bảng vẽ vô hạn mã nguồn mở: gom tạo ảnh AI, sửa ảnh, video, trợ lý chat, thư viện prompt và quản lý ảnh vào một giao diện.
- stars | 10k
- lang | TypeScript
- license | MIT
```

```video
- youtube | https://youtube.com/shorts/wiHRUUieL3A
- facebook | https://www.facebook.com/reel/1704348461253027
- title | Video giới thiệu infinite-canvas
```

## infinite-canvas làm được gì

Dưới đây là các tính năng chính, kèm lợi ích khi dùng thật.

- **Bảng vẽ vô hạn nhiều dự án.** Bạn kéo, thả, phóng to, thu nhỏ các node và nối chúng bằng đường dây. Có bản đồ thu nhỏ để không bị lạc, có hoàn tác và làm lại, có nhập và xuất dự án. Một ý tưởng được trải ra thành một sơ đồ nhìn là hiểu, thay vì một danh sách chat dài.
- **Tạo ảnh bằng AI.** Hỗ trợ tạo ảnh từ chữ, tạo ảnh từ ảnh, sửa theo ảnh tham chiếu, hỏi đáp bằng văn bản, và cả tạo âm thanh, video. Trình duyệt của bạn gọi thẳng tới API bạn khai báo, không đi qua máy chủ nào của tác giả.
- **Trợ lý trên canvas.** Bạn chọn một node, trợ lý sẽ chat và tạo ảnh dựa trên node đó cùng các node nối phía trước. Kết quả được chèn ngược lại vào canvas. Cách này giúp bạn lặp lại, chỉnh dần một ý tưởng mà không phải viết lại bối cảnh từ đầu.
- **Agent chạy trên máy (Canvas Agent).** Bạn có thể nối Codex hoặc Claude Code với canvas qua MCP, để Agent thao tác trực tiếp trên canvas đang mở. Đây là phần dành cho người đã quen công cụ lập trình AI. Repo còn có một plugin cho Codex app, khi cài sẽ tự đăng ký MCP và thử bật Agent cục bộ.
- **Hệ thống plugin.** Bạn có thể cài, bật, cập nhật, gỡ các plugin node từ xa qua URL. Dev có thể tự viết node bằng TypeScript SDK.
- **Tuỳ biến cách gọi API.** Nếu nhà cung cấp của bạn không gọi giống chuẩn OpenAI, bạn có thể tự định nghĩa cách gọi cho tạo ảnh và video. Cách này hợp với các trạm trung chuyển hoặc dịch vụ tự dựng.
- **Thư viện prompt.** Có sẵn 7 nguồn prompt mã nguồn mở, và bạn có thể thêm nguồn riêng theo định dạng JSON chuẩn. Dữ liệu được tải trực tiếp từ trình duyệt và lưu vào IndexedDB, nên lần sau mở lên không phải tải lại.
- **Lưu trữ cục bộ.** API Key, Base URL, canvas, tài liệu và lịch sử tạo ảnh mặc định lưu trong trình duyệt của bạn.

## Cần chuẩn bị gì

Tư liệu của repo nói khá ít về yêu cầu hệ thống, nên mình chỉ nêu những gì có ghi:

- **Một trong hai cách chạy:** Docker (repo có Dockerfile và docker-compose.yml) hoặc chạy chế độ phát triển bằng bun (README dùng `bun install` và `bun run dev`).
- **Git** để tải mã nguồn về.
- **Một API tương thích OpenAI** cùng `Base URL` và `API Key` của nó. Ứng dụng không tự tạo ảnh, nó chỉ gọi dịch vụ bạn khai báo. README có nhắc một dự án cùng tác giả là chatgpt2api cho người đang tìm nguồn tạo ảnh, nhưng bạn cần tự đọc kỹ trước khi dùng.
- README **chưa ghi** phiên bản Node, hệ điều hành cụ thể hay yêu cầu GPU. Vì ứng dụng gọi API bên ngoài để tạo ảnh, có vẻ máy bạn không phải gánh phần nặng, nhưng đây là suy đoán của mình, không phải điều README khẳng định.
- Cách cài bun cũng không nằm trong README. Nếu chọn cách chạy bằng bun, bạn cần tìm hướng dẫn cài bun trên trang chính thức của nó trước.

```note
API Key giống như mật khẩu và gọi API thường tính tiền theo lượt. Đừng gửi key cho người khác, đừng chụp màn hình có lộ key. Mặc định key nằm trong trình duyệt của bạn, nên nếu dùng máy chung hãy cẩn thận. Nên đặt hạn mức chi tiêu ở phía nhà cung cấp API.
```

## Cài đặt từng bước

```steps
- Chọn cách chạy | Docker (dễ nhất) hoặc bun nếu bạn là dev
- Tải mã nguồn | git clone rồi cd vào thư mục infinite-canvas
- Khởi động | docker compose up -d, hoặc vào web/ chạy bun install và bun run dev
- Mở trình duyệt | Với Docker, vào http://localhost:3000
- Điền API | Mở cấu hình ở góc phải trên, nhập Base URL và API Key
```

### Tải mã nguồn về máy

Mở terminal (trên Windows dùng PowerShell hoặc Git Bash). Gõ lệnh dưới. Dòng đầu tải repo về, dòng sau đi vào thư mục vừa tải.

README dùng địa chỉ SSH. Nếu bạn chưa cấu hình khoá SSH cho GitHub, lệnh đó sẽ báo lỗi quyền truy cập. Khi đó hãy dùng địa chỉ HTTPS dưới đây, cho cùng kết quả.

```bash
git clone https://github.com/basketikun/infinite-canvas.git
cd infinite-canvas
```

### Cách 1: chạy bằng Docker

Đây là cách README đặt dưới mục "Docker 运行". Bạn cần Docker đã cài và đang chạy. Khi đứng trong thư mục `infinite-canvas`, gõ:

```bash
docker compose up -d
```

Lệnh này dựng và khởi động ứng dụng ở chế độ nền (`-d`). Lần đầu có thể mất một lúc vì phải dựng ảnh Docker. Theo README, ứng dụng chạy ở cổng 3000 mặc định, nên bạn mở `http://localhost:3000` trong trình duyệt.

Người mới hay vấp ở chỗ: lệnh phải gõ đúng trong thư mục chứa file `docker-compose.yml`, nếu không Docker sẽ báo không tìm thấy file cấu hình.

### Cách 2: chạy chế độ phát triển bằng bun

Cách này dành cho người muốn xem code hoặc sửa code. Sau khi `cd infinite-canvas`, bạn đi tiếp vào thư mục `web` rồi cài thư viện và chạy:

```bash
cd web
bun install
bun run dev
```

`bun install` tải các thư viện cần dùng. `bun run dev` bật máy chủ phát triển. README không nói rõ địa chỉ ở chế độ này, nên hãy đọc dòng địa chỉ mà terminal in ra sau khi chạy rồi mở nó trong trình duyệt. Muốn dừng thì bấm Ctrl+C trong terminal đó.

### Điền Base URL và API Key

Theo README, lần đầu mở ứng dụng bạn vào phần cấu hình ở góc phải trên. Điền `Base URL` và `API Key` của dịch vụ tương thích OpenAI mà bạn có. Nếu cách gọi mặc định kiểu OpenAI không khớp với nhà cung cấp của bạn, README cho biết bạn có thể tự định nghĩa cách gọi tạo ảnh và video trong cấu hình. Phần hướng dẫn chi tiết nằm trong thư mục `docs/` của repo.

## Kiểm tra đã chạy được chưa

Có ba dấu hiệu để biết mọi thứ ổn:

1. Trình duyệt mở được giao diện canvas (với Docker là ở `http://localhost:3000`) chứ không báo không kết nối được.
2. Bạn tạo được một dự án canvas, kéo thả được node và nối chúng.
3. Sau khi điền `Base URL` và `API Key`, bạn thử tạo một ảnh đơn giản bằng một câu prompt ngắn. Nếu ảnh hiện ra trên canvas thì cả đường gọi API lẫn ứng dụng đều chạy.

Với Docker, bạn có thể gõ `docker compose ps` để xem dịch vụ có đang chạy không. Đây là lệnh phổ thông của Docker, không nằm trong README.

## Dùng vào việc thật

Mình bám đúng những gì README mô tả. Phần kết quả cụ thể phụ thuộc vào mô hình ở dịch vụ API bạn chọn.

### Chủ shop làm nhiều phương án ảnh sản phẩm

Bạn bán đồ gia dụng và cần vài kiểu bối cảnh cho cùng một món. Bạn tạo canvas mới, đặt ảnh sản phẩm vào làm ảnh tham chiếu, rồi nối sang các node tạo ảnh. Mỗi node một prompt khác nhau, ví dụ:

```text
Đặt sản phẩm này lên bàn gỗ sáng, ánh sáng buổi sáng, nền đơn giản
```

Kết quả là nhiều phương án nằm cạnh nhau trên cùng một tấm bảng. Bạn so sánh bằng mắt và giữ ảnh ưng ý nhất.

> Thay vì một cuộc chat dài cuộn mãi, bạn có một tấm bảng nhìn là thấy cả quá trình làm.
>
> — Ông T

### Nhân viên marketing lặp lại một ý tưởng

Bạn đã có một ảnh banner gần ưng nhưng muốn đổi màu nền và thêm khoảng trống cho chữ. Bạn chọn node ảnh đó rồi dùng trợ lý canvas để chat. Vì trợ lý hiểu node đang chọn cùng các node nối phía trước, bạn chỉ cần nói thay đổi mong muốn. Ảnh mới được chèn lại vào canvas, còn ảnh cũ vẫn nằm đó để bạn quay lại.

### Người sáng tạo nội dung tìm cảm hứng bằng thư viện prompt

Bạn chưa biết viết prompt sao cho đẹp. Bạn mở thư viện prompt có sẵn 7 nguồn, duyệt các mẫu có sẵn, chọn một mẫu rồi sửa cho hợp ý. Vì dữ liệu được lưu vào trình duyệt, lần sau bạn mở lại gần như tức thì. Nếu nhóm bạn có bộ prompt riêng, bạn có thể thêm nguồn tự định nghĩa theo định dạng JSON chuẩn mà README nhắc tới.

### Dev nối Claude Code hoặc Codex với canvas

Nếu bạn đang dùng Claude Code hoặc Codex, README cho biết có thể chạy Canvas Agent trên máy để Agent thao tác canvas qua MCP. Bạn có thể nhờ Agent sắp xếp node hoặc tạo một loạt ảnh theo yêu cầu. README chính chỉ giới thiệu ở mức tổng quan. Các bước cài Canvas Agent và plugin Codex app nằm trong các mục "本地 Canvas Agent" và "Codex app 插件" ở README và thư mục `canvas-agent/`, `plugins/`, nên bạn cần đọc ở đó, mình không chép lệnh vì tư liệu ở đây chưa có.

## Lỗi hay gặp và cách xử lý

### git clone báo lỗi quyền truy cập

Nguyên nhân thường là bạn dùng địa chỉ SSH trong README mà chưa có khoá SSH trên GitHub. Cách xử lý an toàn là dùng địa chỉ HTTPS đã nêu ở trên.

### Mở localhost:3000 không thấy gì

Kiểm tra Docker Desktop đã bật chưa và bạn có gõ `docker compose up -d` trong đúng thư mục không. Cổng 3000 cũng có thể đang bị chương trình khác chiếm. Hãy đóng chương trình đó rồi thử lại. Nếu vẫn lỗi, xem log bằng lệnh Docker phổ thông `docker compose logs`.

### Ứng dụng mở được nhưng tạo ảnh thất bại

Lý do hay gặp nhất là `Base URL` hoặc `API Key` sai, hết hạn mức, hoặc nhà cung cấp không hỗ trợ đúng kiểu gọi mà ứng dụng dùng. Hãy kiểm tra lại hai ô trong cấu hình, thử với tài khoản còn số dư, và nếu nhà cung cấp gọi khác chuẩn OpenAI thì dùng tính năng tuỳ biến cách gọi.

### Mất dữ liệu canvas sau khi cập nhật hoặc đổi trình duyệt

README cảnh báo dự án đang trong giai đoạn phát triển, không đảm bảo tương thích dữ liệu cũ, và các định dạng lưu cục bộ có thể đổi. Dữ liệu còn nằm trong trình duyệt, nên đổi trình duyệt hay xoá dữ liệu trang sẽ mất. Hãy dùng tính năng xuất dự án để sao lưu những canvas quan trọng trước khi cập nhật.

### bun: command not found

Bạn chọn chạy bằng bun nhưng máy chưa cài bun. README không hướng dẫn cài bun, nên hãy cài từ trang chính thức của bun, hoặc đổi sang cách chạy bằng Docker.

## Có nên dùng không

**Điểm mạnh:** giao diện bảng vẽ giúp bạn nhìn cả quá trình sáng tạo, rất hợp khi cần thử nhiều phương án. Ứng dụng linh hoạt về nguồn API, và dữ liệu mặc định ở trong trình duyệt của bạn. Giấy phép MIT cho phép dùng cả cho mục đích thương mại. Repo vẫn được cập nhật trong vài tháng gần đây và có hệ thống plugin cho ai muốn mở rộng.

**Giới hạn:** README nói rõ dự án còn ở giai đoạn phát triển và không cam kết tương thích dữ liệu, nên đừng coi nó là nơi lưu trữ duy nhất cho tài sản quan trọng. Bạn vẫn phải tự có API và tự trả chi phí gọi API. README còn yêu cầu giữ thông tin tác giả và dấu hiệu nhận diện ở giao diện khi làm bản phát triển lại, bạn cần đọc kỹ điều này nếu định tuỳ biến để phát hành. Tài liệu chính viết bằng tiếng Trung, người đọc tiếng Việt có thể phải dùng công cụ dịch.

**Khi nên chọn cách khác:** nếu bạn chỉ cần tạo vài ảnh nhanh, một công cụ web tạo ảnh có sẵn sẽ đỡ công cài đặt hơn. Nếu bạn cần phần mềm ổn định lâu dài cho cả đội và có hỗ trợ chính thức, hãy cân nhắc kỹ trước khi phụ thuộc vào một dự án còn đang thay đổi nhanh. Còn nếu bạn thích thử nghiệm, làm nhiều phương án ảnh và muốn tự chủ cách gọi AI, infinite-canvas là một lựa chọn đáng thử.

## Câu hỏi thường gặp

### infinite-canvas có miễn phí không?

Bản thân ứng dụng là mã nguồn mở theo giấy phép MIT, bạn được dùng, sửa và dùng thương mại miễn phí. Tuy nhiên ứng dụng gọi API tạo ảnh và video do bạn cấu hình, nên chi phí gọi API (nếu có) là do nhà cung cấp API tính, không nằm trong repo.

### Có cần GPU không?

README không nói cần GPU. Ứng dụng hoạt động theo kiểu trình duyệt gọi thẳng tới API tương thích OpenAI mà bạn khai báo, nên việc tạo ảnh do dịch vụ API đó đảm nhiệm. Repo không có thông tin chi tiết về cấu hình máy tối thiểu.

### Chạy được trên Windows không?

README không ghi rõ hệ điều hành được hỗ trợ. Nó cung cấp hai cách chạy là Docker (docker compose up -d) và chế độ phát triển bằng bun, đều là công cụ chạy được nhiều nền tảng. Bạn nên thử trực tiếp trên máy mình, tài liệu chưa xác nhận cụ thể.

### Dữ liệu và API Key của tôi có an toàn không?

Theo README, API Key, Base URL, canvas, tài liệu và lịch sử tạo ảnh mặc định lưu trong trình duyệt của bạn, và trình duyệt gọi thẳng tới API bạn cấu hình. Dù vậy bạn vẫn nên giữ key kín và đặt hạn mức chi tiêu. README cũng cảnh báo định dạng lưu cục bộ có thể thay đổi, nên hãy xuất sao lưu canvas quan trọng.

### Dùng được những nhà cung cấp API nào?

Ứng dụng tương thích hệ sinh thái giao diện OpenAI. Mô tả của tác giả nhắc đến các kênh như chatgpt2api, grok2api, flow2api và newapi. Nếu nhà cung cấp của bạn gọi khác chuẩn OpenAI, bạn có thể tự định nghĩa cách gọi tạo ảnh và video trong cấu hình.

### Có thể kết nối với Claude Code hoặc Codex không?

Có. README cho biết có Canvas Agent chạy trên máy để Codex hoặc Claude Code thao tác canvas qua MCP, và có plugin cho Codex app. Các bước cài chi tiết nằm ở mục tương ứng trong README và thư mục canvas-agent, plugins của repo.

### Dự án có ổn định để dùng lâu dài không?

README ghi rõ dự án đang trong giai đoạn phát triển và không bảo đảm tương thích dữ liệu cũ. Repo vẫn được cập nhật trong vài tháng gần đây. Nếu cần một bản ổn định riêng, tác giả gợi ý bạn tự fork và phát triển độc lập.
