查詢帳戶日誌

GET /api/open/v1/logs

請求參數

參數	位置	類型	必填	預設值	說明
start_timestamp	query	integer	否	見說明	起始時間（含），unix 秒
end_timestamp	query	integer	否	見說明	結束時間（含），unix 秒
model_name	query	string	否	—	依模型名稱精確篩選；多值需重複參數（?model_name=a&model_name=b），也支援逗號分隔
key_name	query	string	否	—	依 Key 名稱精確篩選；多值需重複參數，不支援逗號分隔（名稱本身可能含逗號）
key_id	query	integer	否	—	Key ID，正整數；多值需重複參數或逗號分隔。其他使用者的 Key ID 只會回傳空結果
type	query	integer	否	2	日誌類型：2 消費（計費）請求，7 最終失敗請求（不計費）。多值需重複參數或逗號分隔（?type=2,7）；其他值回傳 400
p	query	integer	否	1	頁碼，取值 1–1000000
page_size	query	integer	否	10	每頁筆數，取值 1–1000

時間範圍規則：

• 兩端都省略：最近 30 天。
• 只傳 start_timestamp：向後 30 天，且不超過目前時間。
• 只傳 end_timestamp：向前 30 天。
• 範圍最長 366 天。

多值參數每個最多 50 個值，超過回傳 400 invalid_request。p / page_size 顯式傳入不合法值回傳 400，詳見 分頁。時間參數必須為非負整數，否則回傳 400。

請求範例

curl "https://www.routeapi.ai/api/open/v1/logs?start_timestamp=1726408000&end_timestamp=1729000000&key_name=bot&model_name=gpt-4o&p=1&page_size=20" \
  -H "Authorization: Bearer $ROUTEAPI_MANAGEMENT_KEY"

回應範例

{
  "success": true,
  "message": "",
  "data": {
    "items": [
      {
        "id": 12345,
        "created_at": 1729000000,
        "type": 2,
        "key_id": 12,
        "key_name": "bot",
        "key": "sk-abcd**********wxyz",
        "model_name": "gpt-4o",
        "prompt_tokens": 1200,
        "completion_tokens": 300,
        "total_tokens": 1500,
        "amount": 0.05,
        "use_time": 3,
        "is_stream": true,
        "first_response_ms": 420,
        "cache_read_tokens": 800,
        "cache_creation_tokens": 0,
        "reasoning_effort": "medium",
        "request_path": "/v1/chat/completions",
        "web_search_calls": 0,
        "audio_input_tokens": 0,
        "audio_output_tokens": 0,
        "billing_source": "wallet",
        "request_id": "20261020120000123456789"
      }
    ],
    "total": 1,
    "page": 1,
    "page_size": 20,
    "start_timestamp": 1726408000,
    "end_timestamp": 1729000000
  }
}

回應欄位

欄位	類型	說明
items[].id	integer	日誌 ID
items[].created_at	integer	記錄時間，unix 秒
items[].type	integer	2 消費，7 最終失敗
items[].key_id	integer	發起請求的 Key ID
items[].key_name	string	請求發生時該 Key 的名稱
items[].key	string	遮罩 Key 值，格式與 列出 API Key 一致，如 sk-abcd**********wxyz；Key 已被永久刪除時為空字串
items[].model_name	string	模型名稱
items[].prompt_tokens	integer	輸入 token 數
items[].completion_tokens	integer	輸出 token 數
items[].total_tokens	integer	輸入與輸出 token 合計
items[].amount	number	本次消耗金額，站點幣別，兩位小數；金額很小時可能為 0.00
items[].use_time	integer	請求耗時，秒
items[].is_stream	boolean	是否為串流請求
items[].first_response_ms	integer	首個回應耗時，毫秒；未知時為 0（如非串流請求）
items[].cache_read_tokens	integer	提示詞快取命中 token 數
items[].cache_creation_tokens	integer	提示詞快取寫入 token 數
items[].reasoning_effort	string	推理強度，如 low / medium / high；未設定時為空字串
items[].request_path	string	請求路徑，如 /v1/chat/completions
items[].web_search_calls	integer	本次請求呼叫的聯網搜尋次數
items[].audio_input_tokens	integer	音訊輸入 token 數
items[].audio_output_tokens	integer	音訊輸出 token 數
items[].billing_source	string	wallet 表示錢包餘額、subscription 表示訂閱方案，未知時為空字串
items[].request_id	string	請求 ID，可用於排查問題
total	integer	符合條件的日誌總數，最多統計到 10000
page	integer	目前頁碼
page_size	integer	實際生效的每頁筆數
start_timestamp	integer	實際生效的起始時間
end_timestamp	integer	實際生效的結束時間

錯誤

HTTP	code	情境
400	invalid_request	時間戳為負數、時間範圍超過 366 天、start_timestamp 大於 end_timestamp、分頁參數不合法、多值參數超過 50 個值、key_id 不是正整數，或 type 不是 2 或 7
429	—	超過按使用者的查詢頻率限制（預設 30 次/分鐘），回應主體可能為空

其他通用錯誤碼見 開放平台 API 錯誤。

說明

• 預設只回傳消費（計費）日誌；需要同時包含最終失敗請求（不計費）時傳 type=2,7。
• 結果按記錄時間倒序（created_at 降序）；同一秒的紀錄按日誌 ID 倒序，分頁順序穩定。
• key_name 是請求發生時 Key 的名稱；改名不會回溯改寫歷史記錄。
• key 是遮罩值；Key 被永久刪除後為空字串。
• use_time、first_response_ms、快取、搜尋、音訊與推理強度等欄位在未記錄對應資料時為 0 或空字串；欄位本身始終存在。
• token 數為原始計數，不是百萬單位。
• 金額使用站點顯示幣別，見 查詢餘額。
• 本介面與 匯出日誌、用量統計、按模型統計、按 Key 統計 共用按使用者的查詢頻率限制（預設 30 次/分鐘），見 頻率限制。
• 需要一次匯出全部符合條件的記錄（CSV 或 JSONL）時，請用 匯出日誌，不要分頁取得再自行拼接。