청구 통계 조회

시간 단위로 모델 사용량, 호출 수 및 소비 통계를 조회합니다.

POST/bill/stats

시간 단위로 모델 사용량, 시간, 호출 수, 금액을 집계합니다. tokenName/modelName으로 추가 필터링하며 결과가 없으면 성공 응답의 data는 빈 배열입니다.

인증

billingToken

token<token>

청구 인증 토큰을 Bearer 없이 token Header로 전달합니다. Try It에 개인 설정에서 만든 시스템 액세스 토큰을 입력하면 청구 자격 증명을 자동으로 얻습니다. 코드 예제는 전체 과정을 보여줍니다.

전달 위치: 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 이름 필터입니다. 액세스 토큰이나 비밀 키가 아니며 생략 시 이름으로 필터링하지 않습니다.

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`