> ## 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.com/copilotsearch의 답변 페이지인 Bing AI Mode(Bing Copilot Search라고도 부릅니다)에 지정한 국가의 로그아웃 방문자로 묻습니다.

| | |
| - | - |
| `taskType` | `BING_AIMODE`(별칭 `BING_COPILOT_SEARCH`, `COPILOT_SEARCH`) |
| 입력 | `query` 또는 `prompt`(필수), 최대 3,500자(URL 인코딩 기준), `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/ko/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/ko/concepts/async-tasks.md)에 설명된 방식으로 읽습니다. 답변은 보통 20\~80초 안에 완료됩니다.

## 파라미터

| 필드 | 필수 | 설명 |
| - | - | - |
| `query` | 예, 또는 `prompt` | 질문. URL 인코딩 기준 최대 3,500자이며, 한글처럼 인코딩이 길어지는 글자는 그보다 적습니다. |
| `prompt` | 예, 또는 `query` | `query` 대신 받습니다. 둘 다 보내면 `BING_AIMODE`는 `prompt`를 읽습니다. |
| `country` | 아니요 | 방문자 국가입니다. Bing의 시장과 답변 언어를 정합니다. 기본값은 `US`입니다. |
| `include.rawResponse` | 아니요 | `true`면 답변 페이지 HTML을 `rawResponse`로 더합니다. |

## 응답

예시:

```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`는 `5K+`처럼 Bing이 표시한 그대로입니다. 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` | Bing AI Mode가 보여 준 화면인 `html`을 더합니다. [HTML 페이지](https://docs.querying.ai/ko/engines/html-pages.md)를 참고하세요. |

`markdown`는 플래그가 필요 없습니다. `ads`, `shopping`, `searchQueries`는 효과가 없습니다. `analysis`는 `422 VALIDATION_ERROR`, `citationAnalysis`는 `400 VALIDATION_ERROR`로 거절됩니다. [Markdown과 원본 응답](https://docs.querying.ai/ko/engines/response-options.md)을 참고하세요.

## 관련 문서

* [Bing AI Mode 제품 페이지](https://querying.ai/ko/engines/bing-ai-mode)
* [Bing 검색](https://docs.querying.ai/ko/engines/bing-search.md): bing.com 결과 페이지와 AI 요약
* [Microsoft Copilot](https://docs.querying.ai/ko/engines/bing-copilot.md): Microsoft의 채팅 답변
* [엔진 개요](https://docs.querying.ai/ko/engines/overview.md)


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