OpenAI 兼容 API 手册

后台用量日志

后台全局用量日志检索对齐 NewAPI 运营视图：支持状态、Provider、模型、分组、用户、Token、时间窗口和 CSV 导出。默认脱敏用户、Token 和 upstreamId；敏感视图必须传 sensitive=1 并具备 log.sensitive_write。响应会附带 adminInfo.billingAnomalies，用于快速排查成功零扣费、失败扣费、Token 用量无扣费、流式断连和流读取错误等异常。

创建 API Key 返回中文文档

GET /api/admin/usage-logs

Admin

curl "https://api09.com/api/admin/usage-logs?status=SUCCESS&model=gpt-5&take=50" \
  -H "Cookie: api09_session=..."

curl "https://api09.com/api/admin/usage-logs?format=csv&sensitive=1" \
  -H "Cookie: api09_session=..."

请求字段

字段	类型	说明
session	cookie	具备 log.read 的后台会话；sensitive=1 需要 log.sensitive_write。
q	query	按日志 ID、端点、Provider、模型、错误、上游 ID、用户或 Token 名称搜索；默认精确匹配，显式 % 才启用通配。
status / provider / model / endpoint / group	query	按状态、供应商、模型、端点和用户分组过滤。
userId / apiKeyId	query	按用户或 Token 精确过滤。
start / end	query	ISO datetime 时间窗口。
format=csv	query	导出 CSV，最大返回 5000 条。
sensitive=1	query	显示用户、Token、upstreamId 等敏感字段，需要 log.sensitive_write。

响应与计费

字段	类型	说明
data.logs[]	array	按时间倒序返回用量日志，默认脱敏 userId、apiKeyId、upstreamId、用户邮箱和 Token 名称。
data.summary.creditsCharged	number	当前筛选条件下的扣费积分合计。
data.summary.promptTokens / completionTokens	number	输入/输出 Token 汇总。
data.summary.billingAnomalyCount	number	当前页日志命中的扣费异常数量。
data.summary.billingAnomalies	array	按 success_zero_charge、error_charged、pending_charged、token_usage_without_charge、client_aborted_stream、stream_error 等类型聚合。
data.logs[].adminInfo.billingAnomalies	array	单条日志的扣费异常标签；不包含原始 Key、用户密钥或上游密钥。
CSV billingAnomalies	column	CSV 导出包含同名列，多个异常以 \| 分隔。
audit	side effect	每次检索写 ADMIN_USAGE_SEARCH，记录筛选条件、是否导出、是否敏感视图和结果数量。

积分统一换算：1 USD = 200 积分。

生产检查

默认列表和 CSV 必须脱敏

敏感视图必须要求 log.sensitive_write

筛选默认精确匹配，避免后台模糊查询拖垮数据库

扣费异常要能在后台 UI 和 API 中同时看到

后台运营审计日志