Source: https://ailoot.ai/docs/vi/keys/
Canonical: https://ailoot.ai/docs/vi/keys/
Language: vi

[Bắt đầu](https://ailoot.ai/docs/vi/) 

# Khóa và địa chỉ API

[Markdown](https://ailoot.ai/docs/vi/keys/index.md)

Lấy khóa ở đâu, đặt địa chỉ nào trong từng SDK và truyền khóa thế nào.

## [](https://ailoot.ai/docs/vi/keys/#key)Khóa API

Khóa được tạo trong bảng điều khiển tại [ailoot.ai](https://ailoot.ai) sau khi [đăng ký](https://ailoot.ai/register). 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).

Đừng công khai khóa trong mã, kho mã và ảnh chụp màn hình. Hãy lưu khóa trong biến môi trường hoặc trình quản lý bí mật. Nếu khóa bị lộ, hãy xóa trong bảng điều khiển và tạo khóa mới.

## [](https://ailoot.ai/docs/vi/keys/#base-url)Đị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 |

Gặp lỗi 404 ngay sau khi cấu hình? Gần như luôn do địa chỉ: thừa hoặc thiếu `/v1`, dấu gạch chéo kép hoặc `/chat/completions` ở nơi máy khách tự thêm phần đó.

## [](https://ailoot.ai/docs/vi/keys/#auth)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`.

## [](https://ailoot.ai/docs/vi/keys/#env)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:

```bash
# ~/.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"
```

```powershell
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ến
```

## [](https://ailoot.ai/docs/vi/keys/#check)Kiể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í.

```bash
curl -s https://api.ailoot.ai/v1/models \
  -H "Authorization: Bearer $AILOOT_API_KEY"
```

Còn câu hỏi? Hãy gửi Request ID và mô tả — chúng tôi sẽ giúp tìm hiểu.[Liên hệ hỗ trợ](mailto:support@ailoot.ai)

## Ailoot · Công ty và danh mục dự án của công ty





Ailoot dựa trên kinh nghiệm vận hành tích lũy, cơ sở khách hàng lớn, dịch vụ ổn định và việc kiểm soát KPI liên tục.





Công ty và danh mục dự án của công ty: hàng triệu khách hàng; doanh số hàng tỷ mỗi tháng.





Ailoot áp dụng kinh nghiệm vận hành này để cung cấp quyền truy cập API vào các tính năng AI trong sản phẩm của khách hàng, tác tử, ứng dụng và quy trình tự động hóa.