VI ▾
Lấy khóa API

API tương thích OpenAI trong n8n: Hướng dẫn thiết lập

Nếu bạn tìm kiếm api tương thích openai n8n, câu trả lời ngắn gọn là bạn chỉ cần thay đổi hai giá trị trong thông tin xác thực OpenAI, đó là Base URL và API key. Phần còn lại của quy trình vẫn giữ nguyên như với bất kỳ node OpenAI nào.

Cập nhật

Quy trình tự động hóa đẳng hướng với các khối được kết nối gửi dữ liệu đến thiết bị đầu cuối API

Điểm chính

Những gì bạn cần trước khi bắt đầu

Một phiên bản n8n (đám mây hoặc tự lưu trữ) và một khóa API từ dịch vụ này. Nếu bạn chưa có khóa, trang khóa API sẽ hướng dẫn bạn đăng ký bằng Google hoặc email và mật khẩu. Người dùng mới có thể nhận $0,50 tín dụng dùng thử chỉ với một cú nhấp chuột trên trang đó, có hiệu lực trong 7 ngày và không cần thẻ.

Ba giá trị được đưa vào n8n:

  • URL cơ sở: https://api.onekeyllmapi.com/v1
  • API key: được gửi dưới dạng Authorization: Bearer <key>, n8n làm điều này cho bạn
  • ID mô hình: uncensored

Dịch vụ là một API LLM chỉ văn bản được lưu trữ, tuân theo định dạng yêu cầu OpenAI cho /v1/chat/completions, /v1/responses và /v1/models. Nó không phải là API chính thức của bất kỳ nhà cung cấp mô hình nào, vì vậy bất kỳ yêu cầu nào n8n gửi đến endpoint chat của OpenAI đều hoạt động ở đây miễn đó là yêu cầu văn bản.

Bước 1: Tạo thông tin xác thực

Trong n8n, mở Credentials, chọn Create credential và tìm kiếm OpenAI API. Điền vào như sau:

  1. Dán khóa của bạn vào trường API Key.
  2. Để trống Organization ID.
  3. Thay thế Base URL mặc định bằng https://api.onekeyllmapi.com/v1. Giữ /v1 ở cuối và không thêm /chat/completions.
  4. Lưu. n8n chạy một lệnh gọi thử nghiệm nhỏ khi bạn lưu; nếu nó thất bại, hãy chuyển đến phần khắc phục sự cố bên dưới.

Giữ một thông tin xác thực cho mỗi môi trường. Nếu bạn chạy n8n staging và production, hãy cung cấp cho mỗi cái một khóa riêng biệt để bạn có thể theo dõi chi tiêu riêng biệt và thu hồi một khóa mà không làm ảnh hưởng đến khóa kia.

Bước 2: Xây dựng quy trình chat đơn giản

Bắt đầu với thứ nhỏ nhất chứng minh kết nối: một bộ kích hoạt thủ công và một lệnh gọi mô hình.

  1. Thêm node Manual Trigger.
  2. Thêm node OpenAI (hoặc node con OpenAI Chat Model bên trong Basic LLM Chain, tùy thuộc vào phiên bản n8n của bạn) và chọn thông tin xác thực từ bước 1.
  3. Đối với mô hình, hãy tìm cách nhập thủ công. Các phiên bản n8n gần đây cung cấp chế độ By ID bên cạnh danh sách. Nhập uncensored vào đó. Danh sách có thể trống hoặc chỉ hiển thị tên OpenAI, vì n8n lọc nó ở phía nó.
  4. Thêm một prompt như Tóm tắt phiếu hỗ trợ này trong hai câu và chạy node.

Nếu phiên bản n8n của bạn bắt buộc phải chọn từ danh sách, hãy sử dụng phương pháp HTTP Request trong phần tiếp theo. Nó luôn hoạt động vì bạn kiểm soát toàn bộ yêu cầu.

Gọi API với node HTTP Request

Node HTTP Request là cách ổn định nhất để gọi API này từ n8n, và nó hiển thị mọi tham số mà API chấp nhận, bao gồm seed, stop, top_p và tools. Cấu hình nó như sau:

  • Phương thức: POST
  • URL: https://api.onekeyllmapi.com/v1/chat/completions
  • Xác thực: Loại thông tin xác thực chung với Xác thực theo tiêu đề, tên Authorization, giá trị Bearer YOUR_KEY
  • Gửi phần thân: bật, loại nội dung JSON

