Tích hợp n8n

Ảnh và video ngay trong n8n Tạo, chờ, tải về, đăng — trong một workflow

Kết nối n8n với BananaBanana bằng một API key và gọi Nano Banana, Veo, Gemini Omni, Wan, Grok Imagine, GPT Image, Qwen và Gemini TTS từ các workflow của bạn. Có hai cách: AI Agent với node MCP Client Tool, hoặc các node HTTP Request thuần, không cần mô hình ngôn ngữ.

Tạo API keyHình ảnh từ $0.03, video từ $0.06 — thanh toán theo từng lần tạo
01Bạn nhận được gì

Workflow làm được gì và chi phí bao nhiêu

Mỗi lần tạo được trừ vào số dư BananaBanana của bạn với đúng giá như trên website. Không có gói đăng ký và không có phí riêng cho n8n. Các lệnh gọi đắt (video, nhiều ảnh cùng lúc) trước tiên trả về báo giá và không tính phí cho đến khi bạn xác nhận; các lần tạo thất bại hoặc bị bộ lọc chặn sẽ được hoàn tiền tự động.

Lệnh gọiGiá
Hình ảnh (generate_image, edit_image)$0.03–$0.20 mỗi ảnh
Clip video (generate_video, edit_video)$0.06–$6.00 mỗi clip
Giọng nói (generate_speech)$0.01 mỗi 200 ký tự (tính cả phần lẻ)
Trạng thái, mô hình, tài khoản (get_result, list_models, get_account)miễn phí

Giá chính xác của từng mô hình, độ phân giải và thời lượng có trong list_models và trên trang bảng giá.

02Bước 1

Tạo API key

  1. Đăng ký và nạp tiền vào số dư.
  2. Mở Hồ sơ → API Keys và tạo một key. Key bắt đầu bằng bb_live_ và chỉ hiển thị một lần — hãy sao chép thẳng vào credential của n8n.
  3. Đặt giới hạn chi tiêu hằng ngày cho key sao cho khớp với workflow, ví dụ bằng chi phí các lần chạy bạn dự kiến mỗi ngày. Nếu vòng lặp bị lỗi, nó sẽ dừng ở mức giới hạn thay vì rút cạn số dư.
  4. Trong n8n, tạo credential Bearer Auth và dán key vào Bearer Token. Cả hai phương pháp bên dưới dùng chung credential này.
03Phương pháp A

AI Agent + MCP Client Tool

Thêm node AI Agent, gắn một mô hình chat và gắn node MCP Client Tool với các cài đặt sau:

Node: MCP Client Tool  (connect it to the AI Agent "Tool" input)
Endpoint URL:      https://bananabanana.pro/api/mcp
Server Transport:  HTTP Streamable
Authentication:    Bearer Auth → your BananaBanana credential
Tools to Include:  Selected → list_models, get_account, generate_image, get_result

Agent cần mô hình ngôn ngữ riêng (OpenAI, Anthropic, Gemini hoặc bất kỳ mô hình nào n8n hỗ trợ) với API key riêng: BananaBanana tạo nội dung media, còn mô hình quyết định gọi tool nào.

Xác nhận giá

Các lệnh gọi video và nhiều ảnh trước tiên trả lời status: confirmation_required kèm quoted_cost_usd và không tính phí. Tiền chỉ bị trừ khi chính lệnh gọi đó được gửi lại với confirm_cost bằng đúng báo giá. Hãy dặn agent trong system message cần làm gì: dừng lại và báo giá (như bên dưới), hoặc tự xác nhận tới mức giới hạn bạn nêu.

System message chúng tôi dùng trong workflow dựng sẵn

You create images with the BananaBanana tools. Call generate_image with the user's
request (model nano-banana-2-lite unless the user names another model; list_models
shows models and prices). generate_image returns a job_id: call get_result with that
job_id and wait_seconds 30 until status is completed. If a tool answers status
confirmation_required, tell the user the quoted price and stop: never pass
confirm_cost on your own. Finish with the first file URL from get_result on its own line.

