Tạo khóa API

Các yêu cầu API được xác thực bằng khóa API GetRouter. Hãy tạo khóa riêng cho từng ứng dụng hoặc công cụ để có thể theo dõi mức sử dụng và thu hồi quyền truy cập độc lập.

Tạo khóa

  1. Đăng nhập vào GetRouter.
  2. Mở trang Khóa API.
  3. Chọn Tạo khóa API.
  4. Nhập tên giúp nhận biết ứng dụng, chẳng hạn Codex, OpenClaw hoặc Development.
  5. Nếu cần, hãy đặt thời gian hết hạn, giới hạn sử dụng hoặc giới hạn mô hình.
  6. Tạo khóa rồi sao chép và lưu khóa ở nơi an toàn.

Ví dụ về quy ước đặt tên:

Development
Production API
Codex Laptop
OpenClaw Agent

Xác thực yêu cầu

Gửi khóa dưới dạng token Bearer:

curl https://getrouter.ai/v1/models \
  -H "Authorization: Bearer YOUR_API_KEY"

Không thêm dấu ngoặc kép quanh giá trị khóa thực tế trong trường khóa API của công cụ, trừ khi công cụ yêu cầu rõ ràng.

Lưu trữ khóa an toàn

Khi phát triển cục bộ, hãy đặt khóa trong biến môi trường:

export GETROUTER_API_KEY="YOUR_API_KEY"

Sau đó tham chiếu biến từ ứng dụng:

import os

api_key = os.environ["GETROUTER_API_KEY"]
Danger

Tuyệt đối không đưa khóa API vào lịch sử Git, để lộ khóa trong mã chạy phía trình duyệt hoặc dán khóa vào báo cáo lỗi công khai. Nếu khóa bị lộ, hãy xóa ngay và tạo khóa thay thế.

Dùng khóa riêng biệt

Việc dùng khóa riêng giúp bạn dễ dàng:

  • Thu hồi quyền của một công cụ mà không làm gián đoạn các ứng dụng khác
  • Đặt giới hạn sử dụng khác nhau
  • Giới hạn khóa ở những mô hình cần thiết
  • Xác định mức sử dụng bất thường

Bước tiếp theo