close

Cách kết nối OpenAI API vào n8n: API Key, node và lỗi 429

Tác giả: Đông Tùng Ngày đăng: 04/05/2025 Chuyên mục: n8n
Disclosure
Website Tino blog được cung cấp bởi Tino Group. Truy cập và sử dụng website đồng nghĩa với việc bạn đồng ý với các điều khoản và điều kiện trong chính sách bảo mật - điều khoản sử dụng nội dung. Tino Group có thể thay đổi điều khoản sử dụng bất cứ lúc nào. Việc bạn tiếp tục sử dụng Tino blog sau khi thay đổi có nghĩa là bạn chấp nhận những thay đổi đó.
Why Trust Us
Các bài viết với hàm lượng tri thức cao tại Tino blog được tạo ra bởi các chuyên viên Marketing vững chuyên môn và được kiểm duyệt nghiêm túc theo chính sách biên tập bởi đội ngũ biên tập viên dày dặn kinh nghiệm. Mọi nỗ lực của chúng tôi đều hướng đến mong muốn mang đến cho cộng đồng nguồn thông tin chất lượng, chính xác, khách quan, đồng thời tuân thủ các tiêu chuẩn cao nhất trong báo cáo và xuất bản.

Để kết nối OpenAI với n8n, bạn tạo API Key tại platform.openai.com, nạp tiền hoặc thêm phương thức thanh toán, rồi tạo credential “OpenAI” trong n8n và dán key vào. Sau đó dùng node OpenAI cho tác vụ đơn lẻ, hoặc node OpenAI Chat Model khi cần làm “bộ não” cho AI Agent.

Các bước dưới đây kiểm trên n8n bản 2.x và trang tài liệu OpenAI ngày 23/10/2026. Nếu bạn định dựng chatbot hay trợ lý có công cụ, đọc thêm bài node AI Agent trong n8n.

OpenAI API là gì?

OpenAI API là giao diện lập trình do OpenAI cung cấp, cho phép ứng dụng gửi văn bản, hình ảnh, âm thanh tới các mô hình AI của OpenAI và nhận kết quả trả về. API tính phí theo token (đơn vị đo lượng văn bản) và theo từng loại model.

Danh sách model thay đổi thường xuyên. Ngày 23/10/2026, trang Models của OpenAI giới thiệu dòng GPT-6 (Astra, Sol, Luna) cho văn bản và dòng GPT-Image cho ảnh; các model cũ như gpt-3.5-turbo, gpt-4 có lịch tắt ngày 23/10/2026 theo trang Deprecations. Vì vậy bài này không ghi cứng tên model: hãy chọn trong danh sách của node.

Vì sao nên tích hợp OpenAI API vào n8n?

Tích hợp OpenAI API vào n8n giúp workflow xử lý được những việc không có quy tắc cố định, như hiểu ý một email hay viết câu trả lời, rồi chuyển kết quả cho hàng trăm node khác lưu, gửi hoặc duyệt.

  • Xử lý ngôn ngữ: tóm tắt email dài, phân loại phản hồi khách hàng theo cảm xúc, trích tên sản phẩm và số lượng từ tin nhắn.
  • Tạo nội dung: viết nháp bài mạng xã hội, câu trả lời mẫu cho khách; người duyệt trước khi đăng.
  • Chatbot: trả lời câu hỏi thường gặp trên Telegram, Messenger, website.
  • Ảnh và âm thanh: phân tích ảnh hoá đơn, chép lời ghi âm cuộc họp, tạo ảnh minh hoạ từ mô tả.
  • Ghép với hệ thống khác: lấy dữ liệu từ Google Forms, cho AI phân tích, gửi kết quả qua email hoặc lưu Google Sheets.

Danh sách ý tưởng workflow dùng AI chi tiết hơn có ở bài tích hợp AI vào n8n.

OpenAI API có miễn phí không?

