Gemini 的每个来源都附带置信度

获取 Gemini 应用在你的市场对任意问题给出的回答，附带支撑回答的网页来源以及每个来源的置信度。

获得的结果

• text：Gemini 的完整回答，按需附带 markdown。
• sources：Gemini 作为回答依据的网页，附带 URL 和标题。
• 每个来源的 confidence_level：表示 Gemini 将该来源与回答关联的强度，方便你为引用加权。

工作原理

每个任务都会从你设定的国家向面向消费者的 Gemini 应用提问，并返回当地客户看到的回答。Gemini 会结合自身知识和网上找到的信息作答，来源列表准确显示支撑回答的页面。

把发给 ChatGPT 和 Perplexity 的问题同样发给 Gemini，就能比较各引擎推荐的品牌和信任的页面。

应用场景

• 跟踪 Gemini 如何描述你的品牌和竞争对手。
• 按置信度为引用加权，找出你所在品类中分量最重的来源。
• 用同一组问题比较 Gemini 和其他引擎。

发送请求

在 Authorization 请求头中带上 API 密钥发送请求。

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": "Search the web and recommend 3 wireless earbuds for commuting. Compare noise cancellation and battery life in a short table, with source links. Keep the answer under 180 words.",
      "country": "US",
      "include": { "markdown": true }
    }
  }'

请求字段

taskTypestring必填

要运行的引擎，例如 CHATGPT 或 GOOGLE。

payload.promptstring必填

按用户在聊天框中输入的方式写的问题，最多 100,000 个字符。

payload.countrystring

提问所在市场的两位国家代码，例如 US、KR、JP。默认 US。

payload.locationstring

country 内的地点，例如车站、街区或街道地址，最多 200 个字符。引擎会按身处该地点的用户作答。适用于 CHATGPT、GEMINI、GOOGLE、AIMODE 和 GOOGLE_SERP。

payload.include.markdownboolean

设为 true 会附带 markdown：保留标题、列表、表格和链接的回答。

webhook.urlstring

你服务器上的 HTTPS 地址。任务完成后立即把结果推送到这里。

idempotencyKeystring

你为请求设定的 ID。每个键在账户内对应一个任务，因此重试发送后仍是同一个任务。

响应

完成的任务如下所示，已截取部分内容。

{
  "success": true,
  "task": {
    "id": "40b806b8-c057-4003-934e-98ab5fef2cef",
    "taskType": "GEMINI",
    "status": "COMPLETED",
    "createdAt": "2026-09-10T02:34:15.665Z"
  },
  "credits": { "creditsToCharge": 1, "creditsCharged": 1 },
  "response": {
    "markdown": "Here are 3 top wireless earbuds for commuting:\n\n* **[Bose QuietComfort Ultra Wireless Noise Cancelling Earbuds](…)**: The best choice for commuting, offering unmatched noise cancellation to block …\n…",
    "sources": [
      {
        "position": 3,
        "url": "https://google.com/search?q=EarFun+Air+Pro+4+Wireless+In-ear+headphones&…"
      },
      {
        "position": 5,
        "url": "https://google.com/search?q=Anker+Soundcore+Liberty+5+True+Wireless+Bluetooth+Earbuds&…"
      }
    ]
  }
}

task.statusstring

依次为 QUEUED、PROCESSING，最终为附带回答的 COMPLETED 或附带 error 的 FAILED。

credits.creditsChargedinteger

已完成任务扣除的积分。失败的任务为 0。

response.textstring

纯文本形式的回答。

response.markdownstring

保留格式的回答，包括标题、列表、表格和链接。

response.sourcesarray

回答引用的页面，按引擎展示的顺序排列，含 position、url 和 label。

获取结果

请求会立即返回 status 为 QUEUED 的任务。用 GET /v1/async/task/{id} 轮询，直到 status 变为 COMPLETED 或 FAILED；或者加上 webhook.url，在服务器上接收同样的 task、credits 和 response。任务结束后，结果保留 24 小时供查询。

curl https://api.querying.ai/v1/async/task/$TASK_ID \
  -H "Authorization: Bearer $QUERYING_API_KEY"

价格

每个完成的 Gemini 任务消耗 1 个积分。