QVeris
运行任务
文档目录

预检能力

POST /tools/probe

预检能力

REST API 概览 · OpenAPI JSON · OpenAPI YAML

接口契约

稳定性认证费用Operation ID
已发布Bearer API 密钥免费probe_tool_api_v1_tools_probe_post

参数

名称位置必填类型说明
tool_idquerystringTool ID to validate

请求体

Schema: PublicToolProbeRequest

名称必填类型说明
parametersobjectCandidate parameters to validate without executing the capability.
checks"schema" | "quote" | "coverage" | "sample"[]
live_budget"none" | "metadata" | "sampled"M1 is zero-cost; every value avoids an upstream tool execution.

可运行示例

bash
curl --request POST \
  --url "https://qveris.ai/api/v1/tools/probe?tool_id=string" \
  --header "Authorization: Bearer $QVERIS_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "parameters": {
    "q": "London"
  },
  "checks": [
    "schema",
    "quote"
  ],
  "live_budget": "none"
}'
typescript
const response = await fetch("https://qveris.ai/api/v1/tools/probe?tool_id=string", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.QVERIS_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
  "parameters": {
    "q": "London"
  },
  "checks": [
    "schema",
    "quote"
  ],
  "live_budget": "none"
}),
})

if (!response.ok) throw new Error(`QVeris request failed: ${response.status}`)
console.log(await response.json())
python
import json
import os
import requests

response = requests.request(
    "POST",
    "https://qveris.ai/api/v1/tools/probe?tool_id=string",
    headers={"Authorization": f"Bearer {os.environ['QVERIS_API_KEY']}"},
    json=json.loads(r'''{
  "parameters": {
    "q": "London"
  },
  "checks": [
    "schema",
    "quote"
  ],
  "live_budget": "none"
}'''),
    timeout=30,
)
response.raise_for_status()
print(response.json())

响应

状态码含义Schema
200Successful ResponsePublicToolProbeResponse
400Invalid probe requestPublicApiError
401UnauthorizedPublicApiError
404Capability not foundPublicApiError
422Validation ErrorHTTPValidationError
429Too Many Requestsunknown
502Upstream unavailablePublicApiError
504Upstream timeoutPublicApiError

成功响应示例

json
{
  "schema": {
    "valid": true
  },
  "quote": {
    "estimate_credits": 5,
    "currency": "credits",
    "exact": true,
    "basis": "per_call"
  }
}

精确契约

相关操作

POST 发现能力 · POST 检查能力 · POST 调用能力

这个页面对你有帮助吗?