Groq OpenAI 兼容 API
api
- EndpointEndpoint
https://api.groq.com/openai/v1- 认证Authentication
- Authorization: Bearer API key
额度与限制Limits
调用额度与限流按提供商当前控制台和官方文档为准；免费条件可能按模型、账号和地区变化。
前置条件Prerequisites
- 已注册 Groq ConsoleGroq Console
- 已创建 API keyAPI key
- 已阅读当前 Free Plan LimitsFree Plan Limits
操作步骤Steps
- 创建密钥
在 Groq Console 的 API Keys 页面创建密钥，并保存为 GROQ_API_KEY 环境变量。
- 确认模型与限制
从官方 Models 页面选择当前可用模型，再按 Rate Limits 页面控制 RPM、RPD 和 TPM。
操作Action：打开 https://console.groq.com/docs/models
- 发送测试请求
使用官方支持的模型 ID 发起一次短请求。
命令已在上方「快速上手」给出。The copyable command already appears in Quick start above.
预期结果Expected：返回 choices，并在超限时得到明确的 rate-limit 响应。
- Python SDK 示例
安装 OpenAI SDK；在运行环境设置 GROQ_API_KEY，示例代码通过环境变量读取密钥。
可复制命令Copyable commandpython -m pip install -U openai import os from openai import OpenAI client = OpenAI( api_key=os.environ["GROQ_API_KEY"], base_url="https://api.groq.com/openai/v1", ) response = client.chat.completions.create( model="openai/gpt-oss-20b", messages=[{"role": "user", "content": "用一句话解释 API 是什么。"}], ) print(response.choices[0].message.content)预期结果Expected：终端打印模型生成的回复；再到提供商控制台确认请求状态和额度扣减。
- Node.js SDK 示例
安装 OpenAI SDK；在运行环境设置 GROQ_API_KEY，示例代码通过环境变量读取密钥。
可复制命令Copyable commandnpm install openai import OpenAI from "openai"; const client = new OpenAI({ apiKey: process.env.GROQ_API_KEY, baseURL: "https://api.groq.com/openai/v1", }); const response = await client.chat.completions.create({ model: "openai/gpt-oss-20b", messages: [{ role: "user", content: "用一句话解释 API 是什么。" }], }); console.log(response.choices[0].message.content);预期结果Expected：Node.js 打印模型生成的回复；再到提供商控制台确认请求状态和额度扣减。
验证动作Validation
GET /openai/v1/models 返回 HTTP 200，并确认目标模型仍在官方模型列表。
常见问题Common issues
- 401：检查 API Key、环境变量和认证 Header。401： API Key、 Header。
- 404：从官方模型清单复制当前模型 ID，并确认 endpoint 与账号地域一致。404： ID， endpoint 。
- 429：查看当前限流和配额重置说明，降低请求频率后再重试。429： ， 。