요약
APIYI는 OpenAI의 공식 웹 검색을 완전히 지원합니다: Responses API(/v1/responses)와 web_search 도구를 사용합니다. gpt-5.5와 gpt-5.4 모두 웹을 실제로 검색하고 출처 인용과 함께 최신 정보를 반환하는 것이 검증되었습니다. 기본 그룹 키는 별도 활성화 없이 바로 사용할 수 있습니다.
실제 가용성(테스트 데이터, 2026-06-11)
빠른 시작
cURL
Python (OpenAI SDK)
응답 구조
output 배열에는 실행 순서대로 다음이 포함됩니다:
status: "completed"는 정상적으로 종료되었음을 의미합니다; incomplete은 보통 max_output_tokens가 너무 작았음을 의미합니다 — 값을 늘리십시오.
과금 (중요)
Web search는 두 부분으로 구성된 도구 호출 수수료가 발생합니다:Web 지원 Q&A 1회당 측정된 총 비용: gpt-5.4 ≈ $0.01 검색 수수료 + 9k tokens; gpt-5.5 ≈ $0.08 검색 수수료 + ~50k tokens. 예상 쿼리량에 맞춰 추정하십시오.
메모
- Responses API를 사용하십시오 — Chat Completions의
web_search_options는 사용하지 마십시오: gpt-5 시리즈 모델은 해당 매개변수를 지원하지 않습니다(공식 OpenAI 동작이며, 400Unknown parameter: 'web_search_options'를 반환합니다).web_search_options는 전용*-search-preview모델에만 적용됩니다. max_output_tokens를 최소 8192로 설정하십시오: gpt-5.5는 많은 추론 tokens를 소비합니다. 제한이 너무 작으면 최종 답변 없이status: "incomplete"를 반환하지만, token은 계속 과금됩니다.- 레거시 도구 유형
web_search_preview도 동일한 동작으로 사용할 수 있습니다. 새 통합에서는web_search를 직접 사용하십시오. - 비용을 제어하려면 prompt에서 검색 동작을 제한하십시오(예: “최대 2회만 검색”) 또는 gpt-5.4를 사용하십시오.
자주 묻는 질문
질문: 답변이 정말 웹을 사용했는지 어떻게 확인하나요? 답변output에 type="web_search_call"가 포함된 항목이 있는지, 그리고 message 주석에 url_citation가 포함되는지 확인하십시오. 두 항목이 모두 있으면 실제 웹 액세스입니다. 이 두 마커 없이 답변 텍스트만 있으면 모델이 학습 데이터로 답한 것입니다.
질문: 다른 그룹이나 특별한 키가 필요한가요?
답변: 아닙니다. OpenAI 모델의 경우 기본 그룹 키로 웹 검색을 직접 호출할 수 있습니다.
질문: 어떤 모델이 지원되나요?
답변: gpt-5.5와 gpt-5.4는 검증되었습니다. 다른 gpt-5 시리즈 모델도 원칙적으로 Responses API web_search 도구를 지원해야 합니다. 다만 신뢰하기 전에 위 FAQ의 검증 절차를 먼저 실행하십시오.
관련 문서
OpenAI 네이티브 호출 (Responses API)
Responses API 엔드포인트, 파라미터, 설정
OpenAI 프롬프트 캐싱
웹 검색으로 주입되는 큰 input-token 양은 캐싱과 잘 맞습니다