通过 AI Gateway 全新的 REST API 调用任何 AI 模型

May 21, 2026

通过 AI Gateway 全新的 REST API 调用任何 AI 模型

AI Gateway 现在开始使用 api.cloudflare.com 上的 AI REST API。无论提供商是 OpenAI、Anthropic、Google 还是托管在 Workers AI 上，您都可以通过一个统一的 API 调用任何模型，并使用相同的端点和身份验证方式。共有四个端点可用：

POST /ai/run — 适用于所有模型和模态的通用端点
POST /ai/v1/chat/completions — 兼容 OpenAI SDK
POST /ai/v1/responses — 兼容 OpenAI Responses API
POST /ai/v1/messages — 兼容 Anthropic SDK

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": "openai/gpt-5.5",
    "messages": [{"role": "user", "content": "What is Cloudflare?"}]
  }'

所有的 AI Gateway 功能（日志记录、缓存、速率限制和护栏）都会自动应用。第三方模型将通过统一计费（Unified Billing）进行计费，因此您无需管理单独的提供商 API 密钥。

第三方模型请求将通过您账户的默认网关（Gateway）进行路由，该网关会在首次使用时自动创建。若要通过特定网关路由请求，请添加 cf-aig-gateway-id 标头。

如果您已经通过现有的 REST API 调用 Workers AI 模型，该路径（/ai/run/@cf/{model}）将继续有效。若要通过 AI Gateway 调用 Workers AI 模型，请使用 @cf/ 模型前缀（例如，@cf/moonshotai/kimi-k2.6）并包含 cf-aig-gateway-id 标头来指定要路由到的网关。

欲了解更多细节和示例，请参阅 REST API 文档。