Zum Hauptinhalt springen

Documentation Index

Fetch the complete documentation index at: https://docs.apimart.ai/llms.txt

Use this file to discover all available pages before exploring further.

Einführung

Gemini CLI ist Googles offizielles Kommandozeilen-Tool, mit dem Entwickler vom Terminal aus mit Gemini-KI-Modellen interagieren können. Nach der Konfiguration der APIMart-API können Sie in Gemini CLI die fortschrittlichen Modelle von APIMart – GPT, Claude und Gemini – verwenden.

Voraussetzungen

Bevor Sie beginnen:
  1. Node.js und npm installiert
    Laden Sie sie von der Node.js-Website herunter und installieren Sie sie (v16 oder neuer empfohlen)
  2. APIMart-API-Schlüssel
    Melden Sie sich in der APIMart-Konsole an und kopieren Sie Ihren API-Schlüssel (beginnt mit sk-)
Tipp: Wenn Sie noch kein APIMart-Konto haben, registrieren Sie sich zuerst bei APIMart und erstellen Sie einen API-Schlüssel.

Schritt 1: Gemini CLI installieren

1.1 Globale Installation

Installieren Sie Gemini CLI global mit npm:
npm install -g @google/gemini-cli

1.2 Installation überprüfen

Prüfen Sie, ob die CLI verfügbar ist:
gemini --version
Wird eine Versionsnummer ausgegeben, war die Installation erfolgreich.
Tipp: Wenn der Befehl nicht gefunden wird, starten Sie das Terminal neu oder prüfen Sie Ihre globale npm-PATH-Konfiguration.

Schritt 2: APIMart-API konfigurieren

2.1 Temporäre Umgebungsvariablen

Zum Testen oder einmaligen Nutzen; Werte werden beim Schließen des Terminals gelöscht. Windows (PowerShell):
$env:GEMINI_API_KEY = "sk-xxxxxxxxxxxx"
$env:GEMINI_BASE_URL = "https://api.apimart.ai/v1"
macOS/Linux (Bash):
export GEMINI_API_KEY="sk-xxxxxxxxxxxx"
export GEMINI_BASE_URL="https://api.apimart.ai/v1"

2.2 Permanente Umgebungsvariablen (empfohlen)

Persistente Konfiguration, sodass neue Shells sie automatisch übernehmen. Windows (PowerShell):
  1. PowerShell als Administrator ausführen
  2. Benutzerumgebungsvariablen setzen:
[System.Environment]::SetEnvironmentVariable('GEMINI_API_KEY', 'sk-xxxxxxxxxxxx', 'User')
[System.Environment]::SetEnvironmentVariable('GEMINI_BASE_URL', 'https://api.apimart.ai/v1', 'User')
  1. PowerShell neu starten oder Variablen neu laden:
$env:GEMINI_API_KEY = [System.Environment]::GetEnvironmentVariable('GEMINI_API_KEY', 'User')
$env:GEMINI_BASE_URL = [System.Environment]::GetEnvironmentVariable('GEMINI_BASE_URL', 'User')
macOS/Linux (Bash):
  1. Bearbeiten Sie die rc-Datei Ihrer Shell:
# Bash
nano ~/.bashrc

# Zsh (Standard auf macOS)
nano ~/.zshrc
  1. Anhängen:
# APIMart Gemini CLI
export GEMINI_API_KEY="sk-xxxxxxxxxxxx"
export GEMINI_BASE_URL="https://api.apimart.ai/v1"
  1. Neu laden:
source ~/.bashrc   # Bash
source ~/.zshrc    # Zsh

2.3 .env-Datei verwenden

Erstellen Sie .env in Ihrem Projekt:
# .env
GEMINI_API_KEY=sk-xxxxxxxxxxxx
GEMINI_BASE_URL=https://api.apimart.ai/v1
Variablen vor dem Ausführen von Gemini laden: macOS/Linux:
export $(cat .env | xargs) && gemini chat
Windows (PowerShell):
Get-Content .env | ForEach-Object {
    $name, $value = $_.split('=')
    Set-Content env:\$name $value
}
gemini chat
Wichtig: - Ersetzen Sie sk-xxxxxxxxxxxx durch Ihren echten Schlüssel aus der APIMart-Konsole - Setzen Sie GEMINI_BASE_URL auf https://api.apimart.ai/v1, damit Gemini CLI mit APIMart spricht - Fügen Sie .env zu .gitignore hinzu, damit Schlüssel nicht committet werden

2.4 Konfiguration überprüfen

macOS/Linux:
echo $GEMINI_API_KEY
echo $GEMINI_BASE_URL
Windows (PowerShell):
echo $env:GEMINI_API_KEY
echo $env:GEMINI_BASE_URL
Sehen die Werte korrekt aus, war die Konfiguration erfolgreich.

