跳转到主要内容
POST
/
v1
/
tokens
curl --request POST \
  --url 'https://toapis.com/v1/tokens' \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "name": "我的新令牌",
    "expired_time": -1,
    "remain_quota": 500000,
    "unlimited_quota": false
  }'

{
  "success": true,
  "message": "",
  "data": {
    "id": 123,
    "user_id": 456,
    "key": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
    "status": 1,
    "name": "我的新令牌",
    "created_time": 1738483200,
    "accessed_time": 1738483200,
    "expired_time": -1,
    "remain_quota": 500000,
    "unlimited_quota": false,
    "used_quota": 0,
    "model_limits_enabled": false,
    "model_limits": "",
    "group": "",
    "cross_group_retry": false
  }
}
  • 通过 API 创建新的 API 令牌
  • 支持设置令牌名称和过期时间
  • 支持配置额度限制和模型限制
  • 新令牌密钥仅在创建时返回一次
安全提示请妥善保管返回的令牌密钥（key 字段），它仅在创建时显示一次，之后无法再次获取。

​
Authorizations

​
Authorization
string
必填
所有接口均需要使用 Bearer Token 进行认证获取 API Key：访问 API Key 管理页面 获取您的 API Key使用时在请求头中添加：
Authorization: Bearer YOUR_API_KEY

​
Body

​
name
string
必填
令牌名称，最大 50 个字符示例："我的新令牌"
​
expired_time
integer
默认值:"-1"
令牌过期时间（Unix 时间戳，秒级）
  • 设置为 -1 表示永不过期
  • 设置为具体时间戳表示在该时间点后过期
示例：1738483200（2025-02-02 00:00:00 UTC）
​
remain_quota
integer
默认值:"0"
令牌剩余额度（内部单位）换算关系：500000 = $1 USD示例：500000（相当于 $1）
​
unlimited_quota
boolean
默认值:"false"
是否为无限额度
  • true：无限额度，不受额度限制
  • false：有限额度，使用 remain_quota 的值
示例：false
​
model_limits_enabled
boolean
默认值:"false"
是否启用模型限制
  • true：启用模型限制，仅允许使用 model_limits 中指定的模型
  • false：不限制可用模型
示例：false
​
model_limits
string
默认值:""
允许使用的模型列表（逗号分隔）仅当 model_limits_enabled 为 true 时有效示例："gpt-4o,gpt-4o-mini,claude-3-5-sonnet"
​
group
string
默认值:""
令牌分组名称用于指定令牌使用的渠道分组示例："default"

​
Response

​
success
boolean
请求是否成功
​
message
string
错误信息（仅失败时返回）
​
data
object
创建的令牌信息（成功时返回）
curl --request POST \
  --url 'https://toapis.com/v1/tokens' \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "name": "我的新令牌",
    "expired_time": -1,
    "remain_quota": 500000,
    "unlimited_quota": false
  }'

{
  "success": true,
  "message": "",
  "data": {
    "id": 123,
    "user_id": 456,
    "key": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
    "status": 1,
    "name": "我的新令牌",
    "created_time": 1738483200,
    "accessed_time": 1738483200,
    "expired_time": -1,
    "remain_quota": 500000,
    "unlimited_quota": false,
    "used_quota": 0,
    "model_limits_enabled": false,
    "model_limits": "",
    "group": "",
    "cross_group_retry": false
  }
}

​
使用场景

  • 自动化创建多个 API 令牌
  • 为不同应用或服务创建独立的令牌
  • 通过脚本批量管理令牌生命周期
令牌密钥格式创建成功后返回的 key 字段是 48 位随机字符串。使用时需要加上 sk- 前缀，完整格式为 sk-xxxxxxxx...。
最佳实践
  • 为不同用途创建不同的令牌，便于追踪和管理
  • 设置合理的过期时间，定期轮换令牌
  • 如果只需要访问特定模型，启用模型限制可以提高安全性

​
常见错误

错误信息原因解决方案
令牌名称过长名称超过 50 个字符使用较短的令牌名称
生成令牌失败系统内部错误稍后重试或联系支持
身份验证失败API Key 无效或已过期检查 API Key 是否正确
安全提示
  • 创建的令牌密钥仅在响应中返回一次，请立即保存
  • 不要在客户端代码中硬编码 API Key
  • 生产环境请务必使用 HTTPS
  • 建议为每个应用创建独立的令牌，便于管理和撤销