Chạy lệnh kiểm thử curl này trước
Trước khi thay đổi mã, hãy loại bỏ ứng dụng của bạn khỏi phương trình. Lệnh đơn giản này gửi yêu cầu hợp lệ tối thiểu đến API:
curl -i https://api.unrestrictedaiapi.com/v1/models \
-H "Authorization: Bearer YOUR_KEY"
GET /v1/models không tốn phí, nên đây là cách an toàn để kiểm tra khóa. Cờ -i in ra dòng trạng thái và các tiêu đề.
- 200 và danh sách mô hình: khóa của bạn ổn. Ứng dụng của bạn đang gửi một thứ gì đó khác, vì vậy hãy chuyển sang các phần về biến môi trường và base URL.
- 401: khóa hoặc tiêu đề bị sai. Hãy tiếp tục với phần tiếp theo.
- Lỗi kết nối hoặc DNS: base URL bị sai, đây là một vấn đề khác với lỗi 401.
Dán khóa thủ công vào bài kiểm thử này, không thông qua biến. Điều này loại bỏ biến môi trường khỏi danh sách nghi phạm.
Nguyên nhân 1: tiêu đề không hoàn toàn chính xác
API mong đợi Authorization: Bearer <key>. Các sai lệch nhỏ đều tạo ra lỗi LLM API 401:
Authorization: YOUR_KEYthiếu từ Bearer.Authorization: Bearer: YOUR_KEYcó thêm dấu hai chấm.Authorization: Bearer "YOUR_KEY"có dấu ngoặc kép bên trong giá trị.Authorization: Bearer YOUR_KEYvới hai khoảng trắng.- Một tiêu đề tên
X-API-Keyhoặcapi-keythay vìAuthorization. Đó là các quy ước của các dịch vụ khác.
Nếu bạn sử dụng SDK OpenAI, bạn không tự viết tiêu đề. SDK xây dựng nó từ đối số api_key. Nếu bạn vẫn thấy lỗi 401, thì giá trị được truyền vào SDK mới là vấn đề, không phải định dạng tiêu đề.
Nguyên nhân 2: khóa bị hỏng
Khóa là các chuỗi ngẫu nhiên dài, vì vậy lỗi sao chép thường xảy ra và khó nhận ra bằng mắt thường.
- Dòng mới hoặc khoảng trắng ở cuối. Sao chép từ terminal hoặc tệp văn bản thường thêm vào một ký tự như vậy. Nhiều thư viện HTTP sau đó sẽ gửi một tiêu đề không hợp lệ hoặc một khóa không khớp.
- Khóa bị cắt ngắn. Nhấp đúp chỉ chọn một phần của chuỗi nếu khóa chứa các ký tự làm gián đoạn việc chọn từ. Hãy thay vào đó sử dụng nút sao chép trên trang khóa API.
- Dấu ngoặc kép thông minh. Dán qua trình xử lý văn bản hoặc ứng dụng trò chuyện có thể thay thế dấu ngoặc kép thẳng bằng dấu ngoặc kép cong.
- Khóa cũ hoặc đã xoay vòng. Nếu bạn đã tạo khóa mới, khóa cũ có thể không còn là khóa bạn đang sử dụng.
Để kiểm tra các ký tự ẩn trong Python, hãy in repr của giá trị:
import os
key = os.environ.get("API_KEY", "")
print(repr(key), len(key))
print(repr(key.strip()) == repr(key))
Nếu dòng thứ hai in ra False, bạn có khoảng trắng xung quanh khóa. Hãy gọi .strip() khi bạn đọc nó.
Nguyên nhân 3: sai base URL
Đây là lỗi phổ biến nhất khi chuyển đổi một ứng dụng hiện có sang nhà cung cấp mới. Khóa của bạn chỉ hợp lệ trên máy chủ đã cấp phát nó. Base URL cho trang web này là:
{"base_url": "https://api.unrestrictedaiapi.com/v1"}
Hai mẫu lỗi xuất hiện lại đi lại lại:
- Bạn đã đặt khóa mới nhưng vẫn giữ nguyên base URL cũ. Yêu cầu được gửi đến nhà cung cấp cũ, người này từ chối một khóa mà họ chưa từng thấy và trả về 401. Văn bản lỗi sau đó đề cập đến nhà cung cấp cũ, đây là một manh mối hữu ích.
- Bạn đã đặt base URL mới nhưng vẫn giữ khóa cũ trong biến môi trường. Yêu cầu đến được với chúng tôi, và chúng tôi từ chối khóa của nhà cung cấp khác.
Hãy cũng kiểm tra đường dẫn. Base URL đã kết thúc bằng /v1, vì vậy các SDK thêm /chat/completions vào đó. Nếu bạn xây dựng URL bằng tay, đường dẫn đầy đủ là /v1/chat/completions, không phải /v1/v1/chat/completions.
Nguyên nhân 4: biến môi trường và tệp cấu hình
Nếu curl hoạt động nhưng ứng dụng của bạn thất bại, có điều gì đó đang cung cấp cho ứng dụng một khóa khác với những gì bạn nghĩ.
- Biến chưa được xuất. Trong shell,
API_KEY=abc python app.pychạy được, nhưngAPI_KEY=abctrên một dòng riêng lẻ không truyền được đến các tiến trình con. Hãy dùngexport. - Bị ghi đè bởi một giá trị khác. Các thư viện có thể tự động đọc
OPENAI_API_KEY. Nếu một khóa cũ được đặt trong cấu hình shell của bạn, nó có thể ghi đè những gì bạn dự định. - Dấu ngoặc kép trong tệp .env. Một số loader giữ nguyên dấu ngoặc kép như một phần của giá trị. Nếu khóa của bạn được bao quanh bởi các ký tự ngoặc kép, hãy xóa chúng hoặc kiểm tra bằng lệnh repr ở trên.
- Chưa khởi động lại. Máy chủ và notebook đọc biến môi trường khi khởi động. Hãy khởi động lại sau khi chỉnh sửa.
- Môi trường khác biệt khi sản xuất. Các container, CI và bảng điều khiển lưu trữ đều có vùng chứa biến riêng của chúng. Hãy in độ dài khóa, không in chính khóa đó, vào nhật ký.
Một đoạn mã Python tối giản để kiểm tra cấu hình
Script này sử dụng SDK OpenAI và báo cáo rõ ràng nếu xác thực thất bại:
import os
from openai import OpenAI, AuthenticationError
client = OpenAI(
base_url="https://api.unrestrictedaiapi.com/v1",
api_key=os.environ["API_KEY"].strip(),
)
try:
r = client.chat.completions.create(
model="uncensored",
messages=[{"role": "user", "content": "Reply with the word ok."}],
max_tokens=5,
)
print("auth ok:", r.choices[0].message.content)
except AuthenticationError as e:
print("401:", e.status_code, e.response.headers.get("X-Request-Id"))
Nếu kết quả in ra X-Request-Id, hãy đính kèm nó khi bạn gửi email đến hỗ trợ, vì nó giúp nhóm tìm thấy yêu cầu của bạn. Đoạn mã kiểm tra tương tự cho các ngôn ngữ khác có trong hướng dẫn nhanh cho năm ngôn ngữ.
401 so với các lỗi khác
Đừng lãng phí thời gian xác thực nếu lỗi là một vấn đề khác. Bản đồ nhanh:
| Mã | Ý nghĩa thông thường | Vị trí cần kiểm tra |
|---|---|---|
| 401 | Thiếu hoặc khóa không hợp lệ | Header, khóa, base URL |
| 429 | Giới hạn tốc độ hoặc quá tải tạm thời | Chờ một lúc rồi thử lại; xem tài liệu về các giới hạn |
| 400 | Phần thân yêu cầu bị lỗi cú pháp | JSON, tên mô hình, các tham số |
| 404 | Đường dẫn sai | Base URL và endpoint |
Hãy kiểm tra cả tên mô hình. Sử dụng uncensored chính xác; một ID mô hình sai là lỗi yêu cầu, không phải lỗi 401. Chi tiết đặc tả API, bao gồm các endpoint và header mà API chấp nhận, có trên trang tài liệu đặc tả API tương thích OpenAI.
Proxy, trình duyệt và các bước cuối cùng
Hai cấu hình gây ra lỗi 401 trông có vẻ bí ẩn.
Proxy và gateway
Một proxy ngược, gateway API hoặc wrapper serverless giữa ứng dụng của bạn và API có thể làm mất hoặc ghi đè header Authorization. Hãy kiểm tra từ cùng một máy bằng curl và so sánh. Một số framework cũng chỉ chuyển tiếp header này đến các máy chủ cùng nguồn gốc, nên một fetch wrapper tùy chỉnh có thể vô tình làm mất nó trong các lệnh gọi khác nguồn gốc.
Khóa trong mã front-end
Gọi API trực tiếp từ JavaScript trên trình duyệt sẽ khiến khóa hiển thị với bất kỳ ai mở công cụ nhà phát triển, và trình duyệt cũng có thể chặn yêu cầu vì lý do cross-origin trông giống như lỗi xác thực. Hãy giữ khóa trên máy chủ và để front-end của bạn gọi endpoint của chính bạn, endpoint này sau đó gọi API với khóa được đính kèm. Nếu khóa từng được dán vào mã công khai hoặc ảnh chụp màn hình, hãy thay thế nó.
Vẫn bị kẹt
Nếu một khóa vừa sao chép vẫn trả về lỗi 401 trong lệnh kiểm tra curl, hãy tạo lại khóa đó từ trang khóa API, dán nó trực tiếp vào lệnh và thử lại một lần nữa. Nếu vẫn thất bại, hãy gửi cho bộ phận hỗ trợ thời gian của yêu cầu, endpoint và tiêu đề phản hồi X-Request-Id. Đừng bao giờ gửi toàn bộ khóa trong một tin nhắn; bốn ký tự đầu và bốn ký tự cuối là đủ để nhận diện nó.