Schritt 3: Gemini CLI verwenden

3.1 Grundlegender Chat

Interaktive Sitzung:
gemini chat
Einmaliger Prompt:
gemini "Give a short overview of the history of artificial intelligence"

3.2 Modell wählen

gemini chat --model gpt-4o
Oder:
gemini "Write a Python quicksort implementation" --model claude-sonnet-4-5-20250929

3.3 Prompts aus einer Datei lesen

gemini --input prompt.txt
Oder per Pipe:
cat prompt.txt | gemini

3.4 Ausgabe in eine Datei speichern

gemini "Generate a React component" --output component.jsx

Schritt 4: APIMart aus Ihrem Code aufrufen

4.1 Python SDK

import openai

# APIMart
openai.api_key = "sk-xxxxxxxxxxxx"  # Your APIMart API key
openai.api_base = "https://api.apimart.ai/v1"

response = openai.ChatCompletion.create(
    model="gemini-2.0-flash-exp",
    messages=[
        {"role": "user", "content": "Hi—please introduce yourself"}
    ]
)

print(response.choices[0].message.content)

4.2 JavaScript / TypeScript

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: "sk-xxxxxxxxxxxx",
  baseURL: "https://api.apimart.ai/v1",
});

async function main() {
  const completion = await client.chat.completions.create({
    model: "gemini-2.0-flash-exp",
    messages: [{ role: "user", content: "Hi—please introduce yourself" }],
  });

  console.log(completion.choices[0].message.content);
}

main();

4.3 cURL

curl https://api.apimart.ai/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-xxxxxxxxxxxx" \
  -d '{
    "model": "gemini-2.0-flash-exp",
    "messages": [
      {"role": "user", "content": "Hi—please introduce yourself"}
    ]
  }'

Schritt 5: Modell auswählen

Empfohlene Modelle

APIMart unterstützt viele Modelle; wählen Sie nach Aufgabe und Budget. Gemini
ModellnameModell-IDEigenschaftenGeeignet für
Gemini 2.0 Flashgemini-2.0-flash-expSchnell, multimodalSchnelle Antworten, Vision + Text
Gemini 2.5 Progemini-2.5-proStarke FähigkeitSchwierige Probleme, Analyse
Gemini 2.5 Flashgemini-2.5-flashSehr reaktionsschnellEchtzeit-Chat, Batch-Jobs
GPT
ModellnameModell-IDEigenschaftenGeeignet für
GPT-5gpt-5Top-KlasseReasoning, kreatives Schreiben
GPT-4ogpt-4oHohe QualitätAllgemeiner Chat, Inhalt
GPT-4o Minigpt-4o-miniKosteneffizientEinfache Aufgaben, hohes Volumen
Claude
ModellnameModell-IDEigenschaftenGeeignet für
Claude Sonnet 4.5claude-sonnet-4-5-20250929Starkes ReasoningCode, Logik
Claude Haiku 4.5claude-haiku-4-5-20251001Sehr schnellQ&A, Chat mit niedriger Latenz
Schnellauswahl: - 🚀 Google-Stil-Stack: gemini-2.0-flash-exp, gemini-2.5-pro - 💡 Coding: claude-sonnet-4-5-20250929, gpt-5 - 💰 Kosten: gpt-4o-mini, claude-haiku-4-5-20251001 - ⚡ Geschwindigkeit: gemini-2.0-flash-exp, gpt-4o-mini

Erweiterte Funktionen

Multimodal (Bilder)

Mit einem multimodalen Modell wie Gemini 2.0 Flash:
response = openai.ChatCompletion.create(
    model="gemini-2.0-flash-exp",
    messages=[
        {
            "role": "user",
            "content": [
                {"type": "text", "text": "What's in this image?"},
                {
                    "type": "image_url",
                    "image_url": {
                        "url": "https://example.com/image.jpg"
                    }
                }
            ]
        }
    ]
)

Streaming

Tokens streamen, sobald sie eintreffen:
stream = openai.ChatCompletion.create(
    model="gemini-2.0-flash-exp",
    messages=[{"role": "user", "content": "Write a short poem about spring"}],
    stream=True
)

for chunk in stream:
    if chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end='')

Parameter anpassen

Zufälligkeit und Länge formen:
response = openai.ChatCompletion.create(
    model="gemini-2.0-flash-exp",
    messages=[{"role": "user", "content": "Your question"}],
    temperature=0.7,        # randomness (0–2)
    max_tokens=2000,        # max output length
    top_p=0.9,              # nucleus sampling
    presence_penalty=0,     # topic diversity
    frequency_penalty=0     # repetition penalty
)

