청구서 내보내기

POST/bill/excel

시간과 선택적 API Key/모델 이름으로 필터링합니다. 성공 시 Excel, 인증·검증·처리 실패 시 HTTP 200으로 JSON을 반환할 수도 있습니다. Content-Type과 본문을 확인하세요.

인증

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

모델 이름 필터. 생략 시 모델로 필터링하지 않습니다.

응답 본문

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)
  ')

response_file=$(mktemp './.bill_export.XXXXXX')
[[ "$response_file" == ./.bill_export.* && -f "$response_file" && ! -L "$response_file" ]] || exit 1
trap 'if [[ "$response_file" == ./.bill_export.* && -f "$response_file" && ! -L "$response_file" ]]; then rm -f -- "$response_file"; fi' EXIT

response_meta=$(curl --silent --show-error "https://api.agtcloud.cn/bill/excel" \
  -X POST \
  -H "token: ${BILLING_TOKEN}" \
  -H 'Content-Type: application/json' \
  -d '{
  "type": 3,
  "startTime": 1791561600,
  "endTime": 1792511999
}' \
  --output "$response_file" \
  --write-out '%{http_code}\n%{content_type}')

http_status=${response_meta%%$'\n'*}
content_type=${response_meta#*$'\n'}
if [[ "$http_status" != 200 || "${content_type%%;*}" != application/vnd.openxmlformats-officedocument.spreadsheetml.sheet || ! -s "$response_file" ]]; then
  printf 'Export failed: HTTP %s (%s)\n' "$http_status" "$content_type" >&2
  if [[ "${content_type%%;*}" == application/json ]]; then
    jq '{code, message}' "$response_file" >&2
  fi
  exit 1
fi

if [[ -e bill_export.xlsx || -L bill_export.xlsx ]]; then
  printf 'bill_export.xlsx already exists; choose another filename.\n' >&2
  exit 1
fi
mv -n -- "$response_file" bill_export.xlsx
if [[ -e "$response_file" ]]; then
  printf 'bill_export.xlsx already exists; choose another filename.\n' >&2
  exit 1
fi
printf 'Saved bill_export.xlsx\n'

Excel 파일(.xlsx)

.xlsx로 저장하고 JSON으로 파싱하지 마세요. cURL은 --output bill_export.xlsx를 사용할 수 있습니다.

인증

요청 본문

응답 본문

200application/vnd.openxmlformats-officedocument.spreadsheetml.sheet