Solutions / 웹 검색

답하기 전에
모델이 웹부터 확인합니다

모델 이름 뒤에 :online을 붙이거나 요청에서 웹 검색을 켜면 됩니다. BazaarLink가 먼저 검색해 찾은 내용과 출처를 모델에 넘기고, 답변에는 클릭할 수 있는 인용이 붙습니다.

켜는 방법 세 가지 — 하나만 고르세요

세 방법 모두 동작은 같습니다. 검색은 BazaarLink가 처리하며 이 파라미터들은 모델에 그대로 전달되지 않습니다. chat/completions, responses, messages 세 엔드포인트에서 스트리밍 여부와 관계없이 쓸 수 있습니다.

모델 이름에 :online 붙이기

가장 간단한 방법: 지원 모델 ID 뒤에 :online을 붙입니다.

{
  "model": "openai/gpt-4o-mini:online",
  "messages": [
    { "role": "user", "content": "What changed in the EU AI Act this month?" }
  ]
}

plugins

plugins에 id가 web인 항목을 넣습니다. max_results로 가져올 출처 수를 조정할 수 있습니다(상한 있음).

{
  "model": "openai/gpt-4o-mini",
  "plugins": [{ "id": "web", "max_results": 5 }],
  "messages": [
    { "role": "user", "content": "What changed in the EU AI Act this month?" }
  ]
}

web_search_options

search_context_size로 검색 수준을 고릅니다: low, medium(기본), high.

{
  "model": "openai/gpt-4o-mini",
  "web_search_options": { "search_context_size": "high" },
  "messages": [
    { "role": "user", "content": "What changed in the EU AI Act this month?" }
  ]
}

파라미터 형식은 OpenRouter와 호환됩니다. OpenRouter 방식으로 이미 웹 검색을 켠 코드는 base URL만 BazaarLink로 바꾸면 그대로 동작합니다.

BYOK·BYOC에서도 검색할 수 있습니다

내 상위 키나 내 장비로 모델을 돌려도 :online만 붙이면 모델이 답하기 전에 웹을 검색합니다. 검색은 플랫폼에서 수행되고 결과가 질문과 함께 내 키나 노드로 전달됩니다.

BYOK

내 키가 처리

모델 요금은 BazaarLink가 청구하지 않고 검색 요금만 청구합니다.

BYOK 알아보기

BYOC

내 노드가 처리

모델 요금은 0이며 검색 요금만 청구합니다.

BYOC 알아보기

검색 요금은 플랫폼 가격으로 계산되므로 낼 수 있는 잔액이 필요합니다. 요청을 플랫폼 모델이 처리하면 모델 요금은 플랫폼 요금으로 별도 과금됩니다.

검색 수준

low: 출처를 적게 가져옵니다. 빠르게 확인만 하면 될 때 적합합니다.
medium(기본): 일반 용도의 기본 수준입니다.
high: 더 깊이 검색해 여러 자료를 비교해야 하는 질문에 적합합니다. 단가가 더 높습니다.

과금 방식

검색 건별, 플랫폼 가격

웹 검색은 건마다 플랫폼 가격으로 과금되며 모델 자체 요금에 더해집니다. high 수준 검색은 단가가 더 높습니다.

무료 모델도 검색은 유료

모델 자체는 무료여도 웹 검색은 플랫폼 가격으로 과금됩니다.

검색 실패 시 과금 없음

검색 서비스를 일시적으로 쓸 수 없으면 요청은 503(web_search_unavailable)을 반환하고, 모델을 호출하지 않으며 검색 요금도 없습니다. 모델이 최종적으로 응답 생성에 성공하지 못한 경우에도 검색 요금은 없습니다.

검색 전에 막힌 요청은 검색하지 않음

잔액 부족, 파라미터 오류 등으로 검색 전에 막힌 요청은 검색을 하지 않으며 검색 요금도 발생하지 않습니다.

답변에 출처가 함께 옵니다

답변이 참고한 출처는 각각 url_citation으로 annotations에 담깁니다. URL, 제목, 발췌가 포함되어 UI에 인용을 표시할 수 있습니다.

"message": {
  "role": "assistant",
  "content": "…",
  "annotations": [
    {
      "type": "url_citation",
      "url_citation": {
        "url": "https://example.com/article",
        "title": "Example article",
        "content": "Source excerpt…",
        "start_index": 0,
        "end_index": 0
      }
    }
  ]
}

chat/completions: 비스트리밍은 choices[].message.annotations에 담기고, 스트리밍은 [DONE] 직전에 delta.annotations만 있는 청크가 하나 더 전송됩니다.
responses: output_text의 annotations에, messages: 텍스트 콘텐츠 블록의 annotations에 붙습니다.
답변 본문에 [1] 같은 표시는 자동으로 들어가지 않습니다. 모델이 답변에서 출처를 표시하면 start_index와 end_index가 그 구간을 가리키고, 없으면 둘 다 0입니다.

모든 파라미터와 예시

전체 파라미터, 오류 코드, 엔드포인트별 완전한 예시는 문서의 웹 검색 섹션에 정리되어 있습니다.

웹 검색 문서 보기

다음 요청에 :online을 붙여 보세요

별도 신청 없이 지금 쓰는 API 키로 바로 시작할 수 있습니다. 검색 요금은 계정 잔액에서 차감됩니다.

API 키 받기

답하기 전에모델이 웹부터 확인합니다