AIin1Portal

列出账单

GET /api/v1/billing/invoices

分页列出组织的账单，按创建时间倒序。

鉴权：本接口属于控制台后端 API（Base URL https://portal.aiin1.ai，注意不是 api.portal.aiin1.ai），需携带控制台账号登录后获取的 access_token（15 分钟有效），不能使用 sk-nex- API 令牌。登录方式见 账单对账与用量自动同步。

请求参数

参数 位置 类型 必填 说明
start query date 否 只返回账期与 [start, end] 有交集的账单
end query date 否 同上
page query integer 否 页码（默认 1）
page_size query integer 否 每页条数（默认 20，最大 100）

请求示例

curl "https://portal.aiin1.ai/api/v1/billing/invoices?start=2026-07-01&end=2026-07-31" \
  -H "Authorization: Bearer $ACCESS_TOKEN"

响应

返回数组，每行一张账单：

字段 类型 说明
id string(uuid) 账单 ID
invoice_no string 账单编号
org_id string(uuid) 组织 ID
period_start / period_end date 账期起止
total string(decimal) 账单金额（USD）
status string 账单状态
due_date date 到期日
created_at string(datetime) 创建时间

相关接口

  • GET /api/v1/billing/invoices/{id} — 账单详情（含明细行）
  • GET /api/v1/billing/invoices/{id}/pdf — 下载账单 PDF
  • GET /api/v1/billing/ledger?page=&page_size= — 账务流水（充值 / 扣费 / 调整）