跳轉到主要內容
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_credits": 200,
    "unlimited_quota": false
  }'

{
  "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
  }
}
  • 通過 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）
​
remain_credits
float
預設值:"0"
令牌剩餘積分。如果傳入該字段，會覆蓋 remain_quota換算關係：200 積分 = $1 USD = 500000 內部額度示例：200（相當於 $1）
​
daily_credits
float
預設值:"0"
令牌每日限額積分。如果傳入該字段，會自動換算爲 daily_quota示例：100（相當於每日 $0.5 限額）
​
monthly_credits
float
預設值:"0"
令牌每月限額積分。如果傳入該字段，會自動換算爲 monthly_quota示例：1000（相當於每月 $5 限額）
​
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_credits": 200,
    "unlimited_quota": false
  }'

{
  "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
  }
}

​
使用場景

  • 自動化創建多個 API 令牌
  • 爲不同應用或服務創建獨立的令牌
  • 通過腳本批量管理令牌生命週期
令牌密鑰格式創建成功後返回的 key 字段是 48 位隨機字符串。使用時需要加上 sk- 前綴，完整格式爲 sk-xxxxxxxx...。
最佳實踐
  • 爲不同用途創建不同的令牌，便於追蹤和管理
  • 設置合理的過期時間，定期輪換令牌
  • 如果只需要訪問特定模型，啓用模型限制可以提高安全性

​
常見錯誤

錯誤信息原因解決方案
令牌名稱過長名稱超過 50 個字符使用較短的令牌名稱
生成令牌失敗系統內部錯誤稍後重試或聯繫支持
身份驗證失敗API Key 無效或已過期檢查 API Key 是否正確
安全提示
  • 創建的令牌密鑰僅在響應中返回一次，請立即保存
  • 不要在客戶端代碼中硬編碼 API Key
  • 生產環境請務必使用 HTTPS
  • 建議爲每個應用創建獨立的令牌，便於管理和撤銷