groq-install-auth

用途：安装官方 Groq SDK 并配置 API Key 认证。Groq 通过 api.groq.com/openai/v1/ 提供 OpenAI 兼容的 REST API，用于其 LPU 硬件上的快速 LLM 推理。

前置条件：Node.js 18+ 或 Python 3.8+；包管理器（npm、pnpm 或 pip）；console.groq.com 上的 Groq 账号；从 GroqCloud 控制台（Settings > API Keys）获取的 API Key。

主要步骤：

1. 安装 SDK：TypeScript/JavaScript 执行 npm install groq-sdk；Python 执行 pip install groq。
2. 获取 API Key：在 console.groq.com/keys 点击 Create API Key，复制以 gsk_ 开头的密钥并安全保存，之后无法再次查看。
3. 配置环境：写入 .env 前先将 .env 加入 .gitignore，然后 export GROQ_API_KEY="gsk_your_key_here"，或 echo 'GROQ_API_KEY=gsk_your_key_here' >> .env。
4. 验证连接：运行脚本列出可访问模型，例如 TypeScript 中 new Groq({ apiKey: process.env.GROQ_API_KEY }) 后调用 groq.models.list() 并打印模型 id。成功会输出模型列表；若返回 401 则认证失败。

SDK 默认行为：未传入 apiKey 时自动读取环境变量 GROQ_API_KEY。Groq 使用单一 gsk_ 密钥类型，拥有完整 API 访问权限，无读写作用域区分。

常见错误：401 Invalid API Key（密钥缺失、撤销或输入错误，需在控制台核对）；MODULE_NOT_FOUND groq-sdk（未安装，运行 npm install groq-sdk）；ModuleNotFoundError: No module named 'groq'（运行 pip install groq）；ENOTFOUND api.groq.com（网络或 DNS 问题，检查连接与防火墙）。

示例：Node 项目可执行 npm install groq-sdk、export GROQ_API_KEY="gsk_your_key_here"、node --env-file=.env verify.mjs；Python 项目可执行 pip install groq、export GROQ_API_KEY="gsk_your_key_here"、python verify.py。也可复用现有 OpenAI 代码库，将 baseURL 覆盖为 https://api.groq.com/openai/v1 并传入 gsk_ 密钥。

限制：资料未提供具体收费、价格、速率限制或平台支持范围等信息。