Skip to main content

概覽

這個 endpoint 可更新既有 API Key 的名稱、額度、模型白名單、過期時間或狀態。

請求主體

PATCH 請求至少需要提供一個欄位。

說明

  • 金額欄位僅支援 USD。CNY 輸入已停用,並會回傳 400 currency_retired
  • Management API v1 故意不支援硬刪除。
  • revoked 通常視為終態;若需要重新使用,通常建議直接建立一把新的 Key。

範例

請求 / 回應

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

回應範例

重要欄位

string
用於後續管理 API 呼叫的 API Key 識別碼。
string
API Key 的顯示名稱。
string
用於顯示和支援排查的非敏感 Key 前綴。
string
值為 activeinactiverevoked
number | null
以 JSON 數字回傳的 USD 消費上限,供顯示使用。null 表示不設限。
string | null
以十進位字串回傳的 USD 精確消費上限。null 表示不設限。
number
以 JSON 數字回傳的 USD 累計用量支出,供顯示使用。
string
以十進位字串回傳的 USD 精確累計用量支出。
string[]
單一 Key 的模型白名單。空陣列表示沒有額外的 Key 層級模型限制。
string | null
Key 到期時間的 ISO 時間戳記;null 表示永不到期。
string | null
最近一次使用的 ISO 時間戳記;從未使用時為 null
string
建立時間的 ISO 時間戳記。