AI 에이전트가 최신 웹 정보를 찾으려면 검색을 직접 연결하고, 결과를 읽어 답변에 반영하는 단계가 필요합니다. 검색 제공자와 호출 경로를 각 프로젝트에서 따로 붙이는 대신 Cloudflare Web Search API를 쓰면 어떨까요? 이 공개 베타는 Ceramic.ai, Exa, Linkup 검색을 AI Gateway와 REST API 또는 Workers에서 사용할 수 있게 합니다.
핵심은 검색 엔진 선택만이 아닙니다. 어떤 경로로 호출할지, 제공자에게 직접 청구할지 Cloudflare 크레딧을 쓸지, 검색 제공자의 데이터 보존과 AI Gateway의 요청 로그가 어떻게 다른지도 함께 정해야 합니다.
출처: X @Cloudflare
REST API와 Workers binding, 두 가지 호출 경로
Web Search API는 공개 베타로 제공되며 검색 결과를 제목·URL·설명 형태로 반환합니다. 일반 애플리케이션에서는 계정별 REST endpoint인 POST /accounts/{account_id}/ai/websearch/를 호출할 수 있습니다. Cloudflare Workers에서는 Workers AI binding의 env.AI.websearch()를 사용합니다. Worker에서 호출할 때도 AI binding과 gateway ID 등 필요한 설정이 있어야 하므로, 단순히 함수 한 줄만 추가하면 끝나는 구성은 아닙니다.
사용하는 제공자를 따로 지정하지 않으면 기본값은 Ceramic.ai입니다. 필요에 따라 Exa나 Linkup을 선택할 수 있고, 세 제공자는 Cloudflare 문서에서 모두 Zero Data Retention(ZDR)을 지원하는 것으로 표시됩니다. 여기서 ZDR은 검색 제공자 측 보존 조건을 말합니다.
제공자 가격과 BYOK 선택
Cloudflare 크레딧으로 호출할 때는 추가 마크업 없이 제공자의 공개 API 가격으로 청구됩니다. 2026년 10월 6일 확인한 제공자 표 기준으로 Ceramic.ai는 1,000회당 $0.25, Exa는 $7, Linkup은 $5입니다. 제공자 가격표는 바뀔 수 있으니 실제 사용 전에는 Cloudflare Web Search 제공자 문서에서 현재 금액을 확인하세요.
자체 제공자 키를 쓰는 BYOK도 가능합니다. AI Gateway에 키를 등록하고 alias를 지정하면 요청에 키를 싣지 않고 저장된 자격 증명을 사용합니다. 이 경우 검색 제공자가 계정에 직접 청구합니다. alias를 지정했는데 키가 설정되지 않았다면 Cloudflare 크레딧으로 자동 전환되지 않고 오류가 납니다. alias를 생략하면 default 키가 있는 경우 이를 사용하고, 없으면 gateway 크레딧으로 호출합니다.
설정 순서와 REST·Workers 예제는 Web Search API 사용 가이드에서 확인할 수 있습니다. Cloudflare의 다른 AI 플랫폼 사례로는 Clef·Clef-Flash 의사결정 모델 글도 함께 볼 만합니다.
ZDR과 AI Gateway 로그는 서로 다른 설정입니다
검색 제공자 세 곳의 ZDR 표시와 Cloudflare AI Gateway의 로그 보존은 같은 의미가 아닙니다. Gateway 로깅은 기본 활성화되어 있지만 끌 수 있고, 요청별 헤더로 수집을 조정할 수도 있습니다. 로그에는 prompt와 response, provider, 시각, 상태, 사용량, 비용, 처리 시간, user agent 등이 포함될 수 있습니다.
보존 방식도 gateway 생성 시점에 따라 달라집니다. 2026년 9월 24일 이후 처음 만든 gateway는 Workers Logs의 가격·보존 체계를 따르고, 그보다 먼저 만든 gateway는 Legacy Logs 체계를 사용합니다. 따라서 검색 제공자의 ZDR 여부만으로 Gateway 로그까지 보존되지 않는다고 해석하면 안 됩니다. 로그 항목과 설정은 AI Gateway Logging 문서에서 확인할 수 있습니다.
검색 기능을 기존 AI 흐름에 연결하기
Cloudflare Web Search API는 계정 REST endpoint나 Workers binding을 통해 검색 결과를 가져오고, AI Gateway에서 제공자와 호출을 관리하는 구조입니다. 기본값인 Ceramic.ai로 시작하거나 Exa·Linkup을 선택하고, 비용 청구는 gateway 크레딧과 BYOK 가운데 운영 방식에 맞춰 고를 수 있습니다.
먼저 호출 경로와 provider를 정한 뒤, 제공자 가격·키 설정·gateway 로그 수집을 각각 확인하면 구성이 명확해집니다. 특히 ZDR은 검색 제공자 측 정책이고 Gateway 로그는 별도 설정이라는 점을 기준으로 데이터 흐름을 살펴보세요. 공식 Cloudflare Web Search API 개요에서 시작할 수 있습니다.
