6 个图像模型 · 能力与价格一处查看查看价格 →
API 文档查询用量明细

OGA 开发者中心

API v1 · 最后核对 2026-08-15

查询用量明细

分页查询当前 API Key 的任务用量与结算记录。

GET/api/v1/account/usage
浏览常用接口

接口说明

可按模型、操作、渠道行和状态过滤。公开字段使用 channel_row_id;不要依赖内部父渠道标识。

认证:Bearer API Key

请求

查询参数

名称类型说明
pageinteger页码,从 1 开始。
page_sizeinteger每页 1–100 条,默认 20。
model_idstring模型 ID。
operationgeneration | edit | variation图片操作。
channel_row_idstring公开渠道行 ID。
statusstring用量记录状态。

响应

JSON 接口使用统一响应信封。HTTP 状态表达请求结果,业务错误不会伪装成 HTTP 200。

HTTP含义
200请求成功
400业务参数或过滤条件无效
401缺少或无效的 API Key
403API Key 已禁用或无权访问
422请求结构校验失败
500服务内部错误

完整成功响应示例(可选字段可能因状态不同而变化)

{
  "code": 0,
  "message": "success",
  "data": {
    "summary": {
      "currency": "USD",
      "request_count": 0,
      "success_count": 0,
      "failure_count": 0,
      "completed_image_count": 0,
      "reserved_micro": 0,
      "reserved_usd": "0.000000",
      "charged_micro": 0,
      "charged_usd": "0.000000",
      "refunded_micro": 0,
      "refunded_usd": "0.000000",
      "released_micro": 0,
      "released_usd": "0.000000",
      "net_consumed_micro": 0,
      "net_consumed_usd": "0.000000"
    },
    "items": [],
    "total": 0,
    "page": 1,
    "page_size": 20
  },
  "request_id": "8f25b42f-2ed1-4ad7-99de-61d7f779bc7b",
  "timestamp": "2026-08-10T00:00:00Z"
}

重要边界

  • 此接口按当前 API Key 过滤,不是整个账户的控制台会话视图。

查看机器可读 OpenAPI

代码与在线调试

GET · /api/v1/account/usage

curl -X GET "$OGA_BASE_URL/api/v1/account/usage?page=1&page_size=20" \
  -H "Authorization: Bearer <YOUR_OGA_API_KEY>" \
  -H "X-Request-Id: <UUID_V4>" \
  -H "Accept-Language: zh-CN"