文档

API 参考

取得工具报价

POST/v1/tools/{id}/quote

统一支持 flat 常量按次、input 按输入预计算和 usage 按最终用量。pricing.quote_required 决定是否必须报价，requires_usage 决定是否必须提供费用上限并等待权威最终用量；二者不由 schema_version 推断。metered_pricing 关闭时仅限制需要最终用量的新调用，常量/输入规则若不需要最终用量仍可使用。当前 Key 需具备工具授权，运行身份和结果以原 Key 为界。工具总开关关闭时目录为空；匿名目录不能作为可执行授权。 路径 id 提供工具身份；公开报价体仅接受必填非空 version 和符合 input_schema 的 input，拒绝 tool_id、quote_id、max_cost_usd 等额外字段。报价有效 300 秒，绑定同 Key、精确版本、规范输入及价格配置；回显 tool_id/version/maximum_usd，不执行任务。

鉴权与权限

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

Authorization: Bearer $GLOOP_API_KEY

鉴权方案： BearerAuth

请求

路径参数

  • idstring必填

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

请求体 · application/json

类型
object
必填字段
versioninput
额外属性
false

请求体必填

  • versionstring必填

    必填非空工具契约版本；使用详情中的精确 version，不默认当前版本。

    最短长度
    1
    匹配规则
    ".*\\S.*"
  • inputunknown必填

    必须通过该工具 version 的 input_schema；只接受规范 JSON，禁止管理员 route_id 等额外字段。

响应与错误

HTTP 200

取得工具报价成功

application/json

类型
object
必填字段
quote_idmaximum_usdprice_versionexpires_atcomponentstool_idversion
  • quote_idstring必填

    报价公开 ID，创建时必须符合价格与请求绑定。

  • maximum_usdstring必填

    本次规范输入的最大美元预留金额。

  • price_versioninteger必填

    销售价格修订版本。

  • expires_atinteger必填

    Unix 秒有效期；工具报价有效 300 秒，以实际 expires_at 为准。

  • componentsunknown必填

    由所选工具的 schema 或协议定义的 JSON 值；不假定固定字段。

  • tool_idstring必填

    本次报价绑定的工具 ID。

  • versionstring必填

    本次报价绑定的精确工具契约版本。

HTTP 400

请求字段或参数无效。

application/json

类型
object
必填字段
error

HTTP 401

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

application/json

类型
object
必填字段
error

HTTP 403

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

application/json

类型
object
必填字段
error

HTTP 404

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

application/json

类型
object
必填字段
error

HTTP 409

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

application/json

类型
object
必填字段
error

HTTP 429

请求/队列限流。

application/json

类型
object
必填字段
error

HTTP 500

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

application/json

类型
object
必填字段
error

HTTP 503

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

application/json

类型
object
必填字段
error