n8n

Trường Base URL của thông tin xác thực OpenAI — https://api.kunavo.com/v1, giữ /v1 — đưa mọi OpenAI Chat Model trong workflow n8n tới Kunavo; bản thân nút model không có trường endpoint.

Credentials  →  Create credential  →  OpenAI
  API Key                      sk-kn-...
  Organization ID (optional)   leave empty
  Base URL                     https://api.kunavo.com/v1     <- keep the /v1

Workflow  →  AI Agent or Basic LLM Chain  →  Chat Model: OpenAI Chat Model
  Credential to connect with   the OpenAI credential above
  Model                        ID mode:  claude-sonnet-5
  Use Responses API            on   → POST /v1/responses
                               off  → POST /v1/chat/completions

Từng bước

1. Tạo khóa tại /app/keys rồi sao chép khóa — khóa chỉ hiển thị một lần.
2. Trong n8n, tạo thông tin xác thực loại OpenAI. Nhập khóa vào API Key, để trống Organization ID (optional) và thay giá trị mặc định https://api.openai.com/v1 trong Base URL bằng https://api.kunavo.com/v1. Lưu lại.
3. Thêm nút AI Agent hoặc Basic LLM Chain, rồi gắn nút con OpenAI Chat Model sử dụng thông tin xác thực đó. Đổi trường Model từ From List sang ID, rồi nhập id như được liệt kê tại GET /v1/models, chẳng hạn claude-sonnet-5 — danh sách cũng dùng được, nhưng nhập id trực tiếp giúp quy trình dễ đọc hơn.
4. Chọn bật hay tắt Use Responses API: hãy để bật, trừ khi một công cụ trong chuỗi của bạn cần Chat Completions hoặc bạn muốn nhật ký thực thi n8n hiển thị yêu cầu chat completions.
5. Chạy quy trình một lần với câu lệnh một dòng trước khi kết nối với trình kích hoạt. Lỗi 401 nghĩa là khóa có vấn đề; lỗi 404 kèm mã missing_v1_prefix (hoặc trong các lần chạy cũ hơn, thông báo bắt đầu bằng <!DOCTYPE html>) nghĩa là Base URL bị thiếu /v1.

Đã kiểm tra đối chiếu với Mã nguồn thông tin xác thực OpenAI của n8n tại thẻ n8n@2.41.4 vào 1 tháng 10, 2026. Cài đặt của bên thứ ba có thể thay đổi; nếu tên trường ở đây không còn khớp với những gì bạn thấy, trang đó là nguồn có thẩm quyền, không phải trang này.

Xác minh trước khi gỡ lỗi ứng dụng khách

Một yêu cầu sẽ xác định liệu lỗi nằm ở endpoint, khóa hay tệp cấu hình. Nếu lệnh này trả về JSON, cùng base URL và khóa sẽ hoạt động trong n8n.

# Settles whether a failure is the endpoint, the key, or the client.
curl -sS https://api.kunavo.com/v1/models \
  -H "Authorization: Bearer sk-kn-..."

Đặt model id nào vào trường

Mọi mô hình văn bản đều có thể truy cập bằng model id — danh sách đang hoạt động là GET /v1/models, còn danh mục kèm giá nằm trên trang mô hình. Mức giá tính bằng USD trên mỗi 1M token, đầu vào / đầu ra.

Vì sao Base URL nằm trong thông tin xác thực

Các hướng dẫn cũ đặt endpoint bên trong nút mô hình. Trong mã nguồn đã phát hành, tùy chọn Base URL trong nút bị ẩn từ phiên bản nút 1.1 trở đi, vì vậy nút bạn thêm hôm nay không có trường đó và Base URL trong thông tin xác thực mới là giá trị được dùng. Tài liệu OpenAI Chat Model và trang thông tin xác thực của n8n không mô tả trường này; nhưng mã nguồn có mô tả “Ghi đè URL cơ sở mặc định cho API”. Nút HTTP Request là một cách khác hoàn toàn — vẫn dùng được, nhưng bạn sẽ phải tự tạo yêu cầu mà nút AI Agent có thể tạo thay bạn.

Bật hoặc tắt Responses API

• Bật (mặc định trên nút 1.3) — yêu cầu được gửi đến /v1/responses. Đây là chế độ duy nhất hiển thị Công cụ tích hợp của nút — Web Search, File Search và Code Interpreter. Đây là các công cụ do OpenAI lưu trữ; chưa ai kiểm thử chúng qua Kunavo, vì vậy hãy thử trước khi xây dựng quy trình phụ thuộc vào chúng.
• Tắt — yêu cầu được gửi đến /v1/chat/completions, định dạng được hỗ trợ rộng rãi nhất và là lựa chọn dự phòng nếu lệnh gọi công cụ hoạt động không đúng ở chế độ kia.
• Các công cụ bạn gắn vào AI Agent được gửi đến mô hình dưới dạng định nghĩa hàm. Lượt trao đổi đó không nằm trong phạm vi kiểm tra này, vì vậy hãy chạy một lệnh gọi công cụ trên quy trình thử nghiệm trước khi dựa vào tính năng này.

n8n và OpenRouter

n8n cung cấp một nút OpenRouter Chat Model riêng cùng thông tin xác thực OpenRouter của nút đó. Thông tin xác thực có trường API Key và Base URL bị ẩn, cố định ở https://openrouter.ai/api/v1; bước kiểm tra của nó gọi tuyến /key riêng của OpenRouter — vì vậy nút OpenRouter chỉ có thể kết nối với OpenRouter. Nếu muốn dùng OpenRouter, hãy dùng nút đó cùng khóa OpenRouter; bạn không cần nội dung nào trên trang này.

Mọi endpoint tương thích OpenAI khác, bao gồm Kunavo, đều dùng OpenAI Chat Model và Base URL trong thông tin xác thực OpenAI như trên. Hãy chọn dựa trên những khác biệt thực tế — bạn cần mô hình nào, muốn thanh toán ra sao, có muốn dùng chung một số dư giữa n8n và các công cụ khác không — chứ không phải dựa trên nút. Phần so sánh phía Kunavo nằm trong Kunavo so với OpenRouter.

Giới hạn chi phí cho quy trình chạy không cần giám sát

• Max Retries của nút mặc định là 2 và Timeout là 60000 ms. Yêu cầu hết thời gian chờ sẽ được thử lại, và mỗi lần thử lại là một yêu cầu mới bị tính phí.
• Đặt Maximum Number of Tokens trên các nút chạy theo từng mục — một vòng lặp qua 1.000 hàng sẽ nhân chi phí của mỗi lần gọi lên.
• Dùng một khóa Kunavo riêng cho mỗi quy trình chạy thực tế để trang sử dụng cho biết khóa nào đã tiêu tốn bao nhiêu, đồng thời có thể thu hồi một khóa mà không ảnh hưởng đến các khóa khác.

Các lỗi hiển thị như thế nào

• “401 Thiếu hoặc khóa API không hợp lệ” — Base URL đúng nhưng khóa không đúng. Đã tái hiện trên 2.41.4.
• “404 <!DOCTYPE html>…”, được LangChain phân loại là MODEL_NOT_FOUND — gây hiểu nhầm: mô hình vẫn ổn, Base URL thiếu /v1 và yêu cầu đã đến trang web. Đã tái hiện trên 2.41.4.
• Thông báo JSON cho biết mô hình không khả dụng — ID mô hình không khớp chính xác với GET /v1/models.