Gemma API 金鑰文件

身份驗證與基礎 URL

使用您的唯一 API 金鑰來驗證每個請求。基礎 URL 為 HTTPS://api.gemmaapikey.com/v1，您在 Authorization 標頭中傳送金鑰。這適用於任何 OpenAI 相容的客戶端，只需更改 base_url 和 API 金鑰即可。如果您遺失了金鑰，請從儀表板產生一個新的。舊金鑰會立即停止運作。錯誤和拒絕不會消耗您的預付額度。

首次請求

向 /v1/chat/completions 發送 POST 請求，使用模型 id "uncensored"。在 messages 陣列中包含您的系統提示詞和使用者訊息。模型會生成文本回應，對於合法成人用途不會進行內容拒絕。

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 以控制隨機性。使用 stop sequences 提前停止生成。回應包含最後一個 chunk 中的 token 使用情況（如果啟用了串流）。

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);

此方法使成本保持可預測，因為你僅為使用的 token 付費。預付信用額按實際使用情況扣費。沒有月費。你可以隨時使用加密貨幣充值。

串流回應

在請求中將 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"}]
  }'