> ## Documentation Index
> Fetch the complete documentation index at: https://docs.querying.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Bing AI Mode API

> 向 Bing AI Mode（Bing Copilot Search）提问，获取回答、它读取并引用的页面、回答中的地点以及回答上方的赞助商品。

`BING_AIMODE` 以所选国家的未登录访客身份，向 Bing AI Mode（bing.com/copilotsearch 的回答页面，也称 Bing Copilot Search）提问。

| | |
| - | - |
| `taskType` | `BING_AIMODE`（别名 `BING_COPILOT_SEARCH`、`COPILOT_SEARCH`） |
| 输入 | `query` 或 `prompt`（必填），URL 编码后最多 3,500 个字符；`country`、`state`、`include` |
| 积分 | 每个任务 1.25 积分 |
| 国家 | 默认 `US`。支持 `AE`、`AU`、`BR`、`CA`、`DE`、`EE`、`ES`、`FR`、`GB`、`HK`、`HU`、`IE`、`IN`、`IT`、`JP`、`MX`、`NL`、`PL`、`PT`、`RO`、`RS`、`SE`、`SG`、`SK`、`TR`、`US` 和 `ZA`，其他国家返回 `422 REGION_UNSUPPORTED`。 |
| 位置 | 接受 `payload.state`。见[地区与位置](https://docs.querying.ai/zh/engines/capacity.md)。 |

## 请求

```bash theme={"theme":"css-variables"}
curl -X POST https://api.querying.ai/v1/async/task \
  -H "Authorization: Bearer $QUERYING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "taskType": "BING_AIMODE", "payload": { "query": "best wireless earbuds for commuting", "country": "US" } }'
```

任务异步运行。按照[异步任务](https://docs.querying.ai/zh/concepts/async-tasks.md)中的方式读取结果。回答通常在 20 到 80 秒内完成。

## 参数

| 字段 | 必填 | 说明 |
| - | - | - |
| `query` | 是，或 `prompt` | 问题，URL 编码后最多 3,500 个字符，中文等文字会更少。 |
| `prompt` | 是，或 `query` | 可代替 `query`。两者都有时，`BING_AIMODE` 读取 `prompt`。 |
| `country` | 否 | 访客所在国家，决定 Bing 的市场和回答语言。默认 `US`。 |
| `include.rawResponse` | 否 | 设为 `true` 时以 `rawResponse` 附加回答页面 HTML。 |

## 响应

示例：

```json theme={"theme":"css-variables"}
{
  "text": "The Bose QC Ultra Earbuds 2nd Gen, Samsung Galaxy Buds 3 Pro, and Sony WF‑1000XM6 offer the strongest mix of ANC and battery life for daily commuting. ...",
  "markdown": "The **Bose QC Ultra Earbuds 2nd Gen**, **Samsung Galaxy Buds 3 Pro**, and **Sony WF‑1000XM6** offer ... [1]",
  "sources": [
    { "position": 1, "url": "https://pickclarity.com/guides/best-noise-cancelling-earbuds-for-commuting", "label": "Noise Cancelling Earbuds for Commuting — Fit, Battery & Trade-offs", "description": "The best ANC earbuds for commuting in 2026. ..." },
    { "position": 2, "url": "https://headphoneinfatuation.com/best-earbuds-for-commuting/", "label": "10 Best Earbuds for Commuting of 2026", "description": "...", "uncited": true }
  ],
  "places": [],
  "sponsoredProducts": [
    { "position": 1, "title": "Soundcore By Anker Liberty 5 True Wireless Noise-Canceling Earbuds", "url": "https://www.bhphotovideo.com/...", "merchant": "B&H Photo-Video-Pro A", "price": "$89.99", "originalPrice": "$129.99", "image": "https://th.bing.com/th/id/..." }
  ],
  "videos": []
}
```

| 字段 | 说明 |
| - | - |
| `text` | 纯文本回答。`[n]` 指向 `position: n` 的来源。 |
| `markdown` | 带标题、粗体、列表、表格和相同 `[n]` 引用的回答。无需任何标志即返回。Bing 在回答上方展示视频卡片时，markdown 以这些卡片开头。 |
| `sources` | Bing 为回答读取的所有页面，按 Bing 的顺序排列：`position`、`url`、`label` 和 `description`。读取但未引用的页面带有 `uncited: true`。 回答引用了列表之外的页面时，排在其后。 |
| `places` | 回答链接到 Bing 本地页面的地点：`position`、`name`、`url` 和 `ypid`（Bing 的地点 id）。回答未提到地点时为空。 |
| `sponsoredProducts` | Bing 在回答上方展示的赞助商品卡片：`position`、`title`、`url`（广告主页面）、`merchant`、`price`、`originalPrice` 和 `image`，以及卡片在商家下方展示的 `badge`（如 `SALE`）、`rating`（满分 5）、`reviewCount`、`reviewCountText`、`shipping`、`priceDrop`、`returns`、`notes` 和 `promotion`（`label`、`description`、`terms`、`code`）。`reviewCount` 为精确数字，`reviewCountText` 为 Bing 显示的原样，如 `5K+`。Bing 未展示时为空。 |
| `videos` | Bing 在回答上方展示的视频卡片：`title`、`url`、`medium: "video"`、`thumbnail`、`source`、`duration`、`channel`、`views`、`date` 和 `caption`。Bing 未展示时为空。 |
| `rawResponse` | `include.rawResponse: true` 时的回答页面 HTML。 |

## 任务如何运行

每个任务都以所选国家的新访客身份、用该国语言打开 Bing AI Mode。Bing 不会向部分访客展示回答，因此任务会在 7 分钟内以新访客身份重新提问，最多 8 次，并以第一个完整回答完成。8 次都没有得到回答的任务以 `ENGINE_FAILED` 失败，不消耗积分。

## include 标志

| 标志 | 作用 |
| - | - |
| `rawResponse` | 添加 `rawResponse`。 |
| `html` | 添加 `html`，即 Bing AI Mode 显示的画面。见 [HTML 页面](https://docs.querying.ai/zh/engines/html-pages.md)。 |

`markdown` 无需标志。`ads`、`shopping` 和 `searchQueries` 不起作用。`analysis` 以 `422 VALIDATION_ERROR` 拒绝，`citationAnalysis` 以 `400 VALIDATION_ERROR` 拒绝。参见 [Markdown 与原始响应](https://docs.querying.ai/zh/engines/response-options.md)。

## 相关文档

* [Bing AI Mode 产品页](https://querying.ai/zh/engines/bing-ai-mode)
* [Bing 搜索](https://docs.querying.ai/zh/engines/bing-search.md)：bing.com 结果页及其 AI 摘要
* [Microsoft Copilot](https://docs.querying.ai/zh/engines/bing-copilot.md)：Microsoft 的聊天回答
* [引擎概览](https://docs.querying.ai/zh/engines/overview.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.