← Cloudflare AI Gateway / ai-gateway / usage

Web Search

AI Gateway proxíruje nativní nástroje pro webové vyhledávání podporovaných poskytovatelů, aby modely mohly odpovídat na otázky o událostech, které nastaly až po uzávěrce jejich trénovacích dat. Vyhledávání probíhá u nadřazeného poskytovatele, na požadavek se ale i tak uplatní standardní funkce AI Gateway: protokolování, ukládání do mezipaměti, limit počtu požadavků a guardrails.

Způsob povolení webového vyhledávání závisí na poskytovateli. Aktivace probíhá buď jako záznam nástroje na tools pole nebo příznak na nejvyšší úrovni těla požadavku. Následující tabulka vás nasměruje na správnou sekci.

Podporovaní poskytovatelé

Poskytovatel	Endpoint	Aktivace
Anthropic	`POST /ai/v1/messages`	`tools: [{ "type": "web_search_20250305", "name": "web_search", "max_uses": N }]`
OpenAI	`POST /ai/v1/responses`	`tools: [{ "type": "web_search_preview" }]`
xAI	`POST /ai/v1/responses`	`tools: [{ "type": "web_search" }]`
Alibaba	`POST /ai/v1/chat/completions`	nejvyšší úrovně `"enable_search": true`

U poskytovatelů, jejichž produktem je samotné vyhledávání (Perplexity a Parallel), najdete více v Poskytovatelé zaměření na vyhledávání.

Webové vyhledávání Anthropic

Modely Anthropic zpřístupňují webové vyhledávání prostřednictvím svého nativního web_search_20250305 nástroj ↗. Přidejte ho do tools pole v POST /ai/v1/messages požadavek.

Podporované modely: anthropic/claude-haiku-4.5, anthropic/claude-opus-4.5, anthropic/claude-opus-4.6, anthropic/claude-opus-4.7, anthropic/claude-opus-4.8, anthropic/claude-sonnet-4.5, anthropic/claude-sonnet-4.6.

# Run `wrangler whoami` to get your account ID to replace $CLOUDFLARE_ACCOUNT_ID,
# and `wrangler auth token` to get an auth token to replace $CLOUDFLARE_API_TOKEN.
curl -X POST "https://api.cloudflare.com/client/v4/accounts/$CLOUDFLARE_ACCOUNT_ID/ai/v1/messages" \
  --header "Authorization: Bearer $CLOUDFLARE_API_TOKEN" \
  --header "Content-Type: application/json" \
  --data '{
    "model": "anthropic/claude-haiku-4.5",
    "max_tokens": 4096,
    "messages": [
      {
        "role": "user",
        "content": "What were the top news stories about Cloudflare this week? Summarize in three bullets."
      }
    ],
    "tools": [
      {
        "type": "web_search_20250305",
        "name": "web_search",
        "max_uses": 3
      }
    ]
  }'

Ekvivalentní volání z Workeru pomocí AI binding:

const resp = await env.AI.run(
	"anthropic/claude-haiku-4.5",
	{
		max_tokens: 4096,
		messages: [
			{
				role: "user",
				content:
					"What were the top news stories about Cloudflare this week? Summarize in three bullets.",
			},
		],
		tools: [{ type: "web_search_20250305", name: "web_search", max_uses: 3 }],
	},
	{
		gateway: {
			id: "default", // or use a specific gateway name
		},
	},
);

const resp = await env.AI.run(
	"anthropic/claude-haiku-4.5",
	{
		max_tokens: 4096,
		messages: [
			{
				role: "user",
				content:
					"What were the top news stories about Cloudflare this week? Summarize in three bullets.",
			},
		],
		tools: [{ type: "web_search_20250305", name: "web_search", max_uses: 3 }],
	},
	{
		gateway: {
			id: "default", // or use a specific gateway name
		},
	},
);

Vyvolání vyhledávání a jejich výsledky se v odpovědi zobrazují jako server_tool_use a web_search_tool_result bloky obsahu. Konfigurovatelné parametry zahrnují max_uses, allowed_domains, blocked_domains, a user_location : další informace naleznete v dokumentaci Anthropic k dokumentace k nástroji pro vyhledávání na webu ↗ pro úplný seznam.

Webové vyhledávání OpenAI

Modely OpenAI zpřístupňují webové vyhledávání prostřednictvím web_search_preview nástroj ↗ v Responses API. Použijte POST /ai/v1/responses koncový bod a přidat nástroj do tools pole.

Podporované modely: openai/gpt-4.1, openai/gpt-4.1-mini, openai/gpt-4o, openai/gpt-4o-mini, openai/gpt-5, openai/gpt-5-mini, openai/gpt-5-nano, openai/gpt-5.1, openai/gpt-5.4, openai/gpt-5.4-mini, openai/gpt-5.4-nano, openai/gpt-5.4-pro, openai/gpt-5.5, openai/gpt-5.5-pro, openai/o3, openai/o4-mini.