Body (chuyển trường sang Expression nếu bạn muốn chèn dữ liệu từ các node trước đó):

{
  "model": "uncensored",
  "messages": [
    {"role": "system", "content": "You are a concise assistant."},
    {"role": "user", "content": "Summarize this support ticket in two sentences."}
  ],
  "temperature": 0.4
}

Văn bản phản hồi nằm ở choices[0].message.content. Trong node tiếp theo, bạn có thể tham chiếu nó bằng {{ $json.choices[0].message.content }}.

Để kiểm tra cùng một yêu cầu bên ngoài n8n trước tiên, hãy chạy lệnh này trong terminal:

curl https://api.onekeyllmapi.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"uncensored","messages":[{"role":"user","content":"Say hello in five words."}]}'

Nếu curl hoạt động và n8n không hoạt động, vấn đề nằm ở cài đặt node, không phải khóa hoặc số dư của bạn.

Chế độ JSON cho các quy trình phân tích kết quả đầu ra

Các quy trình bị hỏng khi một mô hình bao bọc dữ liệu trong văn bản tự nhiên. Chế độ JSON yêu cầu API trả về một đối tượng JSON hợp lệ, mà bạn có thể chuyển trực tiếp đến node Set hoặc IF. Thêm response_format vào body:

{
  "model": "uncensored",
  "response_format": {"type": "json_object"},
  "messages": [
    {"role": "system", "content": "Reply only with a JSON object with keys sentiment and summary."},
    {"role": "user", "content": "The delivery was late but support fixed it fast."}
  ]
}

Hai thói quen làm cho điều này đáng tin cậy. Đầu tiên, hãy nói từ JSON và đặt tên các khóa trong prompt, vì chế độ JSON đảm bảo cú pháp, không phải lược đồ JSON của bạn. Thứ hai, phản hồi vẫn đến dưới dạng chuỗi trong message.content, vì vậy hãy thêm node Code hoặc một biểu thức với JSON.parse() trước khi bạn đọc các trường. Trong node OpenAI, tùy chọn tương tự xuất hiện dưới dạng tùy chọn Response Format dưới các tùy chọn node.

Xử lý lỗi 429 và các lỗi khác

n8n chạy các mục song song, vì vậy một lô 50 hàng có thể đạt giới hạn nhanh chóng. Khóa đầy đủ cho phép 8 yêu cầu đồng thời và 300 yêu cầu mỗi phút; khóa dùng thử cho phép 2 và 60. Khi bạn vượt quá, API trả về HTTP 429 với mã rate_limited (quá nhiều mỗi phút) hoặc concurrency (quá nhiều cùng lúc). Khi quá tải tạm thời, bạn nhận được 429 với tiêu đề Retry-After: 5.

Cài đặt thực tế trong n8n:

  • Mở node, đi đến Cài đặt, bật Thử lại khi thất bại, đặt Số lần thử tối đa là 3 hoặc 4 và Thời gian chờ giữa các lần thử là 5000 ms.
  • Đặt node Loop Over Items (kích thước lô 4 đến 6) trước lệnh gọi mô hình để bạn duy trì dưới 8 yêu cầu song song.
  • Dưới node Settings, On Error có thể được đặt để tiếp tục với đầu ra khi lỗi, vì vậy một hàng lỗi không làm dừng quá trình chạy.

Để tìm hiểu sâu hơn về hai loại giới hạn, hãy đọc tài liệu API. Các lỗi khác rất đơn giản: 401 có nghĩa là khóa sai hoặc tiêu đề thiếu từ Bearer, và 404 thường có nghĩa là Base URL có lỗi chính tả hoặc thêm một phần đường dẫn.

Danh sách kiểm tra khắc phục sự cố

Hầu hết các lỗi đến từ một danh sách ngắn các nguyên nhân. Hãy xem xét nó từ trên xuống dưới trước khi bạn đổ lỗi cho dịch vụ.