FAQ

Q1: „Invalid API key” oder Authentifizierungsfehler

  1. Schlüsselformat
    • Muss mit sk- beginnen
    • Beim Einfügen keine zusätzlichen Leerzeichen
  2. Umgebungsvariablen
    # macOS / Linux
    echo $GEMINI_API_KEY
    echo $GEMINI_BASE_URL
    
    # Windows PowerShell
    echo $env:GEMINI_API_KEY
    echo $env:GEMINI_BASE_URL
    
  3. Schlüsselstatus
    • Prüfen Sie den Schlüssel in der APIMart-Konsole
    • Stellen Sie sicher, dass Ihr Konto Guthaben hat

Q2: Wie verifiziere ich die API-Einrichtung?

import openai

openai.api_key = "sk-xxxxxxxxxxxx"
openai.api_base = "https://api.apimart.ai/v1"

try:
    response = openai.ChatCompletion.create(
        model="gemini-2.0-flash-exp",
        messages=[{"role": "user", "content": "test"}],
        max_tokens=10
    )
    print("✅ API configuration OK")
    print(f"Reply: {response.choices[0].message.content}")
except Exception as e:
    print(f"❌ API configuration failed: {e}")

Q3: Welche Sprachen werden unterstützt?

Jede Sprache, die HTTP-Anfragen senden kann, funktioniert mit APIMart:
  • Python – OpenAI SDK empfohlen
  • JavaScript / TypeScript – Node oder Browser
  • Java – HTTP-Client
  • Go – Stdlib oder Bibliotheken
  • PHP – cURL oder Guzzle
  • Ruby – HTTP-Gems
  • C# / .NETHttpClient
  • SwiftURLSession
  • Andere – alles mit HTTP

Q4: Wo sehe ich Nutzung und Abrechnung?

In der APIMart-Konsole:
  • 📊 Live-Aufrufstatistik
  • 💰 Kosten und Rechnungen
  • 📈 Nutzungstrends
  • 🔍 Anfrage-Logs
  • ⚙️ API-Schlüssel-Verwaltung

Q5: Häufige API-Fehler

FehlerWahrscheinliche UrsacheWas tun
401 UnauthorizedFalscher oder widerrufener SchlüsselSchlüssel in env / Konsole korrigieren
429 Too Many RequestsRate-LimitVerlangsamen oder Plan upgraden
500 Internal Server ErrorVorübergehendes ServerproblemSpäter erneut versuchen; bei Bestehen Support kontaktieren
insufficient_quotaGeringes GuthabenIn der Konsole aufladen

Best Practices

1. Wiederholungen und Backoff

import openai
import time

def call_with_retry(max_retries=3):
    for i in range(max_retries):
        try:
            response = openai.ChatCompletion.create(
                model="gemini-2.0-flash-exp",
                messages=[{"role": "user", "content": "Your question"}]
            )
            return response
        except openai.error.RateLimitError:
            if i < max_retries - 1:
                time.sleep(2 ** i)
                continue
            raise
        except Exception as e:
            print(f"Error: {e}")
            raise

response = call_with_retry()

2. Kostenkontrolle

def choose_model(complexity):
    if complexity == "simple":
        return "gpt-4o-mini"
    elif complexity == "medium":
        return "gemini-2.0-flash-exp"
    return "gpt-5"

model = choose_model("simple")
response = openai.ChatCompletion.create(
    model=model,
    messages=[{"role": "user", "content": "Your question"}],
    max_tokens=500
)

3. System-Prompts

response = openai.ChatCompletion.create(
    model="gemini-2.0-flash-exp",
    messages=[
        {
            "role": "system",
            "content": "You are an expert Python assistant who writes clear, efficient code."
        },
        {
            "role": "user",
            "content": "Implement quicksort for me"
        }
    ]
)

Funktionen

Mit Google AI Studio und APIMart erhalten Sie:
  • 🤖 Viele Modelle – GPT, Claude, Gemini und mehr
  • 🌍 OpenAI-kompatibel – vertraute Request/Response-Form
  • Leistung – niedrige Latenz, hohe Parallelität
  • 💰 Klare Preise – Pay-as-you-go
  • 📊 Beobachtbarkeit – Aufrufe in Echtzeit überwachen
  • 🔒 Sicherheit – unternehmensorientierte Schutzmaßnahmen
  • 🚀 Schnelle Integration – einfache HTTP/SDK-Aufrufe
  • 📚 Dokumentation – Leitfäden und Beispiele

Support


Mit APIMart loslegen

Erstellen Sie ein Konto, holen Sie sich einen API-Schlüssel und verwenden Sie mehrere KI-Modelle aus Google-AI-Studio-Workflows und darüber hinaus.