GeraikitaGeraikita AI
菜单认证

认证

每个请求都使用你以 gk- 开头的 API 密钥进行认证。费用从密钥所属账号的 GeraiPoints 余额中扣除。

发送 API 密钥

通过以下任一请求头发送密钥。两者在所有付费端点上均有效。

请求头格式说明
AuthorizationBearer gk-…OpenAI 格式客户端的默认方式（https://ai.geraikita.com/v1）。
x-api-keygk-…Anthropic 格式客户端的默认方式（https://ai.geraikita.com）。
anthropic-version2023-06-01由 Anthropic SDK 自动发送；直接调用 /v1/messages 时请带上。
HTTP headers
# OpenAI
Authorization: Bearer gk-xxxxxxxx

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

如果未发送密钥、密钥错误或已撤销，服务器返回 401，type 为 authentication_error：

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

创建和撤销密钥

  1. 打开 Dashboard，选择创建 API 密钥。
  2. 起一个能说明用途的名称（例如 laptop-kantor 或 server-produksi），如有需要，选择允许使用的模型。
  3. 复制密钥并妥善保存。要撤销，在密钥列表中点击撤销——使用该密钥的请求会立即被拒绝。
原始密钥仅在创建时显示一次，之后无法再次查看。每个账号最多 20 个有效密钥——撤销旧密钥才能创建新密钥。

将密钥限制到特定模型

每个密钥都可以限制为特定的模型列表（allowlist）。列表为空表示允许所有模型。请求列表之外的模型会返回 403 permission_error，且用该密钥调用 GET /v1/models 只会显示允许的模型。对于分享给应用或团队的密钥，可借此控制成本。

密钥类型

密钥用途Base URL
gk-付费 API——从 GeraiPoints 扣费。在 Dashboard 中创建。https://ai.geraikita.com/v1
gk- (bansos)免费套餐——每日配额，独立端点。见免费套餐（Bansos）。不能用于付费端点，反之亦然。https://ai.geraikita.com/v1/claude
gkr-经销商计划——在Reseller页面管理。—

保护密钥安全

  • 切勿把密钥放在前端代码中（浏览器、移动应用）。请从你自己的服务器调用 API。
  • 把密钥保存在环境变量或密钥管理器中，切勿提交到代码仓库。
  • 每个应用或设备使用一个密钥，便于追踪用量，也能单独撤销某个密钥而不影响其他密钥。
  • 怀疑密钥泄露？立即在 Dashboard 中撤销并创建新密钥。