跳转到主要内容
在每个请求的 Authorization 请求头中发送 API 密钥:
密钥以 vt_ 开头,创建后立即生效。

获取密钥

  1. 在 querying.ai 注册。新账户赠送 500 免费积分。
  2. 在控制台打开 API 密钥并创建密钥。
  3. 在密钥显示时复制它,并保存在环境变量或密钥管理服务中。
一个账户最多可持有 5 个有效密钥。计划替换时,请预留一个新密钥名额,并在客户端切换期间保持两个密钥都有效:
  1. 在控制台创建额外的密钥,设置所需的引擎范围、每日积分限额和到期时间。
  2. 将所有调用客户端和 webhook 签名验证更新为使用新密钥,并确认请求成功。保留旧签名密钥,以验证用旧密钥提交的任务通知。
  3. 吊销旧密钥。
控制台轮换会签发一个设置相同的新密钥,并立即吊销旧密钥。此后使用旧密钥的请求将返回 401,客户端必须切换到新密钥才能恢复请求。
只在服务器端代码中使用密钥。任何持有密钥的人都能消耗你的积分。不要把它放进浏览器应用、移动应用或公开代码仓库。

密钥设置

每个密钥都有可在控制台设置的可选项: 账户级限制请参阅积分与限制。

哪些端点需要密钥

错误

缺失、格式错误、已吊销或已过期的密钥返回 401。在任务、批次和研究端点上,错误码为 MISSING_API_KEY:
密钥在被吊销或过期之前创建的任务(包括批次的项目)会继续运行并计费。 完整错误参考:错误。