Baidu Wenxin과 Baidu AI Search를 지원해요

바이두의 AI 어시스턴트 文心助手에 질문하거나 바이두 검색 결과 맨 위의 AI 답변을 읽고, 답변과 출처를 받아요.

받는 결과

• BAIDU_WENXIN: chat.baidu.com에 있는 바이두의 AI 어시스턴트 文心助手의 답변입니다. 모든 결과에 text, markdown, sources, searchQueries가 담깁니다.
• BAIDU_AI_SEARCH: 바이두 검색 결과 맨 위의 AI 답변(百度AI+)입니다. card, text, markdown, sources를 받습니다.
• 같은 결과 페이지의 나머지 블록입니다. organicResults, ads, relatedSearches, 뉴스와 동영상과 노트를 담은 contentResults, shoppingResults, images, map, otherCards를 페이지에 있을 때 받습니다.

동작 방식

두 엔진 모두 중국 본토에서 처음 방문한 사용자로 바이두에 묻습니다. 文心助手는 답하기 전에 웹을 검색하고 읽은 페이지를 보여 주므로, sources에는 그 페이지가 담깁니다. 영어로 출퇴근용 이어폰을 물으면 검색 5번을 실행하고 페이지 26개를 읽었고, 그중 19개가 Sohu와 Baijiahao 페이지였습니다. 답변은 영어로 왔습니다.

Baidu AI Search는 payload.query로 검색한 사용자가 받는 결과 페이지를 읽습니다. card는 百度AI+ 카드이면 general이고, 이때 markdown의 [1]은 출처의 position과 맞습니다. 百度健康 카드이면 health이고, 카드에 보이는 감수 문구를 reviewedBy로 받습니다. 바이두는 일부 검색에만 AI 답변을 보여 주므로, 세 번 물어도 AI 답변이 없는 검색은 card: null과 나머지 결과 페이지로 완료됩니다.

降噪耳机哪个牌子好를 검색하면 AI 답변은 Sony, Bose, Apple을 1군 브랜드로 꼽고 출처 8개를 인용했습니다. Baidu Baike와 PCMag도 그중에 있었습니다. 같은 페이지에는 검색 결과 6개, 광고 3개, 관련 검색어 12개가 있었습니다.

아래 예시는 BAIDU_WENXIN 태스크입니다. Baidu AI Search는 taskType을 BAIDU_AI_SEARCH로 바꾸고 검색어를 payload.query로 보냅니다.

이렇게 활용하세요

• 바이두 어시스턴트와 바이두 검색이 중국 사용자에게 내 브랜드를 어떻게 소개하는지 간체 중국어 질문으로 추적합니다.
• Qwen, Doubao에서 추적하던 중국어 질문 세트에 바이두를 더합니다.
• 바이두 AI 답변이 인용한 페이지를 같은 페이지의 검색 결과, 광고와 비교합니다.

요청 보내기

API 키를 Authorization 헤더에 넣어 요청을 보냅니다.

curl -X POST https://api.querying.ai/v1/async/task \
  -H "Authorization: Bearer $QUERYING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "taskType": "BAIDU_WENXIN",
    "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."
    }
  }'

요청 필드

taskTypestring필수

실행할 엔진입니다. CHATGPT, GOOGLE 같은 값을 넣습니다.

payload.promptstring필수

사용자가 채팅에 입력하듯 쓴 질문입니다. 최대 100,000자.

webhook.urlstring

서버의 HTTPS 주소입니다. 태스크가 끝나는 즉시 결과를 이 주소로 보냅니다.

idempotencyKeystring

요청에 붙이는 고유 ID입니다. 키 하나는 계정에서 태스크 하나를 만들므로, 다시 보내도 태스크는 하나로 유지됩니다.

응답

완료된 태스크는 이런 형태입니다. 길이를 줄여 보여 드립니다.

{
  "success": true,
  "task": {
    "id": "aa524d15-1945-491e-bdfc-ef34a0c933e5",
    "taskType": "BAIDU_WENXIN",
    "status": "COMPLETED",
    "createdAt": "2026-11-02T12:51:32.104Z"
  },
  "credits": { "creditsToCharge": 1.25, "creditsCharged": 1.25 },
  "response": {
    "text": "3 Commuting Wireless Earbuds Comparison\n\n| Model | Noise Cancellation | Total Battery Life |\n|-------|--------------------|--------------------|\n| Beats Studio Buds+ | Strong active noise cancellation | 36 hours |\n| Bose QuietComfort Ultra Earbuds | Adaptive smart noise cancellation | 30 hours |\n| EarFun AirPro4+ | AI-enhanced ANC | 48 hours |\n…",
    "markdown": "### 3 Commuting Wireless Earbuds Comparison\n\n| Model | Noise Cancellation | Total Battery Life |\n|-------|--------------------|--------------------|\n| Beats Studio Buds+ | Strong active noise cancellation | 36 hours |\n…",
    "sources": [
      {
        "position": 1,
        "url": "https://www.sohu.com/a/1095420712_122645258",
        "label": "通勤地铁用蓝牙耳机推荐：BOSE、EarFun与SANAG真实体验与场景适配解析_传导_乐图_耳道",
        "source": "搜狐"
      },
      {
        "position": 2,
        "url": "https://www.sohu.com/a/1096142207_122645258",
        "label": "通勤用什么蓝牙耳机好？2026年四大热门机型场景化实测与选购建议_运动_手机_训练",
        "source": "搜狐"
      }
    ],
    "searchQueries": [
      "适合 commuting的无线耳塞推荐",
      "2026年热门通勤无线耳塞推荐",
      "无线耳塞降噪效果和续航对比",
      "…"
    ]
  }
}

task.statusstring

QUEUED, PROCESSING을 거쳐 답변과 함께 COMPLETED로, 또는 error와 함께 FAILED로 끝납니다.

credits.creditsChargedinteger

끝난 태스크에 청구된 크레딧입니다. 실패한 태스크는 0입니다.

response.textstring

답변 평문입니다.

response.markdownstring

제목, 목록, 표를 살린 답변으로, 모든 결과에 담깁니다.

response.sourcesarray

답변이 인용한 페이지입니다. 엔진이 보여 준 순서대로 position, url, label이 담깁니다.

response.searchQueriesarray

엔진이 답을 쓰려고 실행한 웹 검색어입니다.

결과 받기

요청하면 status가 QUEUED인 태스크가 바로 돌아옵니다. status가 COMPLETED나 FAILED가 될 때까지 GET /v1/async/task/{id}로 조회하거나, webhook.url을 넣어 같은 task, credits, response를 서버로 받으세요. 결과는 태스크가 끝난 뒤 24시간 동안 조회됩니다.

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

요금

두 엔진 모두 완료된 태스크마다 1.25크레딧이 차감됩니다. card: null로 완료된 Baidu AI Search 태스크도 1.25크레딧이 차감되고, 실패한 태스크는 차감되지 않습니다.