现在可以登录并自行创建 API 密钥

创建账户，在控制台签发 API 密钥，几分钟内就能发出第一个任务。

获得的结果

• 控制台中的 API 密钥页面，可自行创建、命名和吊销密钥。
• 每个账户最多 5 个有效密钥，每个应用、环境或团队成员都能使用自己的密钥。
• 一个密钥通用：同一个 Bearer 密钥适用于 API 的所有端点。

工作原理

登录后打开 API 密钥页面并创建密钥。完整密钥只在创建时显示一次，我们只保存它的哈希值，请立即存入你的密钥管理工具。之后每个请求都在 Authorization 头中携带它。

吊销密钥几秒内生效，其他密钥照常使用。为生产、预发布和实验分别准备密钥，就能清楚看到流量来自哪里，并逐个更换密钥。

开始使用

1. 登录 querying.ai，在侧边栏打开“API 密钥”。
2. 选择“+ 新建密钥”，在“密钥名称”中输入 production 之类的名称，然后选择“创建密钥”。
3. 选择“复制密钥”，把密钥保存到密钥管理工具中。完整密钥在此时显示一次。
4. 如需限制密钥，选择“管理”，设置“每日积分上限”“允许的引擎”和“到期时间”。
5. 把密钥设为 QUERYING_API_KEY 环境变量，然后发送第一个请求：

curl -X POST https://api.querying.ai/v1/async/task \
  -H "Authorization: Bearer $QUERYING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "taskType": "GEMINI",
    "payload": { "prompt": "best CRM for a small team", "country": "US" }
  }'

调用会返回你账户中已排队的任务，该任务也会出现在“活动”中。

错误

MISSING_API_KEYHTTP 401

缺少 Authorization 请求头，或密钥有误、已过期或已吊销。

KEY_SCOPE_DENIEDHTTP 403

该引擎在密钥的“允许的引擎”之外。换用其他密钥，或在“管理密钥”中添加该引擎。

KEY_DAILY_CREDIT_LIMITHTTP 429

该密钥已用完每日积分上限。Retry-After 持续到下一个 UTC 零点。