API 参考

查询工具运行

GET/v1/tool-runs

统一支持 flat 常量按次、input 按输入预计算和 usage 按最终用量。pricing.quote_required 决定是否必须报价，requires_usage 决定是否必须提供费用上限并等待权威最终用量；二者不由 schema_version 推断。metered_pricing 关闭时仅限制需要最终用量的新调用，常量/输入规则若不需要最终用量仍可使用。当前 Key 需具备工具授权，运行身份和结果以原 Key 为界。工具总开关关闭时目录为空；匿名目录不能作为可执行授权。仅列出原 Key 所有的运行，严格按 created_at 降序、id 降序排列；同秒使用 id 稳定破除平局。next_cursor 是不透明二元游标，原样传回，格式错误为 400 invalid_cursor。分页不是时间快照，新增记录若排在当前游标之前须刷新首屏查看。

鉴权与权限

使用当前 GloopAPI Key。模型、功能与权限以当前 Key 的目录及接口说明为准。

Authorization: Bearer $GLOOP_API_KEY

鉴权方案： BearerAuth

请求

查询参数

cursorstring选填
原响应 next_cursor，不可自行构造；无效游标返回 400 invalid_cursor。
limitinteger选填
目录范围 1–100，非法使用 20；运行列表范围 1–100，非法使用 20。

响应与错误

HTTP 200

查询工具运行成功

application/json

类型: object
必填字段: items

itemsarray必填
当前页工具或运行数组。
items 子字段（1）
- []object选填
  [] 子字段（10）
  - idstring必填
    该对象的公开标识符；用于对应详情路径。
  - tool_idstring必填
    当前 Key 可执行目录中的工具 ID。
  - versionstring必填
    契约/能力或工具版本；运行使用目录返回的工具版本。
  - statusstring必填
    submitting/running/submission_unknown/succeeded/failed；submission_unknown 表示提交结果未知，不得换 Idempotency-Key 重发。
  - outputunknown必填
    工具 output_schema 定义的 JSON；过期后不可假定结果仍存在。
  - error_codestring选填
    可用于分支处理的公开错误码。
  - billingobject必填
    独立账务状态，不用生成状态代替。
    
    billing 子字段（7）
    review_requiredboolean选填
    账务证据需人工复核。
    
    reasonstring选填
    不可操作或账务复核的公开理由。
    
    usageunknown选填
    由所选工具的 schema 或协议定义的 JSON 值；不假定固定字段。
    
    breakdownunknown选填
    由所选工具的 schema 或协议定义的 JSON 值；不假定固定字段。
    
    statusstring必填
    对象当前状态；必须与账务和保存阶段分别判断。
    
    reserved_usdstring必填
    最大预留美元金额字符串。
    
    charged_usdstring必填
    当前确认收取美元金额字符串。
    
    allOf 分支 1
    类型: object
    分支必填： status, reserved_usd, charged_usd
    review_requiredboolean选填
    账务证据需人工复核。
    
    reasonstring选填
    不可操作或账务复核的公开理由。
    
    usageunknown选填
    由所选工具的 schema 或协议定义的 JSON 值；不假定固定字段。
    
    breakdownunknown选填
    由所选工具的 schema 或协议定义的 JSON 值；不假定固定字段。
    
    statusstring必填
    对象当前状态；必须与账务和保存阶段分别判断。
    
    reserved_usdstring必填
    最大预留美元金额字符串。
    
    charged_usdstring必填
    当前确认收取美元金额字符串。
  - result_expiredboolean必填
    结果是否已过期；账务/幂等记录仍保留。
  - created_atinteger必填
    Unix 秒创建时间。
  - updated_atinteger必填
    Unix 秒最后更新时间。
next_cursorstring选填
严格不透明的 created_at/id 二元游标，必须原样传回；格式错误返回 400 invalid_cursor，缺失或空值表示末页。

HTTP 400

请求字段或参数无效。

application/json

类型: object
必填字段: error

errorobject必填
error 子字段（4）
- codestring选填
- messagestring选填
- typestring选填
- request_idstring选填

HTTP 401

Key 缺失、无效、过期或已撤销。

application/json

类型: object
必填字段: error

errorobject必填
error 子字段（4）
- codestring选填
- messagestring选填
- typestring选填
- request_idstring选填

HTTP 403

IP、账户、模型或工具权限不足。

application/json

类型: object
必填字段: error

errorobject必填
error 子字段（4）
- codestring选填
- messagestring选填
- typestring选填
- request_idstring选填

HTTP 404

对象/能力不可用，或功能开关关闭。

application/json

类型: object
必填字段: error

errorobject必填
error 子字段（4）
- codestring选填
- messagestring选填
- typestring选填
- request_idstring选填

HTTP 409

幂等/报价冲突、对象未准备或仍被引用。

application/json

类型: object
必填字段: error

errorobject必填
error 子字段（4）
- codestring选填
- messagestring选填
- typestring选填
- request_idstring选填

HTTP 429

请求/队列限流。

application/json

类型: object
必填字段: error

errorobject必填
error 子字段（4）
- codestring选填
- messagestring选填
- typestring选填
- request_idstring选填

HTTP 500

鉴权或数据存储内部失败。

application/json

类型: object
必填字段: error

errorobject必填
error 子字段（4）
- codestring选填
- messagestring选填
- typestring选填
- request_idstring选填

HTTP 503

服务、定价或存储不可用。

application/json

类型: object
必填字段: error

errorobject必填
error 子字段（4）
- codestring选填
- messagestring选填
- typestring选填
- request_idstring选填