n8n-nodes-imageforge

Đây là node custom cho n8n, giúp tích hợp VeoForge Image API để tạo ảnh bằng AI chất lượng cao. Node này cho phép tạo ảnh từ văn bản, biến đổi ảnh mẫu, và kiểm tra trạng thái tác vụ.

🚀 Tính năng

• Tạo ảnh từ văn bản (Text-to-Image): Tạo ảnh dựa trên mô tả (prompt) sử dụng các model như NanoBanana Pro, Imagen 4.
• Biến đổi ảnh (Image-to-Image): Tạo ảnh mới dựa trên ảnh mẫu (hỗ trợ URL hoặc Base64) và mô tả.
• Kiểm tra trạng thái (Status Check): Tự động polling (chờ) đến khi ảnh tạo xong hoặc kiểm tra thủ công theo Task ID.

🛠 Cài đặt (Triển khai lên n8n Docker)

Dưới đây là các bước quy trình chúng ta đã thực hiện để cài đặt node này lên n8n chạy bằng Docker.

Bước 1: Đóng gói node (Trên máy tính cá nhân)

Trước tiên, cần đóng gói code thành file .tgz:

# Tại thư mục gốc của project
npm install
npm run build
npm pack
# Kết quả sẽ tạo ra file: n8n-nodes-imageforge-0.1.0.tgz

Bước 2: Upload và Cài đặt vào Docker Container

1. Copy file vào server (nếu n8n chạy trên VPS):

   scp n8n-nodes-imageforge-0.1.0.tgz user@your-server-ip:/tmp/

2. Copy file vào container n8n:

   # Tìm tên container (thường là n8n)
   docker ps 
      
   # Copy file từ host vào container
   docker cp /tmp/n8n-nodes-imageforge-0.1.0.tgz n8n:/tmp/

3. Cài đặt bên trong container:

   # Truy cập vào shell của container
   docker exec -it n8n /bin/sh
      
   # Vào thư mục n8n custom (thường là /root/.n8n hoặc /home/node/.n8n)
   cd /root/.n8n
      
   # Cài đặt từ file đã copy
   npm install /tmp/n8n-nodes-imageforge-0.1.0.tgz
      
   # Kiểm tra xem folder đã được cài chưa (nếu cần xóa bản cũ để update)
   # rm -rf node_modules/n8n-nodes-imageforge
      
   exit

4. Khởi động lại n8n:

   docker restart n8n

Sau khi restart, node VeoForge Image sẽ xuất hiện trong danh sách node của n8n UI.

🔑 Cấu hình Credential

Để sử dụng, bạn cần có API Key từ VeoForge:

1. Trong n8n UI, vào phần Credentials.
2. Tìm VeoForge Image API.
3. Nhập thông tin:
   • API Key: Lấy từ VeoForge Dashboard.
   • Base URL: Mặc định là https://api.veoforge.site/api.

📖 Hướng dẫn sử dụng

1. Generate Image (Text-to-Image)

Tạo ảnh mới hoàn toàn từ mô tả.

• Prompt: Mô tả chi tiết bức ảnh muốn tạo.
• Model: Chọn model AI (NanoBanana Pro cho chất lượng tốt nhất).
• Aspect Ratio: Chọn tỉ lệ ảnh (Portrait 9:16 hoặc Landscape 16:9).
• Options:
  • Wait for Completion: Bật để node tự động chờ đến khi ảnh tạo xong mới trả về kết quả (nên bật).

2. Generate Image (Image-to-Image)

Tạo ảnh mới dựa trên bố cục/nội dung của ảnh mẫu.

• Input Image Type:
  • URL: Điền link ảnh trực tiếp.
  • Base64: Dùng chuỗi binary của ảnh (thường dùng nối sau node Download Binary).
• Prompt: Mô tả những gì muốn thay đổi hoặc giữ nguyên.

3. Check Task Status

Kiểm tra trạng thái của một tác vụ đang chạy (nếu bước tạo ảnh bạn tắt chế độ chờ "Wait for Completion").

• Task ID: ID nhận được từ lệnh tạo ảnh trước đó.

❓ Xử lý lỗi thường gặp

• Không thấy node mới?: Hãy thử refresh trình duyệt (Shift + F5) hoặc xóa cache. Nếu vẫn không thấy, hãy docker restart n8n một lần nữa.
• Lỗi Permission?: Đảm bảo user chạy trong container có quyền ghi vào thư mục node_modules.
• Lỗi API 401: Kiểm tra lại API Key trong phần Credentials.

License

MIT