Triệu chứngNguyên nhân có thểCách khắc phục
Lỗi 401 khi lưu hoặc chạyKhóa sai, hoặc tiêu đề thiếu BearerDán lại khóa; trong Header Auth, giá trị phải bắt đầu bằng Bearer
Lỗi 404Base URL có lỗi chính tả hoặc thêm một đoạn đường dẫnSử dụng chính xác https://api.onekeyllmapi.com/v1 trong thông tin xác thực
Không tìm thấy mô hìnhID mô hình không được nhập là uncensoredChuyển sang chế độ Theo ID, hoặc sử dụng nút HTTP Request
Lỗi 429 khi xử lý đồng thờiHơn 8 lần chạy song song (2 đối với khóa dùng thử)Xử lý theo lô với Loop Over Items và thêm cơ chế thử lại
Lỗi phân tích cú pháp JSON ở bước sauPhản hồi là một chuỗi, hoặc prompt không chỉ định các khóaPhân tích cú pháp bằng JSON.parse() và mô tả các khóa trong prompt hệ thống

Khi liên hệ hỗ trợ, hãy bao gồm tiêu đề phản hồi X-Request-Id từ lệnh gọi bị lỗi. Trong n8n, bạn có thể xem các tiêu đề bằng cách bật Include Response Headers and Status trong tùy chọn của nút HTTP Request.

Kiểm thử mà không tốn nhiều

Hãy sử dụng tín dụng dùng thử trong khi bạn xây dựng. Với 2 yêu cầu đồng thời và 60 yêu cầu mỗi phút, khóa dùng thử sẽ chậm đối với các lô, nhưng đủ để kiểm tra thông tin xác thực, prompt và logic phân tích cú pháp. Hãy chuyển sang khóa đầy đủ khi bạn đưa quy trình làm việc vào lịch trình.

Chi phí và thiết kế quy trình làm việc hợp lý

Giá cả theo hình thức trả tiền theo mức sử dụng: $0,15 cho mỗi 1 triệu token đầu vào và $0,50 cho mỗi 1 triệu token đầu ra, trừ từ tín dụng trả trước. Một quy trình làm việc phân loại 1.000 email mỗi ngày với 600 token đầu vào và 100 token đầu ra cho mỗi email sẽ sử dụng 0,6 triệu token đầu vào ($0,09) và 0,1 triệu token đầu ra ($0,05), tương đương khoảng $0,14 mỗi ngày. Các yêu cầu bị lỗi hoặc bị từ chối sẽ không bị tính phí, do đó việc thử lại khi gặp lỗi không làm tăng hóa đơn lên gấp đôi. Chi tiết có trên trang giá cả.

Hãy giữ cho các prompt ngắn gọn, chỉ gửi các trường mà mô hình cần, và đặt max_tokens khi bạn biết câu trả lời sẽ ngắn. Nếu bạn cũng chạy các mô hình trên máy của mình, hãy xem bài viết về cách sử dụng LLM cục bộ thông qua API kiểu OpenAI, sử dụng cùng các cài đặt máy khách.

Hỏi đáp

Các nút n8n nào hoạt động với URL cơ sở tùy chỉnh?

Bất kỳ nút nào sử dụng thông tin xác thực OpenAI đều có thể sử dụng nó, vì trường URL cơ sở thuộc về thông tin xác thực. Nếu một nút không hiển thị tham số bạn cần, hãy sử dụng nút HTTP Request.

Tại sao danh sách mô hình lại trống hoặc sai trong n8n?

n8n tải và lọc danh sách ở phía nó. Nhập thủ công ID mô hình uncensored, hoặc sử dụng node HTTP Request nơi mô hình chỉ là một trường trong thân yêu cầu.

Tôi có thể sử dụng truyền phát (streaming) trong n8n không?

API hỗ trợ truyền phát qua SSE, nhưng hầu hết các nút n8n đều chờ phản hồi đầy đủ trước khi chuyển dữ liệu sang bước tiếp theo. Đối với các quy trình làm việc, một lệnh gọi không truyền phát thông thường sẽ đơn giản hơn.

Tôi kiểm tra số dư từ quy trình làm việc như thế nào?

Gọi GET /v1/balance, hoặc đọc tiêu đề X-Balance-USD trên bất kỳ phản hồi nào, và thêm một node IF cảnh báo bạn khi nó giảm xuống dưới một ngưỡng.

Khóa của bạn chỉ cách một bước

Tạo tài khoản, sao chép khóa, thay đổi URL cơ sở. Đó là toàn bộ quá trình thiết lập.