公共端点 · Cloudflare AI Search docs

AI Search 公共端点允许你在无需认证的情况下暴露 AI Search 能力。这样你可以将 AI Search 集成到面向公众的应用中，或与外部用户共享。

有关可使用公共端点嵌入到网站上的预构建搜索与聊天组件，请参阅 UI snippets。

前提条件

为你的 AI Search 实例启用公共端点：

在 Cloudflare 仪表板中前往 AI Search。 Go to AI Search ↗
选择你的 AI Search 实例。
前往 Settings（设置） > Public Endpoint（公共端点）。
打开 Enable Public Endpoint（启用公共端点）。
复制公共端点 URL。

有关速率限制与 CORS 等配置选项，请参阅公共端点配置。

聊天补全

/chat/completions 端点会搜索你的数据源，并使用模型与检索到的上下文生成响应。它使用与 REST API 相同的 OpenAI 兼容格式。

curl https://<INSTANCE_ID>.search.ai.cloudflare.com/chat/completions \
  -H "Content-Type: application/json" \
  -d '{
    "messages": [
      {
        "content": "How do I configure AI Search?",
        "role": "user"
      }
    ]
  }'

完整选项列表请参阅 Chat Completions API 参考。

搜索

/search 端点会从你的数据源返回相关分块，而不生成响应。它使用与 REST API 相同的格式。

curl https://<INSTANCE_ID>.search.ai.cloudflare.com/search \
  -H "Content-Type: application/json" \
  -d '{
    "messages": [
      {
        "content": "How do I configure AI Search?",
        "role": "user"
      }
    ]
  }'

完整选项列表请参阅 Search API 参考。

后续步骤

UI snippets - 向网站添加预构建的搜索与聊天组件。
MCP - 使用 Model Context Protocol 连接 AI 智能体。
公共端点配置 - 配置速率限制、CORS 与安全设置。