웹 검색과 코드 실행

모델 제공사가 자기 서버에서 직접 실행하는 도구를 쓰는 방법입니다. 우리 쪽에서 따로 구현하거나 준비할 것이 없고, 요청에 도구를 선언하면 모델이 알아서 검색하거나 코드를 돌린 뒤 결과를 반영해 답합니다.

일반 함수 호출(function calling)과 다른 점은 실행 주체입니다. 함수 호출은 모델이 "이 함수를 불러 달라"고 요청하고 여러분의 코드가 실행합니다. 서버 도구는 제공사가 실행하고 결과까지 채워서 돌려줍니다. 왕복이 한 번으로 끝납니다.

웹 검색

응답의 content 배열에 단계가 그대로 들어옵니다.

usage.server_tool_use.web_search_requests에 검색 횟수가 들어옵니다. max_uses로 상한을 두면 예산을 통제할 수 있습니다.

output에 web_search_call이 먼저 오고, 이어지는 message의 content[].annotations에 인용 출처가 담깁니다.

계산, 데이터 처리, 검증처럼 모델이 지어내면 안 되는 것에 씁니다. 모델이 파이썬을 짜서 실제로 돌리고, 그 출력을 근거로 답합니다.

베타 헤더가 필요합니다.

실행 결과가 그대로 돌아옵니다.

anthropic-beta 헤더는 헤더로 보내야 합니다. 본문에 "betas": [...]를 넣으면 400 betas: Extra inputs are not permitted가 납니다.

output에 code_interpreter_call이 들어오며, 모델이 작성한 코드와 실행 상태를 볼 수 있습니다.

서버 도구는 토큰과 별개로 과금되며, 사용 내역에서 토큰 비용과 구분되어 기록됩니다.

코드 실행의 최소 과금 시간이 실제 실행 시간보다 훨씬 깁니다. 1초짜리 계산도 최소 시간만큼 냅니다. 짧은 호출을 여러 번 하는 것보다 한 요청에 모아서 처리하는 편이 훨씬 저렴합니다.

모델마다 지원 여부가 다릅니다. GET /v1/gateway/models/{model}/의 pricing.web_search_per_1k가 null이면 그 모델은 웹 검색을 지원하지 않습니다.
샌드박스는 제공사가 운영합니다. 실행 환경, 설치된 라이브러리, 네트워크 접근 여부는 제공사 정책을 따릅니다.
검색 결과와 실행 출력은 다음 턴의 입력 토큰이 됩니다. 대화를 이어 가면 그만큼 입력 비용이 늘어납니다.

마지막 수정 날짜: Sep 18, 2026

/guard

/audio/speech