Groq API 快速入门

前提条件与依赖项

在仪表板生成您的 groq API 密钥。您可以使用 Google 登录或使用电子邮件和密码登录。无需手机号码。密钥将立即显示，方便复制粘贴。

确保您的环境支持官方 OpenAI SDK。我们的 base URL 是 HTTPS://api.apigroq.com/v1。任何接受标准 OpenAI 端点的客户端都可以使用。您不需要安装额外的中间件。

认证您的 groq API 密钥

将密钥作为 Bearer 令牌放入 Authorization 请求头中。这将验证对 uncensored AI 服务的每个请求。如果密钥无效，您将收到 401 错误。如果余额不足，您将收到 402 错误。

• 标头： Authorization: Bearer YOUR_API_KEY
• 不要在客户端代码中暴露密钥。

发送您的第一个补全请求

向以下地址发送 POST 请求 /v1/chat/completions. 使用模型 ID uncensored. 该模型针对合法成人用途无审查地回答。设置 top_p to 1 and temperature to 0 for consistent results.

Copycurl https://api.apigroq.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "list dependencies in requirements.txt"}]
  }'

响应仅返回文本。不生成嵌入或图像。错误不会消耗您的预付款余额。

处理流式响应

使用服务器发送事件进行实时 token 交付。设置 stream: true 在请求中。每个数据块包含部分文本。最后一个数据块包含 token 使用详情。

Copystream = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Tell the story in second person."}],
    stream=True,
)
for chunk in stream:
    if chunk.choices and chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="", flush=True)

此方法降低了大型响应的感知延迟。您的客户端必须处理 data: 前缀并解析 JSON 对象。

Python SDK 集成

安装官方 OpenAI Python 包。使用我们的基础 URL 和密钥配置客户端。这允许直接无审查 LLM 的使用，无需经过 OpenRouter。

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.apigroq.com/v1", api_key="YOUR_KEY")

resp = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Summarise this thread without softening it."}],
)
print(resp.choices[0].message.content)

SDK 自动处理重试和 JSON 解析。您还可以通过设置启用 JSON 模式 response_format 到 {"type": "json_object"}.

Node SDK 和限制

类似地，使用 Node.js OpenAI 客户端。将 base URL 设置为我们的端点。密切监控您的速率限制。

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.apigroq.com/v1", apiKey: process.env.API_KEY });

const resp = await client.chat.completions.create({
  model: "uncensored",
  messages: [{ role: "user", content: "Draft a villain monologue for my game." }],
});
console.log(resp.choices[0].message.content);

每个密钥每分钟限制 300 次请求。您可同时拥有 8 个并发请求。请求体必须保持在 8 MB 以下。上下文窗口总计为 100,000 个 token。除非另有说明，最大输出为 16,000 个 token。