Xác thực API nền tảng

Các yêu cầu API nền tảng được xác thực bằng Management Key gửi dưới dạng Bearer token:

Authorization: Bearer rat_your_management_key

Ví dụ:

curl https://www.routeapi.ai/api/open/v1/balance \
  -H "Authorization: Bearer $ROUTEAPI_MANAGEMENT_KEY"

Management Key

Management Key là thông tin xác thực của API nền tảng (/api/open/v1) và bắt đầu bằng rat_. Đây là loại thông tin xác thực khác với API Key sk- dùng để gọi mô hình:

Thông tin xác thực	Tiền tố	Mục đích
Management Key	rat_	Gọi /api/open/v1 để quản lý tài khoản và API Key
API Key	sk-	Gọi các endpoint mô hình (như /v1/chat/completions), xem Chat Completions

Management Key chỉ có thể thao tác trên tài nguyên thuộc người dùng sở hữu nó. Nó không kế thừa quyền quản trị viên và không thể quản lý Management Key thông qua API nền tảng.

Giữ bí mật

Management Key có thể quản lý các API Key trong tài khoản của bạn và đọc giá trị đầy đủ qua Xem API Key đầy đủ. Không commit vào kho mã, không nhúng vào mã frontend và không chia sẻ cho người khác. Bản rõ chỉ hiển thị một lần khi tạo; nếu làm mất, hãy tạo key mới.

Tạo Management Key

1. Đăng nhập console RouteAPI.
2. Mở Management Keys ở thanh bên (giữa Billing và Playground), hoặc truy cập trực tiếp console/management-keys.
3. Nhập tên, chọn thời hạn hết hạn, sau đó tạo key.
4. Sao chép và lưu ngay key bản rõ bắt đầu bằng rat_.

Mỗi người dùng có thể giữ tối đa 10 Management Key. Key đã hết hạn vẫn nằm trong danh sách và vẫn tính vào giới hạn; hãy xóa key để giải phóng chỗ. Nếu key bị lộ, hãy xóa nó trên cùng trang; việc xóa có hiệu lực ngay lập tức.

Management Key mới chỉ có thể xóa, không thể thu hồi hay bật lại. Xóa key là cách duy nhất để vô hiệu hóa nó, và các yêu cầu dùng key đã bị xóa sẽ thất bại với 401 invalid_token.

Khuyến nghị bảo mật

• Lưu Management Key trong trình quản lý bí mật hoặc secret của CI, không lưu trong mã nguồn hay tệp cấu hình được commit.
• Tạo Management Key riêng cho từng script hoặc dịch vụ, để có thể xóa một key mà không ảnh hưởng các key khác.
• Đặt thời hạn hết hạn. Key không còn dùng nên bị xóa thay vì để hết hạn.
• Chỉ cấp key cho những hệ thống thực sự quản lý tài khoản của bạn. Ứng dụng gọi mô hình cần API Key sk-, không phải key này.
• Thường xuyên xem lại danh sách Management Keys và xóa những key bạn không còn nhận ra.

Nhầm lẫn thông tin xác thực

Hai loại thông tin xác thực không thể thay thế cho nhau, và mỗi API sẽ từ chối key của API kia bằng 401:

Yêu cầu	Kết quả
API Key sk- gửi tới /api/open/v1	401 invalid_token — đường dẫn cần Management Key
Management Key rat_ gửi tới các endpoint mô hình như /v1/chat/completions	401 lỗi xác thực — đường dẫn cần API Key

Nếu yêu cầu tới một trong hai API trả về 401 dù key trông có vẻ hợp lệ, hãy kiểm tra bạn đã tạo key ở trang nào và nó có tiền tố gì.

Mã lỗi và giới hạn tần suất xem tại Lỗi và giới hạn.