Gemma-API: Erste Anfrage in fünf Minuten

Basis-URL & Authentifizierung

Erstelle zunächst ein Konto auf der Seite API-Schlüssel erhalten. Du benötigst nur eine E-Mail-Adresse und ein Passwort; keine Telefonnummer oder Kreditkarte ist erforderlich, um das kostenlose Testguthaben zu aktivieren. Nach der Registrierung wird dein API-Schlüssel sofort angezeigt. Kopiere diesen Schlüssel und speichere ihn sicher. Verwende ihn im Authorization-Header als Bearer-Token für alle Anfragen. Die Basis-URL für alle Endpunkte lautet https://api.gemma4api.com/v1. Diese URL funktioniert mit jedem Standard-OpenAI-kompatiblen Client, sodass du Anbieter wechseln kannst, indem du einfach die Basis-URL und den API-Schlüssel in deiner Konfiguration änderst.

Erste Anfrage

Sende deine erste Anfrage mit curl, um die Konnektivität zu überprüfen. Ersetze YOUR_API_KEY durch deinen tatsächlichen Schlüssel. Die Modell-ID ist uncensored. Diese einfache Text-in, Text-out-Anfrage bestätigt, dass deine Authentifizierung korrekt ist und das Modell antwortet. Wenn du eine JSON-Antwort mit einem choices-Array erhältst, ist deine Einrichtung abgeschlossen. Du kannst nun mit der SDK-Integration für komplexere Workflows fortfahren.

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-Integration

Installiere das offizielle OpenAI-Python-Paket. Lege die Basis-URL und den API-Schlüssel als Umgebungsvariablen fest oder übergebe sie direkt an den Client-Konstruktor. Verwende die Modell-ID uncensored, um sicherzustellen, dass du unsere spezifische Instanz aufrufst. Dieser Ansatz stellt sicher, dass dein Code mit Standard-OpenAI-Mustern kompatibel bleibt und gleichzeitig unser unzensiertes Modell für die Inhaltsgenerierung nutzt. Das SDK behandelt Wiederholungen und JSON-Parsing automatisch.

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-Integration

Installiere für JavaScript-Umgebungen das OpenAI Node.js-Paket. Konfiguriere den Client mit der Basis-URL https://api.gemma4api.com/v1 und deinem API-Schlüssel. Verwende die Modell-ID uncensored in deinen Completion-Aufrufen. Diese Einrichtung ermöglicht es dir, standardmäßige OpenAI-kompatible Code-Strukturen beizubehalten und gleichzeitig von der spezifischen Modell-Verwendung auf unseren Servern zu profitieren. Stelle sicher, dass du asynchrone Antworten korrekt innerhalb deiner Node.js-Event-Loop behandelst.

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

Streaming-Antworten

Aktiviere Streaming, indem du den Parameter stream in deiner API-Anfrage auf true setzt. Dies gibt einen Server-Sent Events (SSE)-Stream zurück, der es dir ermöglicht, Token anzuzeigen, während sie generiert werden. Dies ist ideal für Chat-Schnittstellen, bei denen Latenz eine Rolle spielt. Jeder Chunk enthält einen partiellen Delta der Antwort. Verarbeite das Stream-End-Ereignis, um zu wissen, wann die Generierung abgeschlossen ist. Diese Methode reduziert die wahrgenommene Latenz erheblich im Vergleich zum Warten auf die vollständige Antwort.

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)

Limits, Fehler & Kontextfenster

Deine Anfragen unterstützen ein Kontextfenster von 100.000 Token für Prompt und Completion zusammen. Das Ratenlimit beträgt 300 Anfragen pro Minute pro Schlüssel, mit einer maximalen Request-Body-Größe von 8 MB. Häufige Fehler sind 401 für ungültige Schlüssel, 402 wenn dein Prepaid-Guthaben aufgebraucht ist, und 429 wenn du das pro Minute geltende Limit überschreitest. Das Erzeugen eines neuen API-Schlüssels widerruft den alten, setzt aber den Ratenzähler nicht zurück. Stelle sicher, dass dein Client diese HTTP-Statuscodes angemessen verarbeitet, um einen reibungslosen Betrieb zu gewährleisten.