QVeris
运行任务
文档目录

查询 Capability 数据

POST /capabilities/query

查询 Capability 数据

REST API 概览 · OpenAPI JSON · OpenAPI YAML

接口契约

稳定性认证费用Operation ID
已发布Bearer API 密钥取决于所选能力的 billing_rulecapabilities_query_api_v1_capabilities_query_post

参数

此操作没有路径或查询参数。

请求体

Schema: PublicCapabilityQueryRequest

至少满足一组必填字段:capability_idquery

名称必填类型说明
capability_id条件必填string
query条件必填string
parametersobject
paramsobject
session_idstring | null
search_idstring | null
run_idstring
provider_idstring
provider_idsstring[]
max_response_sizeinteger
max_creditsnumberMaximum credits allowed for this execution. Candidates without a provable upper bound are excluded.

可运行示例

bash
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
}'
typescript
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())
python
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
200Successful ResponsePublicCapabilityQueryResponse
401Invalid API keyPublicApiError
402Insufficient creditsPublicApiError
403Delegation constraint rejectedPublicApiError
404Account unavailable during credit settlementPublicApiError
408Capabilities query request timeoutPublicApiError
422No candidate fits max_creditsPublicApiError
500Capabilities query failedPublicApiError
503Capability routing unavailablePublicApiError

成功响应示例

json
{
  "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
}

精确契约

相关操作

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

这个页面对你有帮助吗?