GeraikitaGeraikita AI
MenuXác thực

Xác thực

Mỗi request được xác thực bằng API key của bạn, bắt đầu bằng gk-. Chi phí được trừ vào số dư GeraiPoints của tài khoản sở hữu key.

Gửi API key

Gửi key qua một trong các header sau. Cả hai đều dùng được ở mọi endpoint trả phí.

HeaderĐịnh dạngGhi chú
AuthorizationBearer gk-…Mặc định của client định dạng OpenAI (https://ai.geraikita.com/v1).
x-api-keygk-…Mặc định của client định dạng Anthropic (https://ai.geraikita.com).
anthropic-version2023-06-01SDK Anthropic tự động gửi; hãy kèm theo khi gọi trực tiếp /v1/messages.
HTTP headers
# OpenAI
Authorization: Bearer gk-xxxxxxxx

# Anthropic
x-api-key: gk-xxxxxxxx
anthropic-version: 2023-06-01

Nếu key không được gửi, sai hoặc đã bị thu hồi, máy chủ trả về 401 với type authentication_error:

401 Unauthorized
{
  "error": {
    "message": "API key tidak valid atau tidak dikenali. Pastikan key gk- kamu benar.",
    "type": "authentication_error",
    "code": null
  }
}

Tạo & thu hồi key

  1. Mở Dashboard rồi chọn Tạo API key.
  2. Đặt tên mô tả mục đích sử dụng (ví dụ laptop-kantor hoặc server-produksi) và, nếu cần, chọn các model được phép dùng.
  3. Sao chép key và lưu ở nơi an toàn. Để thu hồi, nhấn Thu hồi trong danh sách key — request dùng key đó sẽ bị từ chối ngay.
Key gốc chỉ hiển thị một lần khi tạo và không thể xem lại. Tối đa 20 key đang hoạt động mỗi tài khoản — thu hồi key cũ để tạo key mới.

Giới hạn key cho model nhất định

Mỗi key có thể bị giới hạn trong một danh sách model nhất định (allowlist). Danh sách trống nghĩa là mọi model đều được phép. Request tới model ngoài danh sách nhận 403 permission_error, và GET /v1/models với key đó chỉ hiển thị các model được phép. Dùng tính năng này cho key chia sẻ với ứng dụng hoặc nhóm để kiểm soát chi phí.

Các loại key

KeyDùng choBase URL
gk-API trả phí — trừ vào GeraiPoints. Tạo trong Dashboard.https://ai.geraikita.com/v1
gk- (bansos)Gói miễn phí — hạn mức hằng ngày, endpoint riêng. Xem Gói miễn phí (Bansos). Không dùng được ở endpoint trả phí, và ngược lại.https://ai.geraikita.com/v1/claude
gkr-Chương trình reseller — quản lý tại trang Reseller.—

Giữ key an toàn

  • Không đặt key trong mã front-end (trình duyệt, ứng dụng di động). Hãy gọi API từ máy chủ của bạn.
  • Lưu key trong biến môi trường hoặc secret manager, và không bao giờ commit key vào repository.
  • Dùng một key cho mỗi ứng dụng hoặc thiết bị, để dễ theo dõi mức dùng và có thể thu hồi một key mà không ảnh hưởng các key khác.
  • Nghi key bị lộ? Thu hồi ngay trong Dashboard rồi tạo key mới.