Gemma API 密钥文档

认证和基础 URL

使用您的唯一 API 密钥认证每个请求。基础 URL 为 HTTPS://api.gemmaapikey.com/v1，您在 Authorization 头中发送密钥。这适用于任何 OpenAI 兼容客户端，只需更改 base_url 和 API 密钥。如果丢失，可从仪表板生成新密钥。旧密钥将立即失效。错误和拒绝不会消耗您的预付费额度。

首次请求

向 /v1/chat/completions 发送 POST 请求，使用模型 id "uncensored"。在 messages 数组中包含你的 system prompt 和用户消息。模型生成文本响应，在合法成人用途下不进行内容拒绝。

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.gemmaapikey.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)

设置 temperature 和 top_p 以控制随机性。使用停止序列提前终止生成。如果启用流式传输，响应将在最后一个数据块中包含令牌使用情况。

Node SDK 集成

安装官方 OpenAI Node.js SDK。使用您的 API 密钥和本指南中的基础 URL 对其进行配置。使用您的提示调用 chat.completions.create 方法。

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.gemmaapikey.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);

这种方法使成本保持可预测，因为你只为使用的令牌付费。预存信用额按实际使用情况扣费。没有月费。你可以随时使用加密货币充值。

流式响应

通过在请求中将 stream 设置为 true 启用流式传输。API 返回服务器发送事件（SSE）块。每个块包含部分文本，直到最后一个块包含令牌用量。

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)

流式传输降低了长响应的感知延迟。它还允许您实时向用户显示进度。上下文窗口支持 100,000 个令牌用于提示和完成组合。

速率限制与上下文

每个密钥每分钟限 300 次请求。最多只能同时运行 8 个请求。请求体不得超过 8 MB。这些限制确保所有用户的性能稳定。

该模型支持函数调用、JSON 模式以及 seed 和 presence_penalty 等标准参数。每次请求的最大输出为 16,000 个 token。如果您未设置 max_tokens，则默认为 2,048。

错误与故障排除

401 错误表示您的 API 密钥无效或已过期。请查看仪表板中的有效密钥。402 错误表示预付费余额不足。通过加密货币充值以继续使用。429 错误表示您触发了速率限制。等待几秒后重试。

错误不会消耗您的信用余额。如果出现重复扣费，请使用支持页面进行修复。信用余额永不过期，您可以随时充值。

cURL

Copycurl https://api.gemmaapikey.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Return the current system status"}]
  }'