OpenAI API không miễn phí. API tính phí theo token và bạn cần nạp tiền trước (prepaid) hoặc thêm phương thức thanh toán thì key mới gọi được; tài khoản chưa có số dư sẽ bị từ chối với lỗi insufficient_quota. Đơn giá từng model có ở trang giá OpenAI API.

Trên n8n Cloud, tài liệu node OpenAI ghi có tuỳ chọn Use Gateway credits trong ô credential để chạy node mà không cần API Key riêng; mức credit tuỳ gói n8n Cloud.

Thêm API Key vào node OpenAI nhưng không chạy workflow thì có bị trừ tiền không?

Không. OpenAI chỉ tính phí khi có yêu cầu thật gửi tới API. Lưu API Key vào credential chỉ là lưu thông tin xác thực; nút kiểm tra kết nối của credential gọi danh sách model và không tốn token.

Tiền chỉ bị trừ khi bạn bấm Execute step, Execute workflow, hoặc khi workflow đã Publish chạy theo trigger.

Cần chuẩn bị gì trước khi kết nối OpenAI với n8n?

  • Tài khoản OpenAI và API Key: đăng ký hoặc đăng nhập tại platform.openai.com, nạp tiền vào mục Billing.
  • n8n: n8n Cloud hoặc bản tự host đang chạy ổn định.
  • Nếu tự host: cách dựng có ở bài cài đặt n8n trên VPS.

Cách kết nối OpenAI API vào n8n như thế nào?

Kết nối OpenAI với n8n gồm ba việc: tạo API Key trên OpenAI, tạo credential OpenAI trong n8n và thêm node OpenAI vào workflow. Toàn bộ mất khoảng năm phút nếu tài khoản đã nạp tiền.

Bước 1: Tạo API Key trên OpenAI

Đăng nhập platform.openai.com, mở trang API keys và bấm Create new secret key.

Trang API keys của OpenAI Platform với nút Create new secret key
Trang API keys

Đặt tên dễ nhận ra (ví dụ n8n-production), chọn project và quyền, rồi bấm Create secret key. Nên tạo key riêng cho n8n để thu hồi được mà không ảnh hưởng ứng dụng khác.

Hộp thoại Create new secret key của OpenAI: Owned by You, Name test tino, Project Default project, Permissions All, nút Create secret key
Đặt tên, chọn project và quyền

Sao chép key ngay: OpenAI chỉ hiện key một lần. Key bị lộ có thể bị OpenAI tự vô hiệu hoá, và ai có key đều tiêu được tiền trong tài khoản của bạn.

Hộp thoại Save your key của OpenAI hiển thị secret key đã che và nút Copy
Key chỉ hiện một lần (đã che)

Bước 2: Tạo workflow và trigger

Đăng nhập n8n, bấm Create workflow và đặt tên (ví dụ “OpenAI Integration”). Thêm một trigger: Manual Trigger để thử, hoặc Webhook, Schedule Trigger khi chạy thật.

Bước 3: Thêm node OpenAI

Bấm dấu +, tìm OpenAI. Node OpenAI bản V2 (từ n8n 1.117.0) có các nhóm Text, Image, Audio, File, Video, Conversation. Với văn bản, chọn Text → Generate a Model Response.

Danh sách thao tác của node OpenAI trong n8n bản cũ, gồm nhóm Assistant actions, Text actions với Message a model, Image actions
Ảnh chụp ở n8n 1.x: nhóm Assistant actions dùng Assistants API, OpenAI đã ngừng ngày 26/08/2026; node bản V2 không còn nhóm này.

Nếu muốn AI tự quyết định gọi công cụ (tra Google Sheets, gửi email), dùng node AI Agent và gắn OpenAI Chat Model vào ô Chat Model. Muốn gọi endpoint chưa có trong node, dùng HTTP Request với credential OpenAI.

Bước 4: Tạo credential OpenAI

Trong ô Credential to connect with, chọn Create new credential.

