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ấtCơ sở API Chuẩn tắc
Tương thích OpenAIAuthorization: Bearer <AnyInt API Key>https://api.anyint.ai/openai/v1
Tin nhắn Anthropicx-api-key: <AnyInt API Key>https://api.anyint.ai/anthropic/v1
Gemini Developer APIx-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ố.

bash
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.

bash
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 HTTPNguyên nhân phổ biếnKhắc phục sự cố & Giải pháp
401 UnauthorizedKhó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 RequiredSố dư không đủ hoặc đạt giới hạn ngân sách hàng thángNạ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 ForbiddenHạn chế IP, không khớp môi trường hoặc không đủ quyềnKiể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ìnhXá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ờiGiả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 GatewayLỗi mạng nhà cung cấp thượng nguồn hoặc phản hồi không đúng định dạngCổ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 UnavailableTất cả các kênh định tuyến ứng viên tạm thời không khả dụngThử lại sau giây lát hoặc chuyển sang mô hình sao lưu tương đương.
504 Gateway TimeoutHế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.