查询上游请求记录¶

查询一次模型调用向上游发出的各次请求及其结果。

GET https://billing.moi.matrixorigin.cn/api/v1/taas/usage-logs/{id}/provider-requests

调用前准备¶

准备个人访问令牌。创建和管理方法参阅创建和管理个人访问令牌。
通过查询请求日志列表选择要查询的调用。

查询范围为当前用户有权访问的数据。

请求示例¶

将示例中的 $MOI_PERSONAL_ACCESS_TOKEN 和 $USAGE_LOG_ID 分别替换为个人访问令牌和所选请求日志的 ID。

curl --get "https://billing.moi.matrixorigin.cn/api/v1/taas/usage-logs/$USAGE_LOG_ID/provider-requests" \
  -H "X-API-Key: $MOI_PERSONAL_ACCESS_TOKEN"

路径参数¶

参数	类型	是否必填	说明
`id`	string	是	所选请求日志的 ID，取自请求日志列表中的 `items[].id`。

成功响应¶

返回 HTTP 200，响应包含所选调用的上游请求尝试列表。

响应示例

[
  {
    "id": "attempt_example",
    "usage_log_id": "usage_example",
    "model_id": "model_example",
    "model_name": "example-chat-model",
    "attempt_number": 1,
    "status": "success",
    "http_status_code": 200,
    "called_at": 1788710400,
    "input_tokens": 12,
    "output_tokens": 8,
    "cache_read_tokens": 0,
    "cache_creation_tokens": 0,
    "latency_ms": 120,
    "created_at": 1788710400
  }
]

字段说明

字段	类型	说明
`[].id`	string	上游请求记录 ID。
`[].usage_log_id`	string	所属请求日志 ID。
`[].model_id`	string	模型目录对象 ID。
`[].model_name`	string	实际调用的模型名称。
`[].attempt_number`	integer	本次调用内的尝试序号。
`[].status`	string	尝试结果状态。
`[].http_status_code`	integer	上游返回的 HTTP 状态码；有值时返回。
`[].retryable`	boolean	此次失败是否可重试；为 `false` 时可省略。
`[].called_at`	integer	调用时间，Unix 秒。
`[].input_tokens`	integer	输入 Token 数。
`[].output_tokens`	integer	输出 Token 数。
`[].cache_read_tokens`	integer	缓存读取 Token 数。
`[].cache_creation_tokens`	integer	缓存写入 Token 数。
`[].error_type`	string	调用错误类别；有错误时返回。
`[].error_message`	string	调用错误说明；有错误时返回。
`[].latency_ms`	integer	调用耗时，毫秒。
`[].created_at`	integer	日志创建时间，Unix 秒。

字段路径中的 [] 表示数组中的每一项。

最后更新于 2026 年 9 月 8 日