如何获取免费的 Groq API 密钥
如何获取免费的 Groq API 密钥
无需信用卡即可获取免费的 Groq API 密钥：在 GroqCloud 中创建密钥，调用 GPT-OSS 或 Qwen 模型，并在 Free 套餐的速率限制内使用。
耗时 5 分钟。你需要 GroqCloud 账户（console.groq.com）。最后检查于 2026 年 10 月 13 日。Groq 在自己的推理硬件上运行开放权重模型，并通过一个基本兼容 OpenAI 客户端库的 API 提供服务。每个 GroqCloud 组织都从 Free 套餐开始：在控制台创建密钥，并在各模型速率限制内调用托管模型。只有升级到付费 Developer 套餐时才需要付款方式。
你将获得
- 对 Groq Free 套餐表中模型的限速访问。截至 2026 年 10 月，包括文本模型 openai/gpt-oss-120b、openai/gpt-oss-20b 和 qwen/qwen3.8-27b，语音转文本模型 whisper-large-v3 和 whisper-large-v3-turbo，Orpheus 文本转语音模型，以及审核模型 openai/gpt-oss-safeguard-20b 和 Llama Prompt Guard 2。
- 截至 2026 年 10 月的 Free 套餐限制：在 GPT-OSS 120B、GPT-OSS 20B 和 Qwen 3.8 27B 模型上，每分钟 30 次请求（RPM）、每天 1,000 次请求（RPD）、每分钟 8,000 个 token（TPM）、每天 200,000 个 token（TPD）。Whisper 允许 20 RPM、2,000 RPD 和每小时 7,200 音频秒（每天 28,800）。
- 位于 https://api.groq.com/openai/v1 的 OpenAI 兼容端点，以及 Groq 自有的 Python 和 TypeScript SDK。
- 缓存的提示 token 不计入速率限制。
- 除非升级到付费 Developer 套餐，否则无需付款方式。模型阵容和限制会变化，因此请查看 Groq 速率限制页面上的实时表格。完整详情见 [Groq 免费套餐](/offer/groq-free-tier/) 页面。
步骤
- 前往 console.groq.com 注册或登录。你的账户从 Free 套餐开始。
- 打开 API Keys 页面（console.groq.com/keys）并创建密钥。将其复制到安全的地方。
- 将密钥保存为环境变量，例如在 ~/.zshrc 或 ~/.bashrc 中设置 export GROQ_API_KEY=your_key。Groq 的 SDK 会读取 GROQ_API_KEY。
- 安装 SDK：Python 使用 pip install groq，JavaScript 使用 npm install --save groq-sdk。如果你的代码已经使用 OpenAI SDK，可继续使用，并将 base URL 设为 https://api.groq.com/openai/v1，同时使用你的 Groq 密钥。
- 向 Free 套餐表中的模型发送测试聊天补全请求，例如 openai/gpt-oss-20b 或 openai/gpt-oss-120b。Groq 文档中的一些示例仍使用 llama-3.3-70b-versatile；Groq 的弃用页面列出该模型和 llama-3.1-8b-instant 自 2026 年 8 月 16 日起已停止供免费和 Developer 使用。
- 在构建任何依赖用量的东西之前，请在 Settings > Limits（console.groq.com/settings/limits）下检查你组织的确切限制。切勿将密钥提交到代码仓库，或将其放入客户端代码中发布。
限制与注意点
- 每分钟 token 上限较低。主要文本模型的 8,000 TPM 足以用于测试和轻量应用，但长提示或并行请求会很快触达上限。任何限制都可能先触发：一分钟内 30 个小请求就会触发限制，即使你远低于 token 上限。
- 限制按组织计算，而非按用户或密钥。同一组织中的额外密钥共享同一配额。
- 并非每个模型都有相同限制。截至 2026 年 10 月，openai/gpt-oss-safeguard-20b 上限为 3 RPM 和 2,000 TPM，Orpheus TTS 模型为 10 RPM 和 100 RPD。Groq 指出可能存在例外；你的 Limits 页面为准。
- 预览模型可能消失。Groq 将 qwen/qwen3.8-27b 和其他几个模型标记为 preview，用于评估，可能随时被停止提供。生产模型会获得弃用通知和替代方案，但也会退役。
- 数据处理。Groq 表示默认不保留推理输入和输出，但可能将其记录最多 30 天，以排查可靠性问题或调查滥用。任何客户都可以在 Settings > Data Controls 下开启 Zero Data Retention。
- 升级需要付费。Developer 套餐提高限制，并增加 Batch 和 Flex 处理，按用量计费。它需要信用卡、美国银行账户或 SEPA 借记账户。
其他免费 LLM API
如果 Groq 的限制或模型列表不适合，另外两家提供商提供免费调用模型的方式：
- Mistral：Mistral Studio 以 Free 模式启动，启用 API 访问且无需信用卡。使用量和速率限制按模型适用，并显示在 Mistral Admin Panel 的 Limits 页面。Free 套餐没有每月 API 额度。参见 [Mistral AI 免费套餐](/offer/mistral-ai-free-plan/)。
- Cerebras：添加付款方式可获得一次性 5 美元额度，该额度在激活后 30 天过期。你不会被自动收费或转为付费使用，额度用完后访问会暂停。免费试用限制为每模型 5 RPM、30,000 未缓存 TPM 和每天 100 万 token。参见 [Cerebras Inference 免费试用](/offer/cerebras-inference-free-trial/)。关于 Google 的模型，参见[如何获取免费的 Gemini API 密钥](/learn/free-gemini-api-key/)。并排比较参见[免费 LLM API 对比](/compare/free-llm-apis)。
如果无法使用
- 429 Too Many Requests：你触发了 RPM、RPD、TPM 或 TPD 限制。retry-after 头会说明需要等待多少秒；添加带退避的重试。x-ratelimit-remaining-requests 头跟踪你的每日请求数，x-ratelimit-remaining-tokens 跟踪你的每分钟 token 数。
- 401 Unauthorized：密钥缺失或无效。检查运行代码的 shell 中是否设置了 GROQ_API_KEY，或创建新密钥。
- 针对某个模型返回 403 Forbidden：管理员可能已在模型权限下限制了你组织或项目可用的模型。
- 向旧模型 ID 发送请求会失败：该模型已退役。查看 Groq 的弃用页面以获取推荐的替代模型。
- OpenAI 风格代码返回 400：Groq 拒绝 logprobs、logit_bias、t