# Run `wrangler whoami` to get your account ID to replace $CLOUDFLARE_ACCOUNT_ID,
# and `wrangler auth token` to get an auth token to replace $CLOUDFLARE_API_TOKEN.
curl -X POST "https://api.cloudflare.com/client/v4/accounts/$CLOUDFLARE_ACCOUNT_ID/ai/v1/responses" \
  --header "Authorization: Bearer $CLOUDFLARE_API_TOKEN" \
  --header "Content-Type: application/json" \
  --data '{
    "model": "openai/gpt-4o-mini",
    "input": "What were the top news stories about Cloudflare this week? Summarize in three bullets.",
    "max_output_tokens": 4096,
    "tools": [
      { "type": "web_search_preview" }
    ]
  }'

Ekvivalentní volání z Workeru pomocí AI binding:

const resp = await env.AI.run(
	"openai/gpt-4o-mini",
	{
		input:
			"What were the top news stories about Cloudflare this week? Summarize in three bullets.",
		max_output_tokens: 4096,
		tools: [{ type: "web_search_preview" }],
	},
	{
		gateway: {
			id: "default", // or use a specific gateway name
		},
	},
);

const resp = await env.AI.run(
	"openai/gpt-4o-mini",
	{
		input:
			"What were the top news stories about Cloudflare this week? Summarize in three bullets.",
		max_output_tokens: 4096,
		tools: [{ type: "web_search_preview" }],
	},
	{
		gateway: {
			id: "default", // or use a specific gateway name
		},
	},
);

Webové vyhledávání OpenAI je dostupné pouze na koncovém bodě Responses API (POST /ai/v1/responses). /ai/v1/chat/completions koncový bod nepřijímá web_search_preview nástroj.

Obojí { "type": "web_search_preview" } a { "type": "web_search" } se přijímají v Responses API. Příklady zde používají web_search_preview.

vyhledávání na webu xAI

Multiagentní model Grok od xAI zpřístupňuje vyhledávání na webu prostřednictvím web_search nástroj ↗ v Responses API. Přidejte { "type": "web_search" } do tools pole v POST /ai/v1/responses požadavek.

Podporované modely: xai/grok-4.20-multi-agent-0309.

# Run `wrangler whoami` to get your account ID to replace $CLOUDFLARE_ACCOUNT_ID,
# and `wrangler auth token` to get an auth token to replace $CLOUDFLARE_API_TOKEN.
curl -X POST "https://api.cloudflare.com/client/v4/accounts/$CLOUDFLARE_ACCOUNT_ID/ai/v1/responses" \
  --header "Authorization: Bearer $CLOUDFLARE_API_TOKEN" \
  --header "Content-Type: application/json" \
  --data '{
    "model": "xai/grok-4.20-multi-agent-0309",
    "input": "What were the top news stories about Cloudflare this week? Summarize in three bullets.",
    "max_turns": 4,
    "tools": [
      { "type": "web_search" }
    ]
  }'

Ekvivalentní volání z Workeru pomocí AI binding:

const resp = await env.AI.run(
	"xai/grok-4.20-multi-agent-0309",
	{
		input:
			"What were the top news stories about Cloudflare this week? Summarize in three bullets.",
		max_turns: 4,
		tools: [{ type: "web_search" }],
	},
	{
		gateway: {
			id: "default", // or use a specific gateway name
		},
	},
);

const resp = await env.AI.run(
	"xai/grok-4.20-multi-agent-0309",
	{
		input:
			"What were the top news stories about Cloudflare this week? Summarize in three bullets.",
		max_turns: 4,
		tools: [{ type: "web_search" }],
	},
	{
		gateway: {
			id: "default", // or use a specific gateway name
		},
	},
);

xai/grok-4.20-multi-agent-0309 je jediný model xAI, který přes AI Gateway přijímá webové vyhledávání. Informace o dalších modelech Grok najdete v Modely bez podpory webového vyhledávání.

Webové vyhledávání Alibaba (Qwen)

Modely Alibaba DashScope Qwen umožňují webové vyhledávání prostřednictvím parametru nejvyšší úrovně enable_search ↗ příznak u požadavku chat completions. Na rozdíl od Anthropic, OpenAI a xAI neexistuje žádný tools položku: vyhledávání na webu se aktivuje samotným příznakem.

Podporované modely: alibaba/qwen3-max, alibaba/qwen3.5-397b-a17b.

# Run `wrangler whoami` to get your account ID to replace $CLOUDFLARE_ACCOUNT_ID,
# and `wrangler auth token` to get an auth token to replace $CLOUDFLARE_API_TOKEN.
curl -X POST "https://api.cloudflare.com/client/v4/accounts/$CLOUDFLARE_ACCOUNT_ID/ai/v1/chat/completions" \
  --header "Authorization: Bearer $CLOUDFLARE_API_TOKEN" \
  --header "Content-Type: application/json" \
  --data '{
    "model": "alibaba/qwen3-max",
    "enable_search": true,
    "max_tokens": 4096,
    "messages": [
      {
        "role": "user",
        "content": "What were the top news stories about Cloudflare this week? Summarize in three bullets."
      }
    ]
  }'