Node OpenAI trong n8n, ô Credential to connect with mở ra lựa chọn Create new credential
Ảnh chụp ở n8n 1.x (05/2025); trên n8n 2.x nút Test step đổi thành Execute step.
  • API Key: dán key vừa sao chép.
  • Organization ID (không bắt buộc): chỉ cần nếu tài khoản thuộc nhiều tổ chức; lấy ở mục Organization settings.
  • Base URL: giữ https://api.openai.com/v1. Chỉ đổi khi dùng dịch vụ tương thích OpenAI khác.
Form credential OpenAI trong n8n với API Key đã ẩn, Organization ID trống, Base URL https://api.openai.com/v1
Credential OpenAI

Bấm Save. Thấy thông báo kiểm tra kết nối thành công là key hợp lệ. Quay lại node, chọn credential vừa tạo.

Bước 5: Chọn model và viết prompt

Trong node OpenAI, chọn Model trong danh sách (From list), rồi nhập nội dung ở Messages → Prompt, ví dụ “Viết một bài tweet về AI”. Model nhỏ, rẻ đủ cho phân loại và tóm tắt ngắn; model lớn hợp với suy luận nhiều bước.

Bước 6: Chạy thử

Bấm Execute step để gửi yêu cầu (bước này có tính phí). Kết quả văn bản hiện ở khung Output. Nếu báo lỗi, xem bảng lỗi ở mục dưới.

Bước 7: Nối các node khác và Publish

Thêm node Google Sheets để lưu kết quả, Slack hoặc Gmail để gửi thông báo. Lưu workflow, rồi bấm Publish để workflow chạy theo trigger. Theo dõi các lần chạy ở tab Executions.

Nên dùng node OpenAI hay OpenAI Chat Model?

Node OpenAI hợp với tác vụ một bước, đầu vào và đầu ra rõ ràng. OpenAI Chat Model chỉ là “bộ não” gắn vào node AI Agent hoặc các node chuỗi LangChain, dùng khi cần nhớ hội thoại hoặc gọi công cụ.

Tiêu chíNode OpenAIOpenAI Chat Model (trong AI Agent)
Dùng choTóm tắt, phân loại, dịch, tạo ảnh, chép lờiChatbot, trợ lý tự gọi công cụ
Bộ nhớ hội thoạiKhông có sẵnGắn Simple Memory, Postgres Chat Memory…
Gọi công cụKhôngCó (Google Sheets, HTTP Request, workflow con…)
Ảnh, âm thanh, videoCó nhóm thao tác riêngChủ yếu văn bản
Chi phí mỗi lần chạyDễ ước lượngKhó ước lượng hơn vì Agent có thể gọi model nhiều lần

Muốn dùng Gemini thay OpenAI, cách lấy key có ở bài lấy API Key Google Gemini; phần còn lại của workflow giữ nguyên.

Lỗi thường gặp khi kết nối OpenAI với n8n là gì?

Phần lớn lỗi OpenAI trong n8n thuộc ba nhóm: key sai hoặc đã thu hồi (401), hết tiền hoặc vượt giới hạn tốc độ (429), và model đã ngừng (404). Ảnh dưới là lỗi khi tài khoản chưa nạp tiền.

Node OpenAI trong n8n báo lỗi Insufficient quota detected, You exceeded your current quota
Lỗi insufficient_quota khi tài khoản OpenAI chưa có số dư. Ảnh chụp ở n8n 1.x.
LỗiNguyên nhânCách xử lý
401 Incorrect API keyKey chép sai, thừa khoảng trắng, đã bị xoá hoặc bị OpenAI vô hiệu hoá do lộTạo key mới, cập nhật credential
429 insufficient_quotaTài khoản hết số dư hoặc chạm ngân sách thángNạp thêm tiền, kiểm mục Billing và Limits
429 Rate limit reachedGửi quá nhiều yêu cầu trong một phútThêm node Wait, chạy theo lô, bật Retry On Fail
404 model không tồn tạiModel đã ngừng hoặc tài khoản chưa có quyền dùngChọn lại model trong danh sách của node

Cách đọc và xử lý lỗi 401 nói chung có ở bài khắc phục lỗi 401 Unauthorized; các lỗi API khác trong n8n xem ở bài lỗi kết nối API thường gặp trong n8n.

