Cloudflare 웹 검색 API 공개 베타, 1,000건 0.25달러에 크레딧 5% 수수료

에이전트에 "지금 인터넷에서 찾아보고 답해"를 시키려면 지금까지 둘 중 하나를 골라야 했습니다. 검색 회사와 따로 계약해 키를 받아 쓰는 방법, 그리고 모델 제공사의 내장 검색 기능을 켜는 방법입니다. 전자는 청구서와 로그가 모델 호출과 따로 쌓입니다. 후자는 값이 비쌉니다. Anthropic의 웹 검색 도구는 검색 1,000건에 10달러입니다. 검색으로 끌어온 내용은 입력 토큰으로 또 과금됩니다.

Cloudflare가 2026년 10월 2일 이 선택지에 세 번째를 추가했습니다. AI Gateway 안에서 호출하는 웹 검색 API를 공개 베타로 열었습니다. 검색 공급자 세 곳은 파라미터 한 개로 바꿔 씁니다. 가격은 공급자 정가를 그대로 받아 1,000건 0.25달러부터 7달러까지입니다.

답을 만들어 주는 검색과 목록만 주는 검색

이 API는 답을 만들어 주지 않습니다. 질의를 보내면 url, title, description이 담긴 결과 목록과 metadata(질의, 요청 ID, 지연 시간)를 돌려줍니다. 검색을 언제 할지, 받은 내용 중 얼마를 모델 컨텍스트에 넣을지는 내 코드가 정합니다.

모델 제공사의 내장 검색은 반대입니다. 도구를 붙여두면 모델이 검색 시점을 스스로 판단하고 한 번의 요청 안에서 여러 번 검색한 뒤 인용까지 붙인 답을 만듭니다. Anthropic 문서는 단순 사실 질의가 보통 1번부터 3번, 비교 조사는 10번 이상 검색한다고 적었습니다. 즉 요청 한 건이 검색 열 건으로 불어납니다.

같은 1,000건으로 견주면 Ceramic.ai 경로가 Anthropic 내장 검색의 40분의 1입니다. 다만 받는 물건이 다릅니다. 내장 검색 10달러에는 검색 판단, 반복 검색, 인용 처리가 들어 있습니다. 0.25달러에는 결과 목록만 들어 있습니다. 검색 시점 판단과 결과 선별을 직접 구현할 팀에게는 40분의 1이 실제 절감입니다. 그 판단을 모델에 맡길 팀에게는 비교 대상이 아닙니다.

공급자 3곳, 가격 차이는 28배

기본값은 Ceramic.ai입니다. Cloudflare 문서는 Ceramic.ai가 400억 페이지가 넘는 자체 웹 색인을 사람이 아닌 에이전트용으로 설계했다고 적었습니다. 결과 설명문은 최대 8,000자까지 돌려줍니다.

Exa 자체 요금제를 확인해 보면 auto 검색이 1,000건 7달러(결과 10건까지)로, Cloudflare 표의 숫자와 같습니다. Ceramic.ai도 월 약정 없는 요금제가 1,000건 0.25달러로 같습니다. 정가를 그대로 받는다는 설명은 사실입니다.

여기서 ZDR(Zero Data Retention, 데이터 미보관) 표기가 1차 소스끼리 어긋납니다. Cloudflare 변경 로그는 세 공급자 모두 Cloudflare 경유 요청에 ZDR을 지원한다고 적었는데, 공급자 문서의 표는 Exa를 미지원으로 표시합니다. 같은 날 같은 도메인의 두 문서가 서로 다른 말을 합니다. 개인정보나 규제 데이터가 질의에 섞이는 서비스라면 공급자에게 직접 확인하는 편이 안전합니다. 같은 모델이라도 어느 회사가 돌리느냐에 따라 조건이 갈리는 일은 OpenRouter에서 도구 호출 점수가 호스트마다 30점씩 벌어진 사례에서도 나왔습니다.

지금 쓸 수 있나

AI Gateway는 Free를 포함한 모든 요금제에 열려 있습니다. 문서에 지역 제한 표기도 없습니다. 한국에서도 대시보드에서 크레딧을 충전하면 바로 호출됩니다.

호출은 REST와 Workers 바인딩 두 가지입니다.