Ekvivalentní volání z Workeru pomocí AI binding:

const resp = await env.AI.run(
	"alibaba/qwen3-max",
	{
		enable_search: true,
		max_tokens: 4096,
		messages: [
			{
				role: "user",
				content:
					"What were the top news stories about Cloudflare this week? Summarize in three bullets.",
			},
		],
	},
	{
		gateway: {
			id: "default", // or use a specific gateway name
		},
	},
);

const resp = await env.AI.run(
	"alibaba/qwen3-max",
	{
		enable_search: true,
		max_tokens: 4096,
		messages: [
			{
				role: "user",
				content:
					"What were the top news stories about Cloudflare this week? Summarize in three bullets.",
			},
		],
	},
	{
		gateway: {
			id: "default", // or use a specific gateway name
		},
	},
);

DashScope nevrací kontext podložený vyhledáváním jako samostatné bloky odpovědí volání nástrojů. Načtený kontext vkládá do promptu jako další vstupní tokeny: očekávejte prompt_tokens výrazně zvýšit v případě úspěšné odpovědi založené na vyhledávání.

Poskytovatelé zaměření na vyhledávání

U některých poskytovatelů je primárním API vyhledávací koncový bod, nikoli chatovací koncový bod s nástrojem pro vyhledávání na webu. AI Gateway je zpřístupňuje prostřednictvím jejich stávajících proxy koncových bodů poskytovatele na gateway.ai.cloudflare.com.

AI Gateway neposkytuje abstrakci pro webové vyhledávání nezávislou na poskytovateli. Volejte proxy poskytovatele přímo podle níže uvedených vzorů.

Perplexity

Zavolejte libovolný Model Perplexity Sonar ↗ přes Proxy poskytovatele Perplexity.

curl https://gateway.ai.cloudflare.com/v1/{account_id}/{gateway_id}/perplexity-ai/chat/completions \
  --header "Authorization: Bearer $PERPLEXITY_API_TOKEN" \
  --header "Content-Type: application/json" \
  --data '{
    "model": "sonar",
    "messages": [
      { "role": "user", "content": "What were the top news stories about Cloudflare this week?" }
    ]
  }'

Parallel

Volejte Search API společnosti Parallel přes Proxy poskytovatele Parallel. Přečtěte si dokumentaci Parallel k Dokumentace k Search API ↗ pro úplné schéma požadavku.

curl https://gateway.ai.cloudflare.com/v1/{account_id}/{gateway_id}/parallel/v1beta/search \
  --header "x-api-key: $PARALLEL_API_TOKEN" \
  --header "Content-Type: application/json" \
  --data '{
    "objective": "Top news stories about Cloudflare this week.",
    "processor": "base",
    "max_results": 10
  }'

Modely bez podpory webového vyhledávání

Následující modely nepodporují webové vyhledávání přes AI Gateway:

Google Gemini : není dostupné prostřednictvím sjednoceného web_search nástroj, protože OpenAI kompatibilní rozhraní Vertex ho nepřevede na nativní googleSearch nástroj. Chcete-li použít Gemini grounding, předejte nativní google_search nástroj k koncový bod specifický pro poskytovatele Vertex.
Modely Grok pro chat-completions, xai/grok-4.20-0309-non-reasoning, xai/grok-4.20-0309-reasoning, a xai/grok-4.3 používají koncový bod chat-completions, který nepřijímá web_search nástroj. Pro vyhledávání na webu Grok viz vyhledávání na webu xAI.
DeepSeek deepseek-v4-flash, deepseek-v4-pro : tyto modely přijímají pouze function tools.
MiniMax m2.7, m3 : tyto modely přijímají { "type": "function" } jen nástroje.
OpenAI gpt-4.1-nano, o1-pro, o3-mini : upstream vrátí invalid_request_error pro web_search_preview na těchto modelech.
OpenAI gpt-4o-search-preview, gpt-4o-mini-search-preview : tyto preview modely jsou upstream označeny jako zastaralé.

Ceny a protokolování

Požadavky na vyhledávání na webu se účtují podle sazeb poskytovatele za vyhledávání na webu a procházejí přes Unified Billing společně se zbytkem volání modelu. AI Gateway si za vyhledávání na webu neúčtuje žádný samostatný poplatek.

Volání nástroje pro vyhledávání na webu a jejich výsledky jsou vidět v AI Gateway protokoly společně se zbytkem požadavku a odpovědi.

REST API : čtyři koncové body, na které tyto příklady cílí
Workers Bindings, env.AI.run reference
Poskytovatel Anthropic
Poskytovatel OpenAI
Poskytovatel Grok (xAI)
Poskytovatel Perplexity
Poskytovatel Parallel
Unified Billing

Web Search

Podporovaní poskytovatelé

Webové vyhledávání Anthropic

Webové vyhledávání OpenAI

vyhledávání na webu xAI

Webové vyhledávání Alibaba (Qwen)

Poskytovatelé zaměření na vyhledávání

Perplexity

Parallel

Modely bez podpory webového vyhledávání

Ceny a protokolování

Související zdroje