此頁面由機器翻譯。查看原始英文文章。

查看 API 使用情況與費用

在「分析」中查看 API 活動,檢查 API 回應中的 Token 數,並瞭解專案篩選條件、匯出功能及規模層級費用。

更新日期:5 days ago

總覽

你可以透過兩種方式查看 API 用量:

  • 使用分析 > 用量,查看目前及過去報表期間的 API 活動。

  • 讀取 API 回應中的用量資訊,以檢查個別請求。

Playground 使用的 API 呼叫與你的應用程式相同。其中使用的 Token 會計入帳戶的 API 用量,並適用相同的使用規則與定價。

儀表板存取權

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

在儀表板中查看用量

在 API 平台中,開啟分析並選取用量,即可查看目前專案的用量。若要查看整個組織的報表,請選取組織分析。選取你要查看的報表期間,並在切換專案分析與組織分析後再次確認。

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

近期用量可能需要一些時間才會顯示在儀表板中。如果未顯示近期活動,請稍後再查看。

篩選用量

在專案的分析中,用量僅涵蓋所選專案。在組織分析中,使用專案選取你要查看的專案。所有專案涵蓋組織中的每個專案,但仍會套用你選取的其他篩選條件。

使用篩選條件,依 API 來源、API 金鑰、模型、使用者或處理層級縮小用量範圍。在 API 來源中,你可以選取所有 API 來源、Agents API或直接 API。

移除個別選取項目,或選取清除篩選條件以重設篩選條件面板。清除篩選條件不會切換專案分析與組織分析。

使用用量圖表上的篩選,依批次篩選資料。選取重設圖表篩選條件,即可重設該圖表的篩選條件。

如果某項功能不支援所選篩選條件,其數值可能無法顯示。數值無法顯示並不代表用量為零。

如果篩選條件顯示權限錯誤,你可能沒有存取其選項的權限。這並不代表未記錄任何用量。

查看個別使用者的用量

  1. 在你要查看的專案或組織分析檢視畫面中,開啟用量。在 API 功能表格中,選取 Responses 與 Chat Completions的檢視。

  2. 在篩選條件中,選取使用者,再選取該使用者。結果會立即更新。

  3. 查看該使用者的圖表與表格。

若要查看某位使用者在各項功能中的用量,請在用量總覽中套用使用者篩選條件。若要比較使用者,請清除該篩選條件,並選取表格中的使用者分頁。

查看每天、每小時或每分鐘的 Token 數

如果用量中提供時間間隔控制項,可選取 1 天或 1 小時,按天或小時查看 Token 數,或選取 1 分鐘查看每分鐘 Token 數 (TPM)。選取自動,讓儀表板依報表期間選擇時間間隔。這些時間間隔適用於用量資料,不適用於帳單資料。

如果 1 分鐘選項停用,請選取較短的報表期間,或使用選取範圍以縮放,在圖表上拖曳以縮小範圍。然後選取 1 分鐘。按下 Esc 取消縮放範圍的選取。選取分析工具列中目前的日期範圍,即可選擇不同的報表期間。

查看用量圖表與表格

使用指標選取一或多個資料序列,一起顯示,包括輸入 Token、未快取的輸入 Token、已快取的輸入 Token、寫入快取的輸入 Token、輸入音訊 Token、輸出 Token及輸出音訊 Token。可用指標依功能而異。使用圖例辨識各個資料序列。

使用分組依據,依專案、使用者或模型等可用類別整理用量。篩選條件決定納入哪些用量;分組則決定用量的顯示方式。切換折線圖與長條圖,以查看趨勢或比較類別。

使用用量表格的分頁,查看可用的分類明細。表格會顯示各列的相關數值,例如請求數、輸入與輸出 Token 數,或特定功能的計量單位。

在 API 功能中,選取某項功能的檢視,開啟其詳細圖表與分類明細。Responses 與 Chat Completions包含各自獨立的 Token 和請求圖表,以及模型請求數指標。其分類明細分頁採用與總覽相同的維度,但不包含 API 功能分頁。使用麵包屑導覽中的用量返回總覽。

選取分組依據選項後,圖表可能會將其餘類別合併至其他。如果圖表圖例中出現其他,請選取該標籤,查看其中包含的類別及其用量數值。

選取比較儀表板,即可並排查看同一報表期間的用量與另一個儀表板。使用左側儀表板和右側儀表板選取要顯示的檢視畫面。如果選取的時間間隔不適用於這組儀表板,檢視畫面會切換為自動。選取結束比較以返回儀表板。

調查來源不明的用量

