概覽
這個 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
值為
active、inactive 或 revoked。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 時間戳記。