POST /tools/probe
预检能力
REST API 概览 · OpenAPI JSON · OpenAPI YAML
| 稳定性 | 认证 | 费用 | Operation ID |
|---|---|---|---|
| 已发布 | Bearer API 密钥 | 免费 | probe_tool_api_v1_tools_probe_post |
| 名称 | 位置 | 必填 | 类型 | 说明 |
|---|---|---|---|---|
tool_id | query | 是 | string | Tool ID to validate |
Schema: PublicToolProbeRequest
| 名称 | 必填 | 类型 | 说明 |
|---|---|---|---|
parameters | 否 | object | Candidate 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. |
curl --request POST \
--url "https://qveris.cn/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"
}'
const response = await fetch("https://qveris.cn/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())
import json
import os
import requests
response = requests.request(
"POST",
"https://qveris.cn/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 |
|---|---|---|
200 | Successful Response | PublicToolProbeResponse |
400 | Invalid probe request | PublicApiError |
401 | Unauthorized | PublicApiError |
404 | Capability not found | PublicApiError |
422 | Validation Error | HTTPValidationError |
429 | Too Many Requests | unknown |
502 | Upstream unavailable | PublicApiError |
504 | Upstream timeout | PublicApiError |
{
"schema": {
"valid": true
},
"quote": {
"estimate_credits": 5,
"currency": "credits",
"exact": true,
"basis": "per_call"
}
}
这个页面对你有帮助吗?