Xác thực
Cách gửi khóa của bạn, header mà mỗi định dạng yêu cầu và cách bảo vệ khóa.
Mỗi yêu cầu cần một khóa API được tạo trong bảng điều khiển của bạn. Khóa bắt đầu bằng sk- và sử dụng quyền hạn cùng số dư của tài khoản đã tạo khóa.
Hai tiêu đề, một khóa
Cùng một khóa dùng được với cả hai định dạng — chỉ tên tiêu đề thay đổi.
| Định dạng | Endpoint | Header |
|---|---|---|
| Anthropic | /v1/messages | x-api-key: sk-... |
| Anthropic (alt) | /v1/messages | Authorization: Bearer sk-... |
| OpenAI | /v1/chat/completions | Authorization: Bearer sk-... |
Định dạng Anthropic còn yêu cầu tiêu đề phiên bản. Mọi SDK Anthropic đều tự động thiết lập tiêu đề này:
-H "anthropic-version: 2023-06-01"Biến môi trường
Hầu hết công cụ đọc các biến này thay vì nhận khóa qua đối số:
| Biến | Được sử dụng bởi | Giá trị |
|---|---|---|
ANTHROPIC_BASE_URL | Claude Code, SDK Anthropic | https://aiprimetech.io |
ANTHROPIC_AUTH_TOKEN | Claude Code | của bạn sk- khóa |
ANTHROPIC_API_KEY | SDK Anthropic (Python/TS) | của bạn sk- khóa |
OPENAI_BASE_URL | SDK OpenAI, LangChain, LiteLLM | https://aiprimetech.io/v1 |
OPENAI_API_KEY | SDK OpenAI | của bạn sk- khóa |
Hãy chú ý đến trường
/v1 hậu tố trên OPENAI_BASE_URL nhưng không trên ANTHROPIC_BASE_URL. Sự khác biệt này nằm trong các SDK chính thức, không phải do chúng tôi tạo ra — trình khách OpenAI nối các đường dẫn vào địa chỉ cơ sở bạn cung cấp, còn trình khách Anthropic tự nối /v1 . Thiết lập sai phần này là lỗi cấu hình phổ biến nhất.Bảo mật khóa
- Tạo một khóa riêng cho từng máy hoặc dự án để có thể thu hồi một khóa mà không ảnh hưởng đến các khóa khác.
- Không bao giờ đưa khóa vào kho mã nguồn. Hãy dùng biến môi trường hoặc trình quản lý bí mật; thêm
.envsang.gitignore. - Khóa chỉ được hiển thị đầy đủ một lần. Hãy thay khóa thay vì cố khôi phục khóa đã mất.
- Khóa bị lộ có thể tiêu dùng số dư của bạn. Hãy thu hồi khóa ngay trong bảng điều khiển — việc thu hồi có hiệu lực tức thì.
- Ưu tiên các lệnh gọi từ phía máy chủ. Khóa được đưa vào gói mã trình duyệt hoặc ứng dụng di động là khóa công khai.
Thu hồi và thay khóa
- Bảng điều khiển → Khóa API.
- Tạo khóa thay thế trước rồi triển khai khóa đó.
- Xóa khóa cũ sau khi lưu lượng đã chuyển sang khóa mới. Các yêu cầu đang xử lý sử dụng khóa cũ sẽ thất bại ngay sau khi khóa bị xóa.