跳轉到主要內容

​
概覽

這個 endpoint 會在目前管理令牌所屬的組織下，建立一把新的 type=user API Key。

​
請求主體

欄位型別預設值 / 限制說明
namestring必填，預設 Default Key，長度 1-50顯示名稱，伺服器端會先去除前後空白
limitAmountnumber | null最小 0，最大 100000null 或省略 = 不限額，0 = 無可用額度，正數 = 美元上限
limitCurrencyenum預設 USD可選：USD 或 CNY。當設定為 CNY 時，limitAmount 會按人民幣理解，並在伺服器端依目前匯率換算為 USD 後儲存
modelsstring[]預設 []可選的邏輯模型白名單
expiresAtstring | nullRFC3339 datetimenull 表示沒有到期時間

​
說明

  • 回應中的完整 API Key 只會顯示一次。
  • models: [] 表示這把 Key 除了組織層政策外，沒有額外的模型限制。
  • limitAmount: 0 會建立一把有效、但暫時無法消耗額度的 Key，之後可再更新。
  • 預設情況下，limitAmount 以 USD 解讀。若傳入 limitCurrency: "CNY"，則表示人民幣限額，伺服器會依目前匯率自動換算成 USD 後儲存。
  • 回應會額外返回 exchange_rate，以及人民幣展示欄位 limit_amount_cny、used_amount_cny。

​
範例

curl -X POST "https://api.lemondata.cc/v1/management/api-keys" \
  -H "Authorization: Bearer mt-your-management-token" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Backend Worker",
    "limitAmount": 500,
    "models": ["veo3.1", "sora-2"],
    "expiresAt": "2026-12-31T23:59:59Z"
  }'

​
請求 / 回應

精確 schema 與回應欄位，請使用上方的互動式 OpenAPI 面板。