> For the complete documentation index, see [llms.txt](https://docs.apismart.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.apismart.ai/documentation/zh-tw/api-shi-yong-liang/shi-yong-ji-lu-yu-cheng-ben.md). # 使用記錄與成本 了解如何使用 ApiSmart 使用量記錄來監控 API 請求、消耗、成本、延遲、成功率以及請求層級的詳細資訊。 使用 **使用記錄** 在 ApiSmart 主控台中監控 API 活動、查看請求層級的用量與費用，並排查效能或請求問題。 使用記錄可協助你了解哪些 API 金鑰與模型產生了用量，以及個別請求如何影響你的帳戶餘額。 ### 📊 用量總覽 登入 ApiSmart 主控台，然後前往： **主控台 → 使用記錄**
在頁面頂端，你可以查看四個摘要指標： | 指標 | 說明 | | ------------ | ---------------- | | **總費用（$）** | 所選記錄或期間的 API 總費用 | | **總任務數** | 已記錄的 API 任務數 | | **平均延遲（毫秒）** | 平均請求處理延遲 | | **成功率** | 成功完成的請求百分比 | 這些指標可快速概覽 API 用量、費用與效能。 ### 🔍 篩選使用記錄 使用篩選條件縮小你要查看的記錄範圍。 可用的篩選條件包括： * **日期** — 查看所選日期的記錄 * **API 金鑰名稱** — 篩選使用特定 API 金鑰發出的請求 * **模型類型** — 依模型或工作負載類型篩選 * **模型名稱** — 依特定模型篩選 * **計費模式** — 依套用的計費方式篩選 * **狀態** — 依請求狀態篩選 選取篩選條件後，點擊 **搜尋**. 使用 **重設** 以清除目前的篩選條件並返回預設檢視。 > 主控台可能會暫時顯示 **權杖名稱** ，當產品術語正在更新時。ApiSmart 文件使用 **API 金鑰** 來表示 API 驗證憑證。 ### 📋 了解使用記錄 使用記錄中的每一列都代表一筆已記錄的 API 請求或任務。 表格可能包含以下欄位： | 欄位 | 說明 | | ------------ | --------------- | | **請求 ID** | 該請求的唯一識別碼 | | **時間** | 記錄該請求的時間 | | **API 金鑰名稱** | 與該請求相關聯的 API 金鑰 | | **模型** | 該請求使用的模型 | | **類型** | 請求或工作負載類型 | | **計費模式** | 套用於該請求的計費方式 | | **持續時間（毫秒）** | 請求處理持續時間 | | **用量** | 該請求記錄的用量 | | **結果** | 請求結果資訊 | | **費用** | 該請求收取的金額 | | **狀態** | 請求狀態 | 的確切含義 **用量** 取決於模型與計費模式。不應一律解讀為文字權杖用量。 如需模型特定的計費規則，請參閱 [**模型定價與計費**](/documentation/zh-tw/mo-xing-yu-jia-ge/mo-xing-jia-ge-yu-ji-fei.md). ### 💰 查看請求費用 使用 **費用** 欄位來查看單一請求的收費金額。 該 **總費用（$）** 指標提供目前檢視或所選篩選條件中包含的記錄之 API 費用彙總檢視。 不同模型可能使用不同的計費方式。 例如，計費可能取決於以下因素： * 權杖用量 * 生成圖片數量 * 影片長度 * 生成的影片權杖數 * 解析度 * 模型特定請求參數 如需目前的計費規則，請參閱 [**模型定價與計費**](/documentation/zh-tw/mo-xing-yu-jia-ge/mo-xing-jia-ge-yu-ji-fei.md). ### ⚡ 監控 API 效能 使用記錄也能幫助你監控 API 效能。 #### 平均延遲 **平均延遲（毫秒）** 顯示已記錄請求的平均處理延遲。 個別請求持續時間可在以下欄位中查看： **持續時間（毫秒）** 在調查緩慢請求或比較不同模型之間的 API 效能時，請使用這些資訊。 #### 成功率 **成功率** 顯示成功完成的請求百分比。 如果成功率意外下降，請查看個別記錄，並注意： * 狀態 * 結果 * 模型 * 請求 ID * 請求時間 如需 API 錯誤資訊，請參閱 [**HTTP 狀態碼與 API 錯誤**](/documentation/zh-tw/yi-nan-pai-jie/http-zhuang-tai-ma-yu-api-cuo-wu.md). ### 🧩 依模型與計費模式篩選 該 **模型類型**, **模型名稱**、以及 **計費模式** 篩選條件可幫助你區分不同類型的用量。 例如，你可以用它們來： * 查看特定模型的用量 * 比較不同模型類型的活動 * 調查使用特定計費模式的請求 * 找出哪些工作負載對你的 API 費用貢獻最大 由於文字、圖片和影片模型可能使用不同的計費方式，依模型與計費模式篩選在檢視費用時特別有用。 ### 🔑 依 API 金鑰查看用量 使用 **API 金鑰名稱** 以查看與特定憑證相關聯的活動。 當你為以下用途使用不同的 API 金鑰時，這會很有幫助： * 開發 * 測試 * 正式環境 * 不同應用程式 * 不同後端服務 使用具描述性的 API 金鑰名稱，可讓你更容易在使用記錄中辨識請求活動。 如需 API 金鑰管理，請參閱 [**建立與管理 API 金鑰**](/documentation/zh-tw/huan-ying-shi-yong-apismart/api-jin-yue/jian-li-bing-guan-li-api-jin-yue.md). ### 📤 匯出使用記錄 使用記錄可讓你選取記錄並使用 **匯出所選項目** 來匯出所選資料。 匯出的記錄可用於： * 內部報告 * 費用分析 * 疑難排解 * 用量檢視 * 比較模型或 API 金鑰 如果你只需要特定日期、模型、API 金鑰或狀態的記錄，請先套用篩選條件。 ### 🔎 調查特定請求 排查單一請求時，先從其 **請求 ID**. 查看對應記錄中的以下內容： * 請求時間 * API 金鑰 * 模型 * 類型 * 計費模式 * 持續時間 * 用量 * 結果 * 費用 * 狀態 聯絡 ApiSmart 支援時，請求 ID 也有助於識別該請求。 絕不要將完整 API 金鑰提供給支援人員。 ### ⚠️ 用量或費用異常？ 如果 API 用量或費用高於預期： 1. **依 API 金鑰篩選**\ 找出是哪些憑證產生了這些請求。 2. **檢查模型與計費模式**\ 不同模型可能使用不同的定價方式。 3. **查看用量與費用**\ 比較個別請求，以找出用量增加的地方。 4. **檢查重複請求**\ 重試、重複呼叫或自動化工作流程可能會產生額外用量。 5. **查看請求狀態**\ 使用狀態與結果來調查異常的請求行為。 如果你仍無法說明這些用量，請聯絡 [**ApiSmart 支援**](/documentation/zh-tw/shuo-ming-yu-zi-yuan/lian-luo-zhi-yuan.md) 並附上相關的 **請求 ID**. ### 💳 使用記錄與你的錢包 使用記錄顯示外送 API 活動，而你的錢包則顯示目前可用餘額。 一般流程如下： **錢包餘額 → API 請求 → 記錄用量 → 計算費用 → 扣除餘額** 如需帳戶層級的付款與儲值資訊，請參閱： * [**儲值並了解錢包點數**](/documentation/zh-tw/zhang-hu-yu-qian-bao/jia-zhi-yu-liao-jie-qian-baoedu.md) * [**查看你的餘額與交易紀錄**](/documentation/zh-tw/zhang-hu-yu-qian-bao/cha-kan-nin-de-yueyu-jiao-yi-ji-lu.md) ### ➡️ 下一步 繼續進行： * [**模型定價與計費**](/documentation/zh-tw/mo-xing-yu-jia-ge/mo-xing-jia-ge-yu-ji-fei.md) — 了解模型特定的計費方式 * [**查看你的餘額與交易紀錄**](/documentation/zh-tw/zhang-hu-yu-qian-bao/cha-kan-nin-de-yueyu-jiao-yi-ji-lu.md) — 檢視錢包與付款活動 * [**建立與管理 API 金鑰**](/documentation/zh-tw/huan-ying-shi-yong-apismart/api-jin-yue/jian-li-bing-guan-li-api-jin-yue.md) — 管理 API 憑證 * [**HTTP 狀態碼與 API 錯誤**](/documentation/zh-tw/yi-nan-pai-jie/http-zhuang-tai-ma-yu-api-cuo-wu.md) — 排查 API 失敗