Khóa và địa chỉ API
MarkdownLấy khóa ở đâu, đặt địa chỉ nào trong từng SDK và truyền khóa thế nào.
Hướng dẫn đầy đủ
Khóa API
Khóa được tạo trong bảng điều khiển tại ailoot.ai sau khi đăng ký. Khóa có dạng sk-…. Bạn có thể tạo nhiều khóa: riêng cho máy tính làm việc, máy chủ và từng ứng dụng — như vậy dễ thu hồi một khóa mà không ảnh hưởng các khóa khác.
Bạn có thể đặt tổng hạn mức chi tiêu, thời hạn, danh sách IP được phép và bị chặn, cùng hạn mức chi tiêu theo các cửa sổ 5 giờ, 1 ngày và 7 ngày. Khi chạm giới hạn, bạn sẽ nhận lỗi dễ hiểu: api_key_quota_exhausted (đã hết tổng hạn mức), usage_limit_reached (đã hết hạn mức chi tiêu của cửa sổ khóa — đợi cửa sổ làm mới hoặc tăng hạn mức), api_key_expired hoặc permission_denied (ví dụ, yêu cầu không đến từ IP được phép).
Địa chỉ API
Quy tắc chính: với máy khách tương thích OpenAI, địa chỉ có /v1, còn Anthropic và Gemini thì không có phần này.
| Máy khách | Địa chỉ cơ sở | Yêu cầu được gửi đến đâu |
|---|---|---|
| OpenAI SDK và các máy khách tương thích | https://api.ailoot.ai/v1 | /v1/chat/completions, /v1/responses, /v1/embeddings |
| Anthropic SDK, Claude Code | https://api.ailoot.ai | /v1/messages |
| Google GenAI SDK, Gemini CLI | https://api.ailoot.ai | /v1beta/models/{model}:generateContent |
| Máy khách yêu cầu địa chỉ đầy đủ | https://api.ailoot.ai/v1/chat/completions | như đã chỉ định |
Cách truyền khóa
Ailoot chấp nhận khóa trong bất kỳ tiêu đề nào trong ba tiêu đề sau — SDK gửi tiêu đề nào thì dùng tiêu đề đó:
| Tiêu đề | Ai gửi theo cách này |
|---|---|
Authorization: Bearer sk-… | OpenAI SDK, phần lớn máy khách |
x-api-key: sk-… | Anthropic SDK, Claude Code với ANTHROPIC_API_KEY |
x-goog-api-key: sk-… | Google GenAI SDK, Gemini CLI |
Trên các đường dẫn /v1/… khóa trong địa chỉ (?key= hoặc ?api_key=) không được chấp nhận: yêu cầu nhận lỗi 400 với mã invalid_request và thông báo rằng khóa được truyền trong địa chỉ. Như vậy khóa không lọt vào nhật ký và lịch sử trình duyệt. Nếu khóa từng xuất hiện trong địa chỉ, nên tạo khóa mới.
Trên các đường dẫn Gemini /v1beta/… để tương thích với Google, chấp nhận ?key= — với mức ưu tiên thấp nhất, sau các tiêu đề. ?api_key= ở đó cũng bị từ chối với lỗi 400. Dù vậy, cách đáng tin cậy hơn là truyền khóa trong tiêu đề x-goog-api-key.
Biến môi trường
Nên tạo một biến rồi dùng trong cài đặt của nhiều chương trình:
# ~/.zshrc hoặc ~/.bashrc
export AILOOT_API_KEY="sk-..."
# cho chương trình đọc các tên biến tiêu chuẩn
export OPENAI_BASE_URL="https://api.ailoot.ai/v1"
export OPENAI_API_KEY="$AILOOT_API_KEY"
export ANTHROPIC_BASE_URL="https://api.ailoot.ai"
export ANTHROPIC_AUTH_TOKEN="$AILOOT_API_KEY"setx AILOOT_API_KEY "sk-..."
# cho chương trình đọc các tên biến tiêu chuẩn
setx OPENAI_BASE_URL "https://api.ailoot.ai/v1"
setx OPENAI_API_KEY "sk-..."
setx ANTHROPIC_BASE_URL "https://api.ailoot.ai"
setx ANTHROPIC_AUTH_TOKEN "sk-..."
# khởi động lại terminal để áp dụng các biếnKiểm tra khóa
Cách ít tốn kém nhất để kiểm tra khóa là yêu cầu danh sách mô hình: thao tác này miễn phí.
curl -s https://api.ailoot.ai/v1/models \
-H "Authorization: Bearer $AILOOT_API_KEY"