Làm sao kiểm soát chi phí OpenAI trong n8n?

Kiểm soát chi phí OpenAI trong n8n bắt đầu từ phía OpenAI: đặt ngân sách và cảnh báo trong tài khoản, dùng key riêng cho từng project. Phía n8n, giới hạn số lần chạy và độ dài dữ liệu gửi đi.

  • Ngân sách: đặt mức chi tối đa và email cảnh báo trong phần Billing, Limits của tài khoản OpenAI.
  • Key theo project: mỗi workflow quan trọng một project, dễ xem chi phí và thu hồi riêng.
  • Cắt dữ liệu đầu vào: chỉ gửi đoạn văn cần xử lý, không gửi cả trang HTML.
  • Chọn model vừa đủ: model nhỏ cho phân loại, model lớn cho việc cần suy luận.
  • Chặn vòng lặp: đặt Max Iterations cho AI Agent, không để trigger gọi lại chính workflow.

Workflow AI chạy theo lịch hoặc nhận webhook cần n8n bật liên tục.

Muốn chạy n8n 24/7 mà không tự cài? VPS n8n của Tino cài sẵn n8n trên VPS NVMe đặt tại Việt Nam; bạn vẫn có quyền root để cấu hình. Xem cấu hình và giá trên trang sản phẩm.

Những câu hỏi thường gặp

Làm sao để dùng các model khác của OpenAI trong n8n?

Chọn model trong ô Model của node OpenAI hoặc OpenAI Chat Model; danh sách lấy trực tiếp từ tài khoản của bạn. Endpoint chưa có trong node thì gọi bằng HTTP Request với credential OpenAI, theo tài liệu OpenAI API.

Có phải 1 API Key chỉ dùng cho 1 node OpenAI duy nhất?

Không. Một credential OpenAI dùng được cho mọi node OpenAI trong nhiều workflow. Tuy vậy, nên tách key cho workflow quan trọng để theo dõi chi phí và thu hồi riêng khi cần.

Tôi có thể lưu lịch sử trò chuyện khi dùng OpenAI trong n8n không?

Có, qua node AI Agent gắn Simple Memory (mặc định nhớ 5 lượt gần nhất) hoặc Postgres Chat Memory khi cần lưu lâu và chạy nhiều worker. Node OpenAI đơn lẻ không tự nhớ hội thoại.

Làm thế nào để xử lý lỗi "Quota Exceeded" (429) khi dùng OpenAI API?

Nếu thông báo là insufficient_quota, tài khoản đã hết số dư hoặc chạm ngân sách: nạp thêm tiền hoặc nâng giới hạn. Nếu là rate limit, giảm tần suất gọi, thêm node Wait, chạy theo lô hoặc chọn model nhỏ, rẻ hơn trong danh sách.

Node OpenAI trong n8n còn dùng được Assistants API không?

Không. OpenAI đã ngừng Assistants API ngày 26/08/2026 và node OpenAI bản V2 đã bỏ nhóm thao tác Assistant. Workflow cũ dùng Assistant cần chuyển sang thao tác Generate a Model Response (Responses API) hoặc AI Agent.

Đông Tùng

Senior Technology Writer

Là cử nhân Quản trị kinh doanh của Trường Đại học Tài chính - Marketing, Tùng bắt đầu làm việc tại Tino Group từ năm 2021 ở vị trí Content Marketing để thỏa mãn niềm đam mê viết lách của bản thân. Sở hữu khả năng sáng tạo đặc biệt, anh cùng đội ngũ của mình đã tạo nên những chiến dịch quảng cáo độc đáo cùng vô số bài viết hữu ích về nhiều chủ đề khác nhau. Sự tỉ mỉ, kiên trì và tinh thần sáng tạo của Tùng đã góp phần lớn vào thành công của Tino Group trong lĩnh vực marketing trực tuyến.

Xem thêm bài viết

Bài viết liên quan