API-Schlüssel für Gemini: holen, einrichten & testen

01OmniaKey-API-Schlüssel erstellen

Melden Sie sich an, öffnen Sie API Keys und erstellen Sie einen Schlüssel für Ihre Anwendung. Prüfen Sie Kontingent, Ablauf und Modelleinschränkungen. Laden Sie Guthaben auf, bevor Sie Generierungsanfragen starten.

02Schlüssel und API-URL setzen

Führen Sie die Befehle in Ihrem Terminal aus und ersetzen Sie den Platzhalter durch Ihren Schlüssel. Bewahren Sie den Schlüssel auf Ihrem Server oder in einem Secret Manager auf. Legen Sie ihn niemals in Browser-Code oder einem öffentlichen Repository ab.

export OMNIAKEY_API_KEY="YOUR_OMNIAKEY_API_KEY"
export OMNIAKEY_BASE_URL="https://api.omniakey.com/v1"

03Authentifizierung prüfen

Rufen Sie die Modellliste ab, ohne einen Generierungsjob zu starten. Eine erfolgreiche Antwort ist JSON mit einem data-Array. Das prüft den Schlüsselzugriff; es belegt nicht, dass jedes Modell für Ihr Konto freigeschaltet ist.

curl --fail-with-body "$OMNIAKEY_BASE_URL/models" \
  -H "Authorization: Bearer $OMNIAKEY_API_KEY"

04Anfrageformat des Modells verwenden

Wählen Sie ein Modell auf der Familienseite, kopieren Sie seine API-ID und folgen Sie der passenden API-Dokumentation. Die Authentifizierung allein prüft Ihre Generierungsparameter nicht.

Ihr Client muss das Protokoll des gewählten Modells unterstützen. Prüfen Sie die Modelldokumentation, bevor Sie zwischen Chat Completions, Responses oder einem anbietereigenen Endpunkt wechseln.

Beispiel-Generierungsanfrage (kostenpflichtig)

Diese Anfrage verwendet Ihr Kontoguthaben. Prüfen Sie zuerst den Preis des gewählten Modells. Das Beispiel folgt dem dokumentierten Anfrageformat; Ihr Konto benötigt weiterhin Zugriff auf das Modell.

curl --fail-with-body 'https://api.omniakey.com/v1beta/models/gemini-4-argon:generateContent' \
  -H "Authorization: Bearer $OMNIAKEY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "contents": [
    {
      "parts": [
        {
          "text": "Explain what an API key does in one sentence."
        }
      ]
    }
  ]
}'