匯出帳單

POST/bill/excel

按時間範圍及選用的 API Key 名稱、模型名稱篩選。成功回傳 Excel；驗證、參數或處理失敗可能以 HTTP 200 回傳 JSON 業務錯誤，請同時檢查 Content-Type 和本文。

授權

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

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

回應主體

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