概覽

您可以透過兩種方式查看 API 使用情況：

• 使用使用情況儀表板查看目前及過往帳單週期內的活動。

• 查看 API 回應中的使用情況資訊，以檢查個別請求。

Playground 使用的 API 呼叫與您的應用程式相同。其 Token 會計入您帳戶的 API 使用量，並遵循相同的使用規則與定價。

儀表板存取權

您必須是組織擁有者，或具備使用情況儀表板權限，才能存取使用情況儀表板。

在儀表板中查看使用情況

開啟使用情況儀表板，選取您要查看的組織，然後選擇相關的報告期間。

儀表板資料以 UTC 顯示。比較儀表板活動與應用程式記錄時，請留意此時區。

選取專案

儀表板有自己的專案選取器。其運作不受 API 平台其他位置所選專案的影響。

使用儀表板的選取器查看單一、多個或所有專案。若要查看整個組織的資料，請清除已選取的專案。未選取任何專案時，儀表板會顯示所有專案的資料。

查看個別使用者的使用情況

若要查看某位使用者的 Responses 與 Chat Completions 使用情況：

1. 在使用情況儀表板中，前往API 功能 > Responses 和 Chat Completions。

2. 選取篩選依據。

3. 在使用者下選取該使用者，然後選取套用篩選條件。

查看每分鐘 Token 數

使用情況詳細資料頁面支援選取時間間隔。選取 1 分鐘間隔，以查看每分鐘 Token 數（TPM）。

此時間間隔適用於使用情況資料，而非帳單資料。

匯出使用情況資料

匯出的日期範圍沒有上限。涵蓋較長期間的匯出資料可能會拆分成多個檔案。

如需每月發票核對及明細項目匯出，請參閱：匯出每月使用情況詳細資料。

查看點數補助

您可以在組織的帳單頁面查看點數補助的詳細資料。

點數補助與 API 使用情況分別回答不同問題：點數補助顯示與組織相關聯的點數，而使用情況則顯示該組織的 API 活動。

查看規模層級的使用量與費用

如果您的組織已啟用規模層級，且您具備必要的存取權，請開啟規模層級使用情況頁面查看詳細使用情況。

規模層級方案的費用會歸於組織，而非個別專案。

使用量大於零，但專案支出為零

請確認該模型的使用量是否涵蓋在您的規模層級配額內。如果該模型的所有使用量都在規模層級的 TPM 配額內，專案可能會顯示使用量，但不會產生額外的模型支出。

規模層級的訂閱費用仍會歸於組織層級。若要查看該費用：

1. 清除使用情況儀表板中的專案篩選條件。

2. 選取支出類別。

查看多個組織

使用情況儀表板不會合併不同組織的費用或使用情況資料。每個組織（包括子組織）都會分開處理。

若要查看子組織，請在組織選取器中選取該子組織。

如果需要合併報告，可考慮在單一組織內使用專案，而不要建立不同的子組織；也可以使用使用情況 API進行自訂分析。

檢查 API 回應中的 Token 使用量

Token 使用量的欄位名稱因端點而異。

例如，Chat Completions 回應可能包含：

視端點和模型而定，使用情況詳細資料也可能包含快取輸入和推理 Token 的數量。這些資料有助於說明，為何回應的可見長度無法反映其完整的 Token 使用量。

如需各種 Token 類別的說明，請參閱：瞭解及計算 Token。

取得串流 Chat Completions 的使用情況

對於串流 Chat Completions 請求，請加入：

啟用 include_usage 後，data: [DONE] 之前會多出一個區塊，其中包含整個請求的使用情況。其 choices 陣列為空。其他區塊的 usage 值為 null。

如果串流中斷，您可能不會收到最後的使用情況區塊。未收到最後一個區塊不代表該請求未使用任何 Token。

此設定僅適用於 Chat Completions。如需詳細資訊，請參閱 Chat Completions API 參考資料。