API 参考

取得工具运行

GET/v1/tool-runs/{id}

统一支持 flat 常量按次、input 按输入预计算和 usage 按最终用量。pricing.quote_required 决定是否必须报价，requires_usage 决定是否必须提供费用上限并等待权威最终用量；二者不由 schema_version 推断。metered_pricing 关闭时仅限制需要最终用量的新调用，常量/输入规则若不需要最终用量仍可使用。当前 Key 需具备工具授权，运行身份和结果以原 Key 为界。工具总开关关闭时目录为空；匿名目录不能作为可执行授权。

鉴权与权限

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

Authorization: Bearer $GLOOP_API_KEY

鉴权方案： BearerAuth

请求

路径参数

idstring必填
目录工具 ID 或原工具运行 ID，取当前操作对象。

响应与错误

HTTP 200

取得工具运行成功

application/json

类型: object
必填字段: idtool_idversionstatusoutputbillingresult_expiredcreated_atupdated_at

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 秒最后更新时间。

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选填