Kết nối n8n với CheapTokens: credential OpenAI, Base URL

Trong n8n, tạo một credential OpenAI, đặt https://api.cheaptokens.dev/v1 vào trường Base URL, dán khóa CheapTokens của bạn vào API Key, và chọn một model id trong node OpenAI Chat Model. Chỉ có vậy thôi: không cần custom node, không cần community package. Các workflow hiện có vẫn giữ nguyên node và chỉ nhận thêm một credential mới.

Điều này hoạt động được vì API CheapTokens nói đúng định dạng OpenAI Chat Completions (và cả Anthropic Messages), nên node OpenAI của n8n không thể phân biệt được. Nếu khái niệm "base URL" còn mới với bạn, bài giải thích này sẽ tóm gọn trong hai phút.

Credential n8n cho bạn những gì#

Credential OpenAI của n8n có bốn thứ cần điền. Theo mã nguồn của credential trong kho n8n (nhánh master, kiểm tra ngày 1 tháng 11 năm 2026), đó là: API Key (bắt buộc, được che), Organization ID (tùy chọn), Base URL (mặc định https://api.openai.com/v1, được mô tả là ghi đè địa chỉ API gốc) và một công tắc Add Custom Header với tên và giá trị header.

Một chi tiết đáng biết: trang tài liệu chính thức của n8n về credential OpenAI chỉ liệt kê key và organization ID. Trường Base URL hiển thị trong mã nguồn, nên hướng dẫn này dựa vào đó.

Khi bạn lưu, n8n kiểm tra credential bằng cách gửi một request tới {Base URL}/models với header Authorization: Bearer <API Key>. Vì vậy Base URL sai hoặc key sai sẽ lộ ra ngay tại đó, trước khi bạn xây dựng bất cứ thứ gì.

Thiết lập trong bốn bước#

Không chắc gõ gì làm model id? Hỏi chính API: Liệt kê model với GET /v1/models hiển thị các chuỗi chính xác. Các nhà cung cấp khác nhau đặt tên cùng một model khác nhau, nên hãy sao chép id từ CheapTokens, không phải từ tài liệu của dịch vụ khác.

Kiểm tra key bên ngoài n8n trước#

Nếu kiểm tra credential thất bại, bạn muốn biết vấn đề nằm ở n8n hay ở key. Một kiểm tra ngắn trên terminal sẽ trả lời điều đó. Key nằm trong biến môi trường, nên không có gì bí mật lọt vào lịch sử của bạn.

export CHEAPTOKENS_API_KEY="your-key-here"
curl https://api.cheaptokens.dev/v1/models \
  -H "Authorization: Bearer $CHEAPTOKENS_API_KEY"

import os
from openai import OpenAI

client = OpenAI(
    base_url="https://api.cheaptokens.dev/v1",
    api_key=os.environ["CHEAPTOKENS_API_KEY"],
)
r = client.chat.completions.create(
    model="deepseek-ai/DeepSeek-V4-Flash-0731",
    messages=[{"role": "user", "content": "Reply with one word: ready"}],
    max_tokens=20,
)
print(r.choices[0].message.content, r.usage)

Workflow đầu tiên: phân loại email đến#

Giả sử một hộp thư chung nhận khoảng một nghìn email mỗi ngày. Bạn muốn mỗi email được gắn thẻ billing, bug hoặc other, kèm một câu tóm tắt cho người xử lý.

Xây dựng như sau: một Gmail Trigger (hoặc node Webhook) đưa vào một Basic LLM Chain. Prompt trong chain đại khái là "Phân loại email này là billing, bug hoặc other, rồi tóm tắt trong một câu", với nội dung email được chèn từ node trước. Node OpenAI Chat Model bên dưới, với credential CheapTokens của bạn, sẽ lo phần suy nghĩ.

Công việc ngắn và lặp đi lặp lại: đầu vào nhỏ, câu trả lời nhỏ, hàng nghìn lần chạy giống hệt nhau. Đó là nơi một model rẻ với giá ổn định phát huy tác dụng nhất. Với loại công việc này trong CheapTokens, DeepSeek-V4-Flash cho bạn một mức giá bất kể thời điểm trong ngày, cửa sổ ngữ cảnh 380K và tối đa 32.768 token mỗi câu trả lời.

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

Giả sử mỗi email tạo ra prompt khoảng 1.500 token (hướng dẫn cộng với email) và model viết lại khoảng 300 token. Một lần chạy trên DeepSeek-V4-Flash tốn $0.000053. Với 1.000 email mỗi ngày, đây là tất cả các model đặt cạnh nhau với OpenRouter, tính cả đầu vào và đầu ra:

Số token là giả định cho ví dụ này; hãy đo của riêng bạn bằng cách gửi một email điển hình qua kiểm tra Python và đọc usage, rồi thay các con số. Giá hiện tại nằm trên trang giá.

Một workflow kiểu chat thì khác. Với node memory, toàn bộ lịch sử đi kèm mỗi lần gọi, nên đầu vào tăng theo từng tin nhắn. Vì sao một cuộc chat AI dài tốn hơn cho thấy điều đó cộng dồn nhanh thế nào.

Nếu không hoạt động#

Hầu hết lỗi là một trong ba thứ: key, địa chỉ hoặc model id. API 401 hoặc 404: sai key, base URL hoặc model id đi qua từng thông báo lỗi. Trước khi mở nó, hãy chạy qua danh sách này:

Muốn xem phần còn lại của thiết lập? Tài liệu CheapTokens có đầy đủ tham chiếu API, và trang DeepSeek liệt kê giới hạn của model. Đã dùng công cụ khác với cùng cách làm? Open WebUI và LangChain kết nối theo cùng cách: một địa chỉ, một key, một model id.