Skip to main content
POST
  • 通過 API 創建新的 API 令牌
  • 支持設置令牌名稱和過期時間
  • 支持配置額度限制和模型限制
  • 新令牌密鑰僅在創建時返回一次
安全提示請妥善保管返回的令牌密鑰(key 字段),它僅在創建時顯示一次,之後無法再次獲取。

Authorizations

string
必填
所有接口均需要使用 Bearer Token 進行認證獲取 API Key:訪問 API Key 管理頁面 獲取您的 API Key使用時在請求頭中添加:

Body

string
必填
令牌名稱,最大 50 個字符示例:"我的新令牌"
integer
預設值:"-1"
令牌過期時間(Unix 時間戳,秒級)
  • 設置爲 -1 表示永不過期
  • 設置爲具體時間戳表示在該時間點後過期
示例:1738483200(2025-02-02 00:00:00 UTC)
integer
預設值:"0"
令牌剩餘額度(內部單位)換算關係:500000 = $1 USD示例:500000(相當於 $1)
float
預設值:"0"
令牌剩餘積分。如果傳入該字段,會覆蓋 remain_quota換算關係:200 積分 = $1 USD = 500000 內部額度示例:200(相當於 $1)
float
預設值:"0"
令牌每日限額積分。如果傳入該字段,會自動換算爲 daily_quota示例:100(相當於每日 $0.5 限額)
float
預設值:"0"
令牌每月限額積分。如果傳入該字段,會自動換算爲 monthly_quota示例:1000(相當於每月 $5 限額)
boolean
預設值:"false"
是否爲無限額度
  • true:無限額度,不受額度限制
  • false:有限額度,使用 remain_quota 的值
示例:false
boolean
預設值:"false"
是否啓用模型限制
  • true:啓用模型限制,僅允許使用 model_limits 中指定的模型
  • false:不限制可用模型
示例:false
string
預設值:""
允許使用的模型列表(逗號分隔)僅當 model_limits_enabledtrue 時有效示例:"gpt-4o,gpt-4o-mini,claude-3-5-sonnet"
string
預設值:""
令牌分組名稱用於指定令牌使用的渠道分組示例:"default"

Response

boolean
請求是否成功
string
錯誤信息(僅失敗時返回)
object
創建的令牌信息(成功時返回)

使用場景

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

常見錯誤

安全提示
  • 創建的令牌密鑰僅在響應中返回一次,請立即保存
  • 不要在客戶端代碼中硬編碼 API Key
  • 生產環境請務必使用 HTTPS
  • 建議爲每個應用創建獨立的令牌,便於管理和撤銷