查询 Capability 数据
POST /capabilities/query
查询 Capability 数据
REST API 概览 · OpenAPI JSON · OpenAPI YAML
接口契约
| 稳定性 | 认证 | 费用 | Operation ID |
|---|---|---|---|
| 已发布 | Bearer API 密钥 | 取决于所选能力的 billing_rule | capabilities_query_api_v1_capabilities_query_post |
参数
此操作没有路径或查询参数。
请求体
Schema: PublicCapabilityQueryRequest
至少满足一组必填字段:capability_id 或 query。
| 名称 | 必填 | 类型 | 说明 |
|---|---|---|---|
capability_id | 条件必填 | string | — |
query | 条件必填 | string | — |
parameters | 否 | object | — |
params | 否 | object | — |
session_id | 否 | string | null | — |
search_id | 否 | string | null | — |
run_id | 否 | string | — |
provider_id | 否 | string | — |
provider_ids | 否 | string[] | — |
max_response_size | 否 | integer | — |
max_credits | 否 | number | Maximum credits allowed for this execution. Candidates without a provable upper bound are excluded. |
可运行示例
curl --request POST \
--url "https://qveris.ai/api/v1/capabilities/query" \
--header "Authorization: Bearer $QVERIS_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"capability_id": "MKT.BARS.EOD",
"parameters": {
"symbol": "AAPL"
},
"max_credits": 3.5
}'
const response = await fetch("https://qveris.ai/api/v1/capabilities/query", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.QVERIS_API_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
"capability_id": "MKT.BARS.EOD",
"parameters": {
"symbol": "AAPL"
},
"max_credits": 3.5
}),
})
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.ai/api/v1/capabilities/query",
headers={"Authorization": f"Bearer {os.environ['QVERIS_API_KEY']}"},
json=json.loads(r'''{
"capability_id": "MKT.BARS.EOD",
"parameters": {
"symbol": "AAPL"
},
"max_credits": 3.5
}'''),
timeout=30,
)
response.raise_for_status()
print(response.json())
响应
| 状态码 | 含义 | Schema |
|---|---|---|
200 | Successful Response | PublicCapabilityQueryResponse |
401 | Invalid API key | PublicApiError |
402 | Insufficient credits | PublicApiError |
403 | Delegation constraint rejected | PublicApiError |
404 | Account unavailable during credit settlement | PublicApiError |
408 | Capabilities query request timeout | PublicApiError |
422 | No candidate fits max_credits | PublicApiError |
500 | Capabilities query failed | PublicApiError |
503 | Capability routing unavailable | PublicApiError |
成功响应示例
{
"execution_id": "exec_01HZX9R2R4S2E",
"capability_id": "MKT.BARS.EOD",
"success": true,
"result": {
"status_code": 200,
"data": [
{
"close": 201
}
]
},
"contract_version": 7,
"schema_hash": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"cost": 2.5,
"credits_used": 2.5,
"remaining_credits": 992.5
}
精确契约
- 稳定版 JSON: OpenAPI JSON
- 稳定版 YAML: OpenAPI YAML
- 版本化 JSON: OpenAPI v1 JSON
- 版本化 YAML: OpenAPI v1 YAML