curl -X POST \
  "https://api.cloudflare.com/client/v4/accounts/$ACCOUNT_ID/ai/websearch/" \
  -H "Authorization: Bearer $CLOUDFLARE_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "cloudflare web search api pricing",
    "provider": "ceramic",
    "limit": 5,
    "options": { "gateway": { "id": "default" } }
  }'

Workers 안에서는 한 줄입니다.

const response = await env.AI.websearch({
  gatewayId: 'default',
  query: 'cloudflare web search api pricing',
  provider: 'ceramic',
  limit: 5,
})

한도는 두 개입니다. 질의는 1,024자까지, 결과는 10건까지입니다. 결과를 20건 받아 재순위를 매기는 방식으로 짜둔 파이프라인이라면 그대로 옮겨오지 못합니다. 공개 베타의 초당 요청 한도는 문서에 없습니다. 베타 기간과 정식 출시 일정도 적혀 있지 않습니다.

크레딧을 충전할 때 붙는 5%

가격표에 없는 비용이 하나 있습니다. AI Gateway 크레딧은 충전할 때 5%가 붙습니다. Unified Billing 문서는 "Unified Billing으로 구매한 모든 크레딧에 5% 수수료가 적용된다"고 적었습니다. 100달러를 충전하면 105달러가 청구된다는 예도 함께 실었습니다.

수수료를 피하는 길은 byokAlias로 공급자 키를 직접 연결하는 것입니다. 이 경우 공급자가 직접 청구하므로 5%가 붙지 않습니다. Ceramic.ai의 Pro 요금제는 월 99달러에 1,000건 0.20달러이고 초당 50회까지 허용하므로, 월 검색량이 50만 건에 가까운 서비스라면 BYOK 쪽이 더 쌉니다. 반대로 월 몇만 건 규모라면 월 99달러를 회수하지 못하므로 크레딧 경로가 낫습니다.

공급자 3곳이 서명한 봇 규범

Cloudflare는 세 공급자가 모두 자사의 검증된 봇(verified bots) 요건, robots.txt 준수, 출처 표기에 합의했다고 밝혔습니다. 검색 결과를 파는 쪽이 어떻게 긁어왔는지를 구매자가 아니라 중개자가 보증하는 구조입니다.

같은 주에 이 약속이 왜 필요한지를 보여 주는 조사 결과가 나왔습니다. Wikimedia 재단은 2026년 10월 5일 자체 조사를 공개하면서, OpenAI가 운영한 것으로 추정되는 에이전트가 자사 위키에 무승인 편집을 하고 수백만 페이지를 요청했으며 그 트래픽이 5월 Wikidata 질의 서비스 장애에 영향을 준 것으로 본다고 밝혔습니다. 에이전트에 웹 접근을 열어 주는 일이 어디까지 번지는지는 GET 요청만 허용한 샌드박스에서 링크 900개를 이어 코드를 실행한 사례에서도 드러났습니다. 검색을 중개로 묶으면 요청이 어느 공급자를 거쳤고 무엇을 긁었는지가 게이트웨이 로그 한 곳에 남습니다.

Cloudflare는 AI Gateway를 모델 호출 통로에서 에이전트의 외부 호출 통로로 넓혔습니다. 같은 게이트웨이가 모델 추론과 자체 결정 모델 Clef에 이어 이제 웹 검색까지 받습니다. 로그와 분석과 과금은 한 곳에 모입니다. 검색을 AI Gateway 제어 평면에 도구로 직접 등록하는 "server tools"도 예고됐습니다.

에이전트에 검색을 이미 연결해 둔 팀이라면, 지난달 검색 청구서의 요청 수를 꺼내 0.25달러 기준으로 다시 계산해 보는 것이 첫 작업입니다. 결과 10건과 질의 1,024자 한도가 지금 파이프라인에 맞는지, 그리고 월 검색량이 Ceramic Pro의 월 99달러를 회수할 규모인지가 크레딧과 BYOK를 가르는 기준입니다. 아직 검색을 붙이지 않았다면, 기본값 Ceramic.ai로 질의 20개를 돌려 한국어 질의에서 어떤 출처가 올라오는지부터 확인하면 됩니다. Cloudflare 문서는 색인 400억 페이지의 언어 구성을 밝히지 않았습니다. 한국어 질의 품질은 직접 재 봐야 압니다.