Skip to main content
POST https://geekapis.com/v1/tokens 接口允许您以编程方式创建新的 API 令牌。支持设置令牌名称、过期时间、额度限制（包括每日/每月上限）以及可访问的模型范围。令牌密钥（key）仅在创建时返回一次，请务必立即保存。

​
鉴权

​
Authorization
string
required
Bearer Token 认证。在请求头中添加：
Authorization: Bearer YOUR_API_KEY
前往 API Key 管理页面 获取您的 API Key。

​
请求参数

​
name
string
required
令牌名称，最大 50 个字符。示例："我的新令牌"
​
expired_time
integer
default:"-1"
令牌过期时间（Unix 时间戳，秒级）。
  • -1：永不过期
  • 正整数：在该时间戳对应的时刻过期
示例：1738483200（2025-02-02 00:00:00 UTC）
​
remain_quota
integer
default:"0"
令牌剩余额度（内部单位）。换算关系：500000 = $1 USD。示例：500000（相当于 $1）
​
remain_credits
float
default:"0"
令牌剩余积分。若传入此字段，将覆盖 remain_quota。换算关系：200 积分 = $1 USD = 500000 内部额度。示例：200（相当于 $1）
​
daily_credits
float
default:"0"
令牌每日限额积分，自动换算为 daily_quota。示例：100（相当于每日 $0.5 限额）
​
monthly_credits
float
default:"0"
令牌每月限额积分，自动换算为 monthly_quota。示例：1000（相当于每月 $5 限额）
​
unlimited_quota
boolean
default:"false"
是否为无限额度令牌。
  • true：不受额度限制，可无限使用
  • false：使用 remain_quota / remain_credits 的值
​
model_limits_enabled
boolean
default:"false"
是否启用模型访问限制。
  • true：仅允许访问 model_limits 中指定的模型
  • false：不限制可用模型
​
model_limits
string
允许使用的模型列表，以英文逗号分隔。仅当 model_limits_enabled 为 true 时有效。示例："gpt-5.4,gpt-5.5,claude-sonnet-4-6"
​
group
string
令牌分组名称，用于指定该令牌所使用的渠道分组。示例："default"

​
响应字段

​
success
boolean
请求是否成功。
​
message
string
错误信息，仅在请求失败时返回。
​
credits_per_usd
float
积分换算比例，当前固定为 200（200 积分 = $1 USD）。
​
data
object
创建成功的令牌详情，仅在 success 为 true 时返回。

​
代码示例

curl --request POST \
  --url 'https://geekapis.com/v1/tokens' \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "name": "我的新令牌",
    "expired_time": -1,
    "remain_credits": 200,
    "unlimited_quota": false
  }'

​
响应示例

200 - 创建成功
{
  "success": true,
  "message": "",
  "credits_per_usd": 200,
  "data": {
    "id": 123,
    "user_id": 456,
    "key": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
    "status": 1,
    "name": "我的新令牌",
    "created_time": 1738483200,
    "accessed_time": 1738483200,
    "expired_time": -1,
    "remain_quota": 500000,
    "remain_credits": 200,
    "unlimited_quota": false,
    "used_quota": 0,
    "used_credits": 0,
    "daily_credits": 0,
    "monthly_credits": 0,
    "model_limits_enabled": false,
    "model_limits": "",
    "group": "",
    "cross_group_retry": false
  }
}
密钥仅返回一次 — 响应中的 key 字段在此后的任何接口中均不再返回。请在收到响应后立即保存，使用时在前面加上 sk- 前缀，完整格式为 sk-xxxxxxxx...。

​
错误码

HTTP 状态码错误信息原因解决方案
200令牌名称过长名称超过 50 个字符使用 50 字符以内的令牌名称
200生成令牌失败系统内部错误稍后重试，或联系技术支持
401身份验证失败API Key 无效或已过期检查 Authorization 头中的 API Key 是否正确
429请求过于频繁触发限流降低请求频率后重试
最佳实践
  • 为不同的应用或服务创建独立令牌，便于追踪用量和独立撤销。
  • 生产环境建议设置合理的 expired_time，并定期轮换令牌。
  • 若只需访问特定模型，启用 model_limits_enabled 可以提高安全性。
  • 不要在客户端代码中硬编码 API Key，请使用环境变量管理密钥。