Việc tạo diễn ra bất đồng bộ: generate_image trả về job_id, và get_result chờ tối đa 30 giây mỗi lần gọi cho đến khi file sẵn sàng. Câu trả lời chứa một liên kết file có chữ ký, mà node HTTP Request đặt sau agent sẽ tải về dưới dạng file.

Node: HTTP Request  (after the AI Agent)
Method:  GET
URL:     {{ $json.output.match(/https?:\/\/\S+?\/api\/files\/[^\s)"'\]]+/)[0] }}
Options → Response → Response Format: File
04Phương pháp B

Node HTTP Request, không cần mô hình ngôn ngữ

Endpoint MCP là JSON thuần qua POST, nên các node HTTP Request thông thường có thể gọi trực tiếp. Đây là lựa chọn rẻ nhất và dễ đoán nhất: không tốn token của mô hình và không có agent tự chọn tham số.

  1. Tạo ảnh — POST một tools/call cho generate_image. Dùng {{ $execution.id }} trong idempotency_key: nếu n8n chạy lại node, cùng một key sẽ trả về job ban đầu thay vì tính phí hai lần.
  2. Lấy kết quả — POST get_result với job_id và wait_seconds: 30. Node If chuyển status: processing tới Wait 5 giây rồi quay lại; completed thì đi tiếp.
  3. Tải file — GET files[0].url với Response Format đặt là File. Dữ liệu nhị phân được chuyển tiếp tới Google Drive, S3, WordPress, YouTube, đăng mạng xã hội — bất kỳ node nào nhận file.
Node: HTTP Request "Generate image"
Method:          POST
URL:             https://bananabanana.pro/api/mcp
Authentication:  Generic Credential Type → Bearer Auth
Send Headers:    Accept = application/json, text/event-stream
Send Body:       JSON →
{{ JSON.stringify({ jsonrpc: "2.0", id: 1, method: "tools/call", params: {
     name: "generate_image",
     arguments: { prompt: $json.prompt, model: "nano-banana-2-lite",
                  aspect_ratio: "1:1", idempotency_key: "n8n-" + $execution.id } } }) }}

→ {{ $json.result.structuredContent.job_id }}   (status: "processing")
Node: HTTP Request "Get result"   (same URL, credential and headers)
{{ JSON.stringify({ jsonrpc: "2.0", id: 1, method: "tools/call", params: {
     name: "get_result",
     arguments: { job_id: $('Generate image').item.json.result.structuredContent.job_id,
                  wait_seconds: 30 } } }) }}

If  {{ $json.result.structuredContent.status }} is "processing"  → Wait 5 s → Get result
If  … is "completed"  → HTTP Request GET {{ $json.result.structuredContent.files[0].url }}
                        Options → Response → Response Format: File

Video: báo giá, kiểm tra, xác nhận

Với generate_video, hãy gửi lệnh gọi hai lần: câu trả lời đầu tiên mang quoted_cost_usd; node If so sánh nó với giới hạn của bạn, và chỉ khi đó lệnh gọi thứ hai mới gửi lại giá trị này dưới dạng confirm_cost. Video mất từ một đến mười phút, vì vậy hãy giữ vòng lặp get_result.

1. generate_video  { prompt, model: "veo-3.1-fast", duration: 8, resolution: "720p" }
   ← { status: "confirmation_required", quoted_cost_usd: 0.70 }      nothing charged
2. If  {{ $json.result.structuredContent.quoted_cost_usd }}  ≤  your limit
3. generate_video  { …same arguments…, confirm_cost: {{ $json.result.structuredContent.quoted_cost_usd }},
                     idempotency_key: "n8n-" + $execution.id }
   ← { job_id, status: "processing", cost_charged_usd: 0.70 }
4. get_result loop as above (videos take 1–10 minutes)
05Workflow dựng sẵn

Nhập workflow trong một phút

Cả hai workflow đều không chứa key hay credential. Trong n8n, chọn Workflows → Import from File (hoặc dán JSON vào editor), rồi chọn credential của bạn ở các node có dấu cảnh báo.

  • AI Agent + MCP Client Tool: Manual Trigger → AI Agent (OpenAI Chat Model, BananaBanana MCP) → Download file. Chọn credential OpenAI và credential Bearer Auth của bạn.

    Tải JSON · bananabanana-n8n-agent.json
  • HTTP Request: Manual Trigger → cài đặt request → Generate image → Get result (kèm vòng lặp chờ) → Download file, cùng các điểm dừng lỗi rõ ràng. Chọn credential Bearer Auth ở ba node request.

    Tải JSON · bananabanana-n8n-http.json

Cả hai workflow đã được nhập và chạy từ đầu đến cuối trên n8n 2.48.7 tự lưu trữ; ảnh mặc định có giá $0.03 mỗi lần chạy.

06Khắc phục sự cố

Các lỗi thường gặp và cách xử lý

  • 401 — key bị thiếu, gõ sai hoặc đã bị thu hồi. Credential phải chứa đúng key; n8n tự thêm từ Bearer.
  • INSUFFICIENT_BALANCE — số dư không đủ cho lệnh gọi. Câu trả lời kèm liên kết nạp tiền; chưa có khoản nào bị tính.
  • confirmation_required — không phải lỗi: lệnh gọi cần confirm_cost (xem Phương pháp A và công thức video).
  • RATE_LIMITED — quá 20 lệnh gọi tool mỗi phút trên một key. Hãy thêm Wait hoặc bật Retry On Fail kèm khoảng nghỉ.
  • DAILY_CAP_EXCEEDED — key đã chạm giới hạn hằng ngày bạn đặt. Hãy tăng giới hạn trong hồ sơ hoặc chờ sang ngày UTC tiếp theo.
  • SAFETY_FILTERED — bộ lọc nội dung của mô hình từ chối prompt hoặc kết quả; khoản phí được hoàn lại. Hãy diễn đạt lại prompt.
  • Liên kết file hết hạn sau 24 giờ. Hãy tải file ngay trong cùng lần chạy; trong vòng 30 ngày, get_result trả về liên kết mới.
07FAQ

Câu hỏi về n8n và BananaBanana

n8n có node BananaBanana không?

Chưa có trong danh sách node. Các node MCP Client Tool và HTTP Request đi kèm n8n đã truy cập được mọi tool của BananaBanana, và các workflow dựng sẵn ở trên đã cấu hình chúng cho bạn.

Tôi có cần key của OpenAI hay mô hình khác không?

Chỉ với Phương pháp A, nơi AI Agent quyết định gọi tool nào. Phương pháp B với các node HTTP Request không cần gì ngoài key BananaBanana.

Một lần chạy workflow tốn bao nhiêu?

Đúng bằng giá của thứ nó tạo ra: từ $0.03 cho một ảnh, từ $0.06 cho một clip video, $0.01 mỗi 200 ký tự giọng nói (tính cả phần lẻ). Kiểm tra trạng thái và tải về đều miễn phí, và các lần tạo thất bại được hoàn tiền.

Retry hoặc vòng lặp có thể tính phí tôi hai lần không?

Không, nếu lệnh gọi mang theo idempotency_key: lệnh gọi lặp lại với cùng key sẽ trả về job ban đầu mà không tính phí mới. Giới hạn hằng ngày trên key hạn chế thiệt hại của vòng lặp chạy mất kiểm soát.

Workflow có thể dùng những mô hình nào?

Tất cả mô hình của nền tảng: Nano Banana 2, 2.1, Lite và Pro, GPT Image và Qwen cho hình ảnh; Veo 3.1, Gemini Omni, Wan 3.0 và Grok Imagine cho video; Gemini TTS cho giọng nói. list_models trả về danh sách hiện tại kèm giá.

Đưa việc tạo nội dung vào workflow tiếp theo của bạn

Một key, thanh toán theo từng lần tạo, báo giá trước mỗi lệnh gọi đắt.

Tạo API key