Cerebras 是晶圆级引擎(Wafer Scale Engine)背后的公司,其 Cerebras Inference 服务以极快的输出速度著称。该 API 兼容 OpenAI。新用户可以领取 试用额度,足以进行开发测试和运行演示。
先说关键限制(依据 Cerebras 官方文档,2026 年 9 月):
- 必须先添加支付卡,额度才会发放。添加卡片不会产生任何扣费,但如果没有卡片,你的余额将保持为 0,每次 API 调用都会返回
402 Payment required - 试用额度自发放之日起 30 天后过期。未使用的额度届时会失效,且不会重新发放。Cerebras 目前没有永久免费套餐
- 试用套餐仅包含部分模型,且速率限制很严格(每个模型每分钟 5 次请求)
如果这些条款对你来说可以接受,请继续阅读。本文将带你完成注册、添加卡片以领取额度、获取 API 密钥,以及用几行代码发起第一次调用。
你需要准备
- 一个 Google 账号(GitHub 账号或工作邮箱也可以,流程几乎相同)
- 一张能通过在线验证的支付卡(Visa、Mastercard 等),用于领取试用额度
- 能够访问
cloud.cerebras.ai和api.cerebras.ai的网络环境
第 1 步:打开控制台并使用 Google 登录
在浏览器中打开 https://cloud.cerebras.ai/。页面中间会显示“注册或登录”。注册和登录共用同一个入口,因此直接点击 GOOGLE 即可。
右下角会弹出 Cookie 提示。选择“全部拒绝”(仅保留必要的 Cookie)不会产生任何影响。
第 2 步:选择你的 Google 账号
你会进入 Google 的账号选择页面。点击你想用于注册的账号。如果你尚未在此浏览器中登录 Google,则会先要求你输入 Google 凭据。

第 3 步:允许 cerebras.ai 读取你的基本资料
Google 会询问是否允许 cerebras.ai 访问你的姓名、个人资料照片和电子邮件地址。这是第三方登录的标准授权:仅可读取这三项信息。它不会获取你的 Google 密码,也无法访问你的 Drive 或电子邮件。如果确认无误,请点击“继续”。

如果你以后不再使用该服务,可以随时在你的 Google 账号中通过“安全性 → 第三方应用和服务”撤销此访问权限。
第 4 步:填写基本信息
首次登录时,你会看到一个入门页面“输入详细信息”:
- 全名(必填):已根据你的 Google 个人资料预先填写,你可以将其改为任意内容
- 公司(可选):个人测试可留空
然后点击 继续。

第 5 步:选择试用额度并添加卡片
接下来是“添加额度以开始使用”,有两个选项:
- 按需付费:充值 并获得 额外额度,享有更高速率限制和优先权
- 从有限的免费额度开始: 试用额度,模型有限,速率限制低
用于测试时,请选择 从有限的免费额度开始,然后点击 添加支付方式,并按提示添加支付卡。只有在卡片验证通过后, 才会到账;添加卡片本身不会产生任何扣费。

注意:底部的“跳过并进入控制台”链接可让你跳过此步骤,直接进入控制台。你的账号和 API 密钥都能正常工作,但账号完全没有额度,每次调用都会返回 402 Payment required。该选项写着“免费额度”,却没有说明发放额度需要绑定卡片,很容易被误读。如果你跳过了,也没关系——稍后在控制台的 Billing 页面添加卡片即可。
第 6 步:获取 API 密钥
进入控制台后,系统已经创建了一个“Default Project”,并带有一个默认 API 密钥:
- 在“Get started”页面,点击 COPY API KEY 可直接复制
- 或者打开左侧导航中的 API keys 来查看、创建或删除密钥。值得按用途创建不同的密钥——例如“local testing”“project X”——这样即使某个密钥泄露,也只需删除那一个
Cerebras 密钥以 csk- 开头。请像对待账号密码一样对待密钥:不要将其粘贴到聊天群、截图或公开仓库中;应将其保存在环境变量或服务端配置中。如果某个密钥泄露,请在 API keys 页面删除它并创建新密钥。
你还会用到左侧导航中的其他几个页面:
- Billing:添加卡片、查看剩余额度和到期时间
- Limits:你账号的按模型速率限制。根据官方文档,试用套餐的
gpt-oss-120b和qwen-3.8-27b均为每分钟 5 次请求、每分钟 30k 未缓存 token;其他模型请以此处显示为准 - Analytics:使用统计
第 7 步:发起第一次请求
该 API 在 https://api.cerebras.ai/v1 上使用 OpenAI 的 Chat Completions 协议。先把密钥放入环境变量:
export CEREBRAS_API_KEY="csk-your-key"
列出当前可用的模型:
curl https://api.cerebras.ai/v1/models \n -H "Authorization: Bearer $CEREBRAS_API_KEY"
发送聊天消息(gpt-oss-120b 可在试用套餐中使用;模型会不断增减,因此请以上一步列出的列表为准):
curl https://api.cerebras.ai/v1/chat/completions \n -H "Authorization: Bearer $CEREBRAS_API_KEY" \n -H "Content-Type: application/json" \n -d '{
"model": "gpt-oss-120b",
"messages": [{"role": "user", "content": "Introduce yourself in one sentence"}]
}'
对于 Python,只需使用官方 OpenAI SDK,并替换 base_url:
from openai import OpenAI
import os
client = OpenAI(
base_url="https://api.cerebras.ai/v1",
api_key=os.environ["CEREBRAS_API_KEY"],
)
resp = client.chat.completions.create(
model="gpt-oss-120b",
messages=[{"role": "user", "content": "Introduce yourself in one sentence"}],
)
print(resp.choices[0].message.content)
任何支持“OpenAI 兼容 API”的客户端或框架(聊天客户端、LangChain、AI 网关)都以相同方式连接:将基础 URL 设为 https://api.cerebras.ai/v1,并将密钥设为你的 csk- 密钥。如果客户端有“提供商 / 协议”选项,请务必选择 Cerebras,或填入上面的基础 URL——否则请求可能会发往 OpenAI 的官方端点,并收到 OpenAI 的 401 响应。
故障排除
- 402 Payment required:账号上没有可用额度。可能是未添加卡片(额度从未发放)、额度已用完,或 30 天有效期已过。请在 Billing 页面添加卡片或充值。
- 401 Wrong API Key:密钥错误、包含多余空白字符,或已被删除。
- 提示 platform.openai.com 的 401:请求从未到达 Cerebras——而是发往了 OpenAI。请检查客户端中的基础 URL 或提供商设置。
- 429:触发了速率限制。试用套餐每分钟仅允许 5 次请求,因此批处理任务需要留出间隔或使用重试退避。
- Model not found:Cerebras 会新增和下线模型。请以
/v1/models的列表为准;不要从旧文章中复制模型名称。
最后一点说明
试用额度旨在让每位开发者都能试用该服务。注册多个账号来叠加试用额度违反服务条款——一旦被发现,相关账号会被一并封禁,严重情况下,用于登录的 Google 账号也可能受到影响。个人测试一个账号就足够了;如果使用量增长,升级到付费套餐会更省心。
有关额度、到期规则和速率限制,请以官方文档为准:Cerebras 速率限制。