🔗 Tích Hợp G-Labs Webhook vào n8n

Tạo ảnh & video AI tự động bằng cách kết nối G-Labs Automation với n8n — nền tảng tự động hóa workflow mã nguồn mở.

⚠️Yêu cầu gói MAX để sử dụng Webhook API.

1. 🌟 Tổng Quan

G-Labs Webhook API cung cấp một máy chủ REST API cục bộ chạy trên máy tính của bạn. Bạn có thể gửi yêu cầu tạo ảnh/video AI từ bất kỳ công cụ nào — bao gồm n8n.

Tại sao dùng n8n?

  • Tự động hóa hoàn toàn: Lên lịch tạo ảnh/video theo giờ, theo sự kiện
  • Kết hợp đa nền tảng: Nhận prompt từ Google Sheets, Telegram, email → tạo ảnh → gửi kết quả
  • Giao diện kéo thả: Không cần viết code
  • Miễn phí & tự host: Chạy trên máy tính cá nhân
text
n8n Workflow → [HTTP Request] → G-Labs Webhook API (127.0.0.1:8765)
                                        ↓
                              Thêm vào hàng đợi G-Labs
                                        ↓
                              G-Labs tự động tạo ảnh/video
                                        ↓
n8n Workflow ← [Polling / Check status] ← Trả kết quả (file URL)

2. 🛠️ Chuẩn Bị

Thành phầnChi tiết
G-Labs AutomationĐã cài đặt, gói MAX đang hoạt động
n8nĐã cài đặt
Tài khoản GoogleÍt nhất 1 tài khoản hợp lệ trong G-Labs

Cài đặt n8n

Cách 1 — n8n Desktop: Tải từ n8n.io/get-started

Cách 2 — npm:

bash
npm install n8n -g
n8n start

Cách 3 — Docker:

bash
docker run -it --rm --name n8n -p 5678:5678 n8nio/n8n
💡n8n và G-Labs phải chạy trên cùng một máy tính (vì Webhook API chỉ lắng nghe trên 127.0.0.1).

3. 🚀 Bật Webhook Server

  1. Mở G-Labs Automation
  2. Ở thanh bên trái, nhấn Webhook (🔗)
  3. Sao chép API Key
  4. Cấu hình cổng (mặc định: 8765)
  5. Nhấn Bật Server → trạng thái chuyển sang 🟢 Đang chạy

4. 🖼️ Workflow 1: Tạo Ảnh AI

text
[Manual Trigger] → [HTTP: Tạo ảnh] → [Wait 30s] → [HTTP: Kiểm tra] → [IF hoàn thành?]
                                                                            ↓ Yes
                                                                    [HTTP: Tải file]
                                                                            ↓ No
                                                                    [Quay lại Wait]

Bước 4.3 — HTTP Request (Tạo ảnh)

Thuộc tínhGiá trị
MethodPOST
URLhttp://127.0.0.1:8765/api/image/generate
HeaderX-API-Key: YOUR_API_KEY
json
{
  "prompt": "a beautiful sunset over the ocean, cinematic, 8k",
  "model": "nano_banana_2",
  "aspect_ratio": "16:9",
  "upscale": ["2K"],
  "reference_images": []
}

Bước 4.5 — Kiểm tra trạng thái

URL: http://127.0.0.1:8765/api/status/{{ $('Tạo Ảnh').item.json.task_id }}

⚠️Biểu thức {{ $('Tạo Ảnh').item.json.task_id }} tự động lấy task_id. Đảm bảo tên node khớp chính xác.

5. 🎬 Workflow 2: Tạo Video AI

Tương tự workflow ảnh, thay đổi endpoint và tham số:

json
{
  "prompt": "a golden retriever running on the beach, slow motion",
  "model": "veo_31_fast",
  "mode": "text_to_video",
  "aspect_ratio": "16:9",
  "resolution": ["720p", "1080p"]
}
💡Video mất 1–5 phút để tạo. Đặt Wait = 60 giây giữa mỗi lần kiểm tra.

6. 📦 Workflow 3: Tạo Hàng Loạt

Đọc danh sách prompt từ Google Sheets / file CSV → tạo ảnh hàng loạt.

json
{
  "prompt": "={{ $json.prompt }}",
  "model": "={{ $json.model || 'nano_banana_2' }}",
  "aspect_ratio": "={{ $json.aspect_ratio || '16:9' }}"
}

7. ⚠️ Xử Lý Lỗi & Mẹo

MẹoChi tiết
Kiểm tra health trướcThêm node GET /api/health ở đầu workflow
Timeout bảo vệĐếm số lần poll. Nếu > 20 lần → dừng và báo lỗi
Lưu credentialSettings → Credentials → tạo Header Auth để tái sử dụng API Key
Song songGửi nhiều request cùng lúc (G-Labs tự quản lý hàng đợi)
RetryDùng Error Trigger + Retry on Fail

8. 📖 Tham Khảo API Nhanh

EndpointMethodAuthMô tả
/api/healthGET❌Kiểm tra server
/api/image/generatePOST✅Tạo ảnh AI
/api/video/generatePOST✅Tạo video AI
/api/grok/generatePOST✅Tạo ảnh/video Grok
/api/status/{task_id}GET✅Kiểm tra trạng thái
/api/result/{task_id}GET✅Lấy kết quả
/api/files/{filename}GET❌Tải file
/api/tasksGET✅Danh sách tác vụ