Gemma API：5 分钟内发起首个请求

基础 URL 与身份验证

首先在获取 API 密钥页面创建账户。你只需提供电子邮件和密码；无需电话号码或信用卡即可激活试用额度。注册后，你的 API 密钥将立即显示。复制此密钥并安全存储。在Authorization请求头中将其作为 Bearer token 使用。所有接口的 base URL 为https://api.gemma4api.com/v1。此 URL 适用于任何标准的 OpenAI 兼容客户端，你只需在配置中更改 base URL 和 API 密钥即可切换提供商。

首次请求

使用 curl 发送您的第一个提示词以验证连通性。将 YOUR_API_KEY 替换为您的实际密钥。模型标识符为 uncensored。这个简单的文本输入、文本输出请求可确认您的身份验证正确且模型正在响应。如果您收到包含 choices 数组的 JSON 响应，则说明您的设置已完成。现在您可以继续集成 SDK 以处理更复杂的工作流。

Copycurl https://api.gemma4api.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Write a blunt product review of a cheap VPN."}]
  }'

Python SDK 集成

安装官方 OpenAI Python 包。设置 base URL 和 API 密钥环境变量，或直接将其传递给客户端构造函数。使用模型 IDuncensored以确保调用我们特定的实例。这种方法确保你的代码保持与标准 OpenAI 模式兼容，同时利用我们的无审查模型进行内容生成。SDK 会自动处理重试和 JSON 解析。

Copyfrom openai import OpenAI

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

Node.js SDK 集成

对于 JavaScript 环境，安装 OpenAI Node.js 包。使用 base URLhttps://api.gemma4api.com/v1和你的 API 密钥配置客户端。在你的补全调用中使用模型 IDuncensored。此设置允许你保持标准的 OpenAI 兼容代码结构，同时受益于托管在我们服务器上的特定模型行为。确保在 Node.js 事件循环中正确处理异步响应。

Copyimport OpenAI from "openai";

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

流式响应

在 API 请求中将stream参数设置为true以启用流式输出。这将返回服务器发送事件（SSE）流，允许你实时显示正在生成的 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)

限制、错误与上下文窗口

你的请求支持 100,000 token 的上下文窗口，包含提示词和补全的总和。速率限制为每个密钥每分钟 300 个请求，最大请求体大小为 8 MB。常见错误包括：401表示密钥无效，402表示你的预付额度已用完，以及429表示你超过了每分钟限制。重新生成 API 密钥会撤销旧密钥，但不会重置速率计数器。确保你的客户端适当处理这些 HTTP 状态码，以维持顺畅运行。