查詢帳單統計

POST/bill/stats

依時間粒度彙總範圍內的模型用量、時間、次數及金額。tokenName 和 modelName 可進一步篩選；無符合記錄時，成功回應的 data 為空陣列。

授權

billingToken

token<token>

帳單身分驗證權杖透過 token Header 傳遞，不加 Bearer 前綴。線上測試填入個人設定生成的系統存取權杖，即可自動取得帳單憑證；程式碼範例提供完整流程。

傳遞位置: header

請求主體

application/json

TypeScript 型別定義

在 TypeScript 中使用 request body 型別。

type*integer

統計或匯出粒度，例如：1=分鐘、2=小時、3=日、4=週、5=月。

startTime*integer

開始時間戳記，單位為秒。範例為北京時間 2026-10-10 00:00:00。

格式int64

endTime*integer

結束時間戳記，單位為秒，不得早於開始。範例為北京時間 2026-10-20 23:59:59。

格式int64

tokenName?string

依 API Key 名稱篩選，不是存取權杖或 API Key 密鑰。省略時不依名稱篩選。

modelName?string

依模型名稱篩選；省略時不依模型篩選。

回應主體

`application/json`

set -euo pipefail

ACCESS_TOKEN='your-user-token'

BILLING_TOKEN=$(curl --fail --silent --show-error "https://api.agtcloud.cn/api/user/self" \
  -H "Authorization: Bearer ${ACCESS_TOKEN}" | \
  jq -er '
    select(.success == true)
    | .data.remark | fromjson | .token
    | select(type == "string" or type == "number")
    | tostring | select(length > 0)
  ')

curl --fail-with-body "https://api.agtcloud.cn/bill/stats" \
  -X POST \
  -H "token: ${BILLING_TOKEN}" \
  -H 'Content-Type: application/json' \
  -d '{
  "type": 3,
  "startTime": 1791561600,
  "endTime": 1792511999
}'

按日統計的回應範例，內容僅供示意。

{
  "message": "SUCCESS",
  "code": 200,
  "data": [
    {
      "siteUrl": null,
      "time": "2026-10-20 00:00:00",
      "timeGroup": 1792425600,
      "userName": "example-user",
      "tokenName": "example-key",
      "modelName": "MODEL_ID",
      "modelLabel": null,
      "providerName": null,
      "channelGroup": null,
      "totalPromptTokens": 8927,
      "totalCompletionTokens": 143,
      "totalCacheTokens": 0,
      "totalCacheCreationTokens": 0,
      "totalCacheCreationHourToken": null,
      "totalImageInput": 0,
      "totalImageOutput": 0,
      "totalAudioInput": 0,
      "totalUseTime": 6,
      "callCount": 1,
      "totalAmount": 0.012588,
      "discount": null,
      "actualAmount": null
    }
  ],
  "timestamp": 1792537200000
}

授權

請求主體

回應主體

200application/json

`application/json`