REST API

本指南将指导您设置和部署您的第一个 Workers AI 项目。您将使用 Workers AI REST API 来体验大型语言模型 (LLM)。

先决条件

如果您还没有 Cloudflare 帐户 ↗，请注册一个。

1. 获取 API 令牌和账户 ID

您需要您的 API 令牌和账户 ID 才能使用 REST API。

要获取这些值：

1. 登录 Cloudflare 仪表板 ↗并选择您的帐户。
2. 转到 AI > Workers AI。
3. 选择使用 REST API。
4. 获取您的 API 令牌：
   1. 选择创建 Workers AI API 令牌。
   2. 查看预填信息。
   3. 选择创建 API 令牌。
   4. 选择复制 API 令牌。
   5. 保存该值以备将来使用。
5. 对于获取账户 ID，复制账户 ID 的值。保存该值以备将来使用。

Note

如果您选择创建 API 令牌而不是使用模板，该令牌将需要 Workers AI - 读取 和 Workers AI - 编辑 的权限。

2. 通过 API 运行模型

创建 API 令牌后，在请求中使用您的 API 令牌进行身份验证并向 API 发出请求。

您将使用执行 AI 模型端点来运行 @cf/meta/llama-3.1-8b-instruct 模型：

curl https://api.cloudflare.com/client/v4/accounts/{ACCOUNT_ID}/ai/run/@cf/meta/llama-3.1-8b-instruct \
  -H 'Authorization: Bearer {API_TOKEN}' \
  -d '{ "prompt": "Where did the phrase Hello World come from" }'

替换 {ACCOUNT_ID} 和 {API_token} 的值。

API 响应将如下所示：

{
  "result": {
    "response": "Hello, World first appeared in 1974 at Bell Labs when Brian Kernighan included it in the C programming language example. It became widely used as a basic test program due to simplicity and clarity. It represents an inviting greeting from a program to the world."
  },
  "success": true,
  "errors": [],
  "messages": []
}

此示例执行使用 @cf/meta/llama-3.1-8b-instruct 模型，但您可以使用 Workers AI 模型目录中的任何模型。如果使用其他模型，您需要将 {model} 替换为您想要的模型名称。

完成本指南后，您已创建了一个 Cloudflare 帐户（如果您还没有），并创建了一个授予您帐户 Workers AI 读取权限的 API 令牌。您使用终端的 cURL 命令执行了 @cf/meta/llama-3.1-8b-instruct 模型，并在 JSON 响应中收到了对您提示的回答。

相关资源

• 模型 - 浏览 Workers AI 模型目录。
• AI SDK - 了解如何与 AI 模型集成。