建立 API Key

使用個人資料頁面生成的存取權杖，不是被管理的模型 API Key。憑證取得與完整流程請參閱以程式管理 API Key。

額度換算為 remain_quota = 金額 * 500000。expired_time=-1 表示永不到期；remain_quota=-1 且 unlimited_quota=true 表示無限額度。

建立功能支援批次建立。本頁請求範例展示單一權杖的欄位設定。

model_limits 是逗號分隔的模型 ID 字串，不是陣列。建立後可依名稱搜尋並讀取設定；回應不保證直接回傳新密鑰。

POST/api/token/

建立 API 權杖，支援批次建立。模型限制、IP 限制、額度及到期時間可分別設定。

授權

userAccessToken

授權Bearer <token>

在個人資料頁面的「安全」區域建立存取權杖，使用 Bearer 驗證，勿填模型 API Key。

傳遞位置: header

請求主體

application/json

TypeScript 型別定義

在 TypeScript 中使用 request body 型別。

name?string

權杖名稱。

expired_time?integer

秒級 Unix 到期時間，-1 表示永不到期。

remain_quota?integer

剩餘額度。remain_quota = 金額 * 500000；-1 且 unlimited_quota=true 表示無限額度。

unlimited_quota?boolean

是否無限額度。

model_limits_enabled?boolean

是否啟用模型限制。

model_limits?string

允許模型 ID，以逗號分隔；不要傳入陣列。

allow_ips?string

允許的 IP 位址，以逗號分隔。

group?string

所屬群組。

回應主體

`application/json`

curl -X POST "https://example.com/api/token/" \
  -H "Authorization: Bearer your-user-token" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "My API Token",
    "expired_time": -1,
    "remain_quota": 1000000,
    "unlimited_quota": false,
    "model_limits_enabled": true,
    "model_limits": "MODEL_ID",
    "allow_ips": "192.168.1.1,10.0.0.1",
    "group": "default"
  }'

{
  "success": true,
  "message": ""
}

授權

請求主體

回應主體

200application/json

401application/json

`application/json`

`application/json`