logo

Xác thực

Giao diện LLMoxy Relay cần Token API người dùng. Token có thể được tạo trong Bảng điều khiển -> Token, thường bắt đầu bằng sk-.

Bearer Token

Khuyến nghị sử dụng tiêu đề chuẩn:

Authorization: Bearer <LLMOXY_API_KEY>

Ví dụ:

curl https://llmoxy.com/v1/models \
  -H "Authorization: Bearer <LLMOXY_API_KEY>"

Tiêu đề LLMOXY-API-KEY

Khi yêu cầu không có Authorization, LLMoxy cũng chấp nhận:

LLMOXY-API-KEY: <LLMOXY_API_KEY>

Ưu tiên sử dụng Authorization: Bearer. Tiêu đề tùy chỉnh chủ yếu dùng cho các tình huống tích hợp không thể thuận tiện đặt tiêu đề xác thực chuẩn.

Yêu cầu tương thích Claude

Đối với /v1/messages/v1/models, khách hàng kiểu Anthropic có thể sử dụng:

x-api-key: <LLMOXY_API_KEY>
anthropic-version: 2023-06-01

LLMoxy sẽ ánh xạ x-api-key vào cùng một quy trình xác thực token.

Yêu cầu tương thích Gemini

Đối với các tuyến tương thích Gemini như /v1beta/models/{model}:generateContent, LLMoxy chấp nhận:

x-goog-api-key: <LLMOXY_API_KEY>

Cũng hỗ trợ ?key=<LLMOXY_API_KEY> để tương thích với khách hàng Gemini. Tích hợp phía máy chủ nên sử dụng tiêu đề yêu cầu, tránh để khóa xuất hiện trong URL hoặc nhật ký.

Realtime WebSocket

Khách hàng WebSocket phía máy chủ có thể sử dụng tiêu đề xác thực chuẩn khi bắt tay. Khách hàng OpenAI Realtime kiểu trình duyệt có thể truyền khóa qua giao thức con:

realtime, openai-insecure-api-key.<LLMOXY_API_KEY>, openai-beta.realtime-v1

Kiểm soát Token

Token có thể bị giới hạn bởi số dư còn lại, thời hạn hết hạn, mô hình khả dụng, nhóm và danh sách trắng IP. Khi token hết hạn, thiếu số dư, bị vô hiệu hóa hoặc IP không được phép, Relay sẽ trả về phản hồi lỗi kiểu OpenAI.