Xác thực
Xác thực an toàn từng giao thức API được hỗ trợ bằng khóa API AnyInt.
Mọi yêu cầu API dành cho nhà phát triển đều yêu cầu một khóa API AnyInt đang hoạt động. Sử dụng tiêu đề mà giao thức máy khách của bạn mong đợi để các SDK OpenAI, Anthropic và Gemini hiện có tiếp tục hoạt động.
Xác thực được đề xuất theo Giao thức
| Giao thức | Đầu vào được đề xuất | Cơ sở API Chuẩn tắc |
|---|---|---|
| Tương thích OpenAI | Authorization: Bearer <AnyInt API Key> | https://api.anyint.ai/openai/v1 |
| Tin nhắn Anthropic | x-api-key: <AnyInt API Key> | https://api.anyint.ai/anthropic/v1 |
| Gemini Developer API | x-goog-api-key: <AnyInt API Key> | https://api.anyint.ai/gemini/v1beta |
| Phương tiện không đồng bộ | Authorization: Bearer <AnyInt API Key> | https://api.anyint.ai/v1/async-tasks |
Để tương thích với máy khách, cổng cũng chấp nhận các tiêu đề khóa AnyInt được hỗ trợ trên các họ giao thức và chấp nhận tham số truy vấn key của Gemini trên các tuyến Gemini. Ưu tiên tiêu đề để thông tin xác thực không xuất hiện trong URL hoặc nhật ký trung gian.
Cổng sẽ sử dụng thông tin xác thực AnyInt trước khi định tuyến nhà cung cấp. Nó không bao giờ chuyển tiếp thông tin xác thực đó làm khóa nhà cung cấp thượng nguồn. Các khóa không hợp lệ, đã hết hạn hoặc đã bị thu hồi sẽ thất bại.
Tạo Khóa
Tạo khóa API trong Console, sau đó lưu trữ khóa đó trong trình quản lý bí mật phía máy chủ hoặc biến môi trường.
Các khóa AnyInt mới cấp sử dụng tiền tố sk- theo sau là 52 ký tự Base64URL (tổng cộng 55 ký tự). Các khóa ak_ hiện có vẫn hợp lệ cho đến khi bạn xoay vòng hoặc vô hiệu hóa chúng. Luôn sao chép toàn bộ giá trị được hiển thị bởi Console; không tự thêm hoặc xóa tiền tố.
export ANYINT_API_KEY="your_api_key"Nguyên tắc Bảo mật
- Lưu trữ khóa trong trình quản lý bí mật phía máy chủ hoặc biến môi trường.
- Không bao giờ đặt khóa vào JavaScript phía máy khách, kho lưu trữ mã nguồn, nhật ký hoặc URL.
- Sử dụng một khóa riêng cho mỗi ứng dụng và môi trường.
- Xoay vòng khóa ngay lập tức nếu có thể nó đã bị lộ.
- Không chuyển tiếp khóa AnyInt đến các nhà cung cấp thượng nguồn.
Kiểm tra Xác thực
Liệt kê các mô hình để xác minh khóa trước khi gửi yêu cầu suy luận.
curl "https://api.anyint.ai/openai/v1/models" \
--header "Authorization: Bearer $ANYINT_API_KEY"Lỗi xác thực trả về HTTP 401 với lỗi có định dạng giao thức. Một khóa hợp lệ vẫn có thể nhận được 402 cho số dư không đủ hoặc 503 khi không có nhà cung cấp đủ điều kiện nào khả dụng.
Khắc phục sự cố lỗi phổ biến
Khi yêu cầu API thất bại, hãy sử dụng bảng này để nhanh chóng xác định nguyên nhân và giải pháp:
| Trạng thái HTTP | Nguyên nhân phổ biến | Khắc phục sự cố & Giải pháp |
|---|---|---|
| 401 Unauthorized | Khóa API không hợp lệ hoặc đã hết hạn, hoặc thiếu tiêu đề | Xác minh mã thông báo Bearer hoặc tiêu đề x-api-key; đảm bảo khóa đang hoạt động trong Khóa API bảng điều khiển. |
| 402 Payment Required | Số dư không đủ hoặc đạt giới hạn ngân sách hàng tháng | Nạp thêm tín dụng trong Bảng điều khiển hoặc tăng giới hạn ngân sách hàng tháng cho khóa API. |
| 403 Forbidden | Hạn chế IP, không khớp môi trường hoặc không đủ quyền | Kiểm tra phạm vi khóa API và xác minh IP máy khách trong danh sách IP được phép. |
| 404 Not Found | Đường dẫn điểm cuối không chính xác hoặc không xác định được ID mô hình | Xác minh đường dẫn Base URL; gọi GET /v1/models để xác nhận ID mô hình đang hoạt động. |
| 429 Too Many Requests | Đạt giới hạn tốc độ (RPM/TPM) hoặc giới hạn đồng thời | Giảm tính đồng thời; định cấu hình thử lại theo cấp số nhân; hoặc yêu cầu tăng hạn mức trong Bảng điều khiển. |
| 502 Bad Gateway | Lỗi mạng nhà cung cấp thượng nguồn hoặc phản hồi không đúng định dạng | Cổng AnyInt tự động thử chuyển đổi dự phòng giữa các kênh; nếu sự cố vẫn tiếp diễn, hãy báo cáo qua Nhật ký yêu cầu của Bảng điều khiển. |
| 503 Service Unavailable | Tất cả các kênh định tuyến ứng viên tạm thời không khả dụng | Thử lại sau giây lát hoặc chuyển sang mô hình sao lưu tương đương. |
| 504 Gateway Timeout | Hết thời gian suy luận thượng nguồn (các mô hình suy luận phức tạp) | Kiểm tra độ phức tạp của câu lệnh; tăng thời gian chờ phía máy khách; bật phát trực tuyến (stream: true) cho các mô hình suy luận. |