Gemma API：五分鐘內完成首次請求

基礎 URL 與認證

請先在 取得 API 金鑰 頁面建立帳戶。你只需要電子郵件和密碼；無需手機號碼或信用卡即可啟用免費試用額度。註冊完成後，系統會立即顯示你的 API 金鑰。複製此金鑰並安全儲存。在 Authorization 標頭中以 Bearer token 形式使用它來發送所有請求。所有端點的基礎 URL 為 https://api.gemma4api.com/v1。此 URL 適用於任何標準的 OpenAI 相容客戶端，允許你僅透過更改設定中的基礎 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 套件。設定基礎 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 套件。使用基礎 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 狀態碼，以維持順暢的運作。