跳转到内容
搜索文档
↵选择
↑↓导航
ESC关闭

快速入门

最后更新 查看 MarkdownAgent 设置

本指南将介绍如何设置并使用你的第一个 AI Gateway。

获取账户 ID 和身份验证令牌

在发送请求之前，你需要准备以下两项：

  1. Account ID — 在 Cloudflare 仪表板中查找。
  2. Cloudflare API 令牌 — 创建 API 令牌，并授予 AI Gateway - Read、AI Gateway - Edit 和 Workers AI - Read 权限。

发送第一个请求

运行以下命令，通过 AI Gateway 发送第一个请求。此示例调用 Workers AI 模型，需要使用 @cf/ 模型前缀和 cf-aig-gateway-id 标头。

# Run `wrangler auth token` to get an auth token to replace $CLOUDFLARE_API_TOKEN,
# and `wrangler whoami` to replace $CLOUDFLARE_ACCOUNT_ID.
curl -X POST "https://api.cloudflare.com/client/v4/accounts/$CLOUDFLARE_ACCOUNT_ID/ai/v1/chat/completions" \
  --header "Authorization: Bearer $CLOUDFLARE_API_TOKEN" \
  --header "cf-aig-gateway-id: default" \
  --header "Content-Type: application/json" \
  --data '{
    "model": "@cf/moonshotai/kimi-k2.6",
    "messages": [
      {
        "role": "user",
        "content": "What is Cloudflare?"
      }
    ]
  }'

手动创建 gateway

你也可以通过仪表板或 API 手动创建具有自定义名称和配置的 gateway。

Go to AI Gateway ↗
  1. 登录 Cloudflare 仪表板 ↗ 并选择你的账户。
  2. 前往 AI > AI Gateway。
  3. 选择 Create Gateway（创建网关）。
  4. 输入 Gateway name（网关名称）。注意：网关名称最多 64 个字符。
  5. 选择 Create（创建）。

要使用 API 设置 AI Gateway：

  1. 创建 API token，并授予以下权限：

    • AI Gateway - Read
    • AI Gateway - Edit

  2. 获取你的 Account ID。

  3. 使用该 API token 和 Account ID，向 Cloudflare API 发送 POST 请求。

提供商身份验证

使用以下选项之一对上游 AI 提供商进行身份验证：

  • Unified Billing（统一计费）： 使用 AI Gateway 计费来支付和验证推理请求。请参阅统一计费。
  • BYOK（存储密钥）： 将你的提供商 API 密钥存储在 Cloudflare，AI Gateway 将在运行时包含这些密钥。请参阅 BYOK。
  • 请求标头： 像往常一样在请求标头中包含你的提供商 API 密钥（例如 Authorization: Bearer <OPENAI_API_KEY>）。

集成选项

REST API

通过同一个 Cloudflare API 调用任何模型——无论托管在 Cloudflare 上还是第三方提供商。无需提供商 SDK 或 API 密钥——身份验证和计费通过你的 Cloudflare 账户处理。提供三个端点：/ai/run 适用于所有模态，/ai/v1/chat/completions 兼容 OpenAI SDK，/ai/v1/responses 适用于智能体工作流。

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

请参阅 REST API 了解详情和示例。

提供商专用端点

如需与特定 AI 提供商直接集成，请使用专用端点，这些端点保留原始提供商的 API 架构，同时添加 AI Gateway 功能。

https://gateway.ai.cloudflare.com/v1/{account_id}/{gateway_id}/{provider}

可用提供商：

后续步骤

这篇文档对您有帮助吗？