如果用量顯示的活動無法對應到應用程式記錄中的請求,請進行以下檢查:

  1. 確認組織、專案範圍及報表期間。將儀表板時間戳記與應用程式記錄比對時,請使用 UTC。

  2. 使用相關專案的專案檢視畫面,或在組織分析的專案中選取該專案。接著使用篩選條件,依 API 金鑰和模型縮小用量範圍,並選取較短的報表期間。

  3. 將活動與相同期間、專案及 API 金鑰的記錄進行比對。檢查記錄是否涵蓋所有使用該金鑰的應用程式或整合。

  4. 如果多個應用程式或整合共用同一個專案或 API 金鑰,僅憑總用量可能無法判斷是哪一個送出了請求。將儀表板與各應用程式在相同 UTC 期間內的記錄進行比對。

  5. 如果仍無法釐清用量來源,請聯絡 OpenAI 支援團隊,並提供相關的 UTC 期間、組織與專案 ID、API 金鑰識別碼,以及相關螢幕截圖或記錄。如有請求 ID,也請一併提供。請勿提供機密 API 金鑰。

匯出用量資料

若要匯出用量,請選取分析工具列中的匯出 CSV圖示,再選取活動資料。

  1. 選取 API 功能及一或多個分組依據維度。

  2. 檢查 API 來源、專案、使用者、API 金鑰及模型。專案和 API 來源會沿用分析中的選取設定;請在對話方塊中選取其他匯出篩選條件。

  3. 選取檔案格式、開始時間、結束時間及時間間隔,然後選取下載。日期範圍包含所選日期的完整 UTC 日。

你可以查看及匯出從一年前同一天的 UTC 00:00 起至今天的活動與費用資料。如需更早的資料,請聯絡 OpenAI 支援團隊。每日資料會以每 31 天一個檔案的方式匯出。

如需每月發票對帳及明細項目匯出資訊,請參閱:匯出每月用量明細。

如果匯出的活動資料包含負值資料列,請比對單位、分組及日期相同的資料列。請使用費用資料查看計費金額。僅憑一筆負值活動資料,無法確定發票金額已獲折抵。

查看支出

開啟分析並選取支出,即可查看目前專案的費用。若要查看整個組織的費用,請選取組織分析,再選取支出。

比較費用與用量前,請先檢查目前的日期範圍及篩選條件。用量與支出提供的篩選條件不同;一個儀表板中的篩選條件不一定適用於另一個儀表板。

使用 API 來源、API 金鑰、模型及明細項目縮小支出範圍。在組織分析中,使用專案納入你要查看的專案。使用表格中的明細項目、API 金鑰、使用者、專案及模型分頁,查看可用的分類明細。

支出上限數值無法顯示,並不代表你的上限為零,也不代表已套用新的上限。存取權限、尚未設定上限或請求失敗,都可能導致儀表板無法顯示數值。

查看服務健康狀態

如果你的組織有權存取服務健康狀態,請在分析中開啟該儀表板,查看 API 效能。如需使用資格及指標定義,請參閱:排解 API 錯誤與延遲問題。

查看獲贈點數

你可以在組織的帳單頁面查看獲贈點數明細。

獲贈點數與 API 用量提供不同資訊:獲贈點數顯示與組織關聯的點數,用量則顯示組織的 API 活動。

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

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

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

用量大於零,但專案支出為零

檢查模型用量是否由你的規模層級配額涵蓋。如果該模型的所有用量都在規模層級 TPM 配額內,專案可能會顯示有用量,卻沒有額外的模型支出。

規模層級訂閱費用仍計入組織層級。請查看整個組織的支出,而非僅依據個別專案的支出。

查看多個組織的資料

用量儀表板不會合併不同組織的費用或用量資料。每個組織(包括子組織)都會分開處理。

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

如果需要合併報表,可考慮在同一組織內使用專案,而非建立獨立的子組織,或使用 Usage API 進行自訂分析。

檢查 API 回應中的 Token 用量

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

Token 數Chat CompletionsResponses
輸入 Tokenusage.prompt_tokensusage.input_tokens
輸出 Tokenusage.completion_tokensusage.output_tokens
Token 總數usage.total_tokensusage.total_tokens

Chat Completions 回應可能包含 Token 用量資訊。範例如下:

{
"usage": {
"prompt_tokens": 13,
"completion_tokens": 7,
"total_tokens": 20
}
}

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

如需瞭解不同的 Token 類別,請參閱:認識與計算 Token。

如果轉錄回應有回報 Token 用量,音訊和文字輸入 Token 已計入 input_tokens。請勿將這些項目重複加到輸入總量中。請另外比較 output_tokens。

取得 Chat Completions 串流回應的用量

在 Chat Completions 串流請求中,加入以下設定:

{
"stream": true,
"stream_options": {
"include_usage": true
}
}

啟用 include_usage 後,系統會在 data: [DONE] 之前額外傳送一個資料區塊,其中包含整個請求的用量。該區塊的 choices 陣列為空。其他區塊的 usage 值為 null。

如果串流中斷,你可能無法收到最後的用量區塊。未收到最後的區塊,並不代表該請求未使用任何 Token。

這項設定僅適用於 Chat Completions。詳情請參閱:Chat Completions API 參考文件。

這篇文章有幫助嗎?