Skip to main content

Quickstart Guide 🚀

Willkommen beim Localmind Quickstart! In dieser Anleitung zeigen wir Ihnen, wie Sie in wenigen Minuten mit Localmind loslegen können.
Stellen Sie sicher, dass Sie einen gültigen API-Schlüssel haben, bevor Sie beginnen. Sie erhalten diesen nach der Registrierung in Ihrem Dashboard.
In diesem Guide lernen Sie:
  1. ✅ API-Schlüssel einrichten
  2. ✅ Erste API-Anfrage stellen
  3. ✅ Antworten verarbeiten
  4. ✅ Best Practices anwenden

Schritt 1: API-Schlüssel einrichten

Bevor Sie beginnen können, benötigen Sie einen API-Schlüssel von Localmind.
  1. Besuchen Sie app.localmind.ai
  2. Erstellen Sie ein kostenloses Konto
  3. Bestätigen Sie Ihre E-Mail-Adresse
  1. Navigieren Sie zu EinstellungenAPI-Schlüssel
  2. Klicken Sie auf Neuen Schlüssel erstellen
  3. Kopieren Sie den generierten Schlüssel (wird nur einmal angezeigt!)
Speichern Sie Ihren API-Schlüssel sicher! Er wird nicht erneut angezeigt.
Fügen Sie Ihren API-Schlüssel zu Ihren Umgebungsvariablen hinzu:
export LOCALMIND_API_KEY="ihr-api-schlüssel-hier"

Schritt 2: Erste API-Anfrage

Jetzt können Sie Ihre erste API-Anfrage stellen! Hier sind Beispiele in verschiedenen Sprachen:
curl -X POST https://api.localmind.ai/v1/chat/completions \
  -H "Authorization: Bearer $LOCALMIND_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4",
    "messages": [
      {
        "role": "user",
        "content": "Hallo! Kannst du mir helfen?"
      }
    ]
  }'

Schritt 3: Antwort verarbeiten

Die API gibt eine strukturierte JSON-Antwort zurück:
{
  "id": "chatcmpl-123",
  "object": "chat.completion",
  "created": 1677652288,
  "model": "gpt-4",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "Hallo! Gerne helfe ich Ihnen. Worum geht es?"
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 9,
    "completion_tokens": 12,
    "total_tokens": 21
  }
}
So extrahieren Sie die Antwort aus der JSON-Struktur:
response_data = response.json()
assistant_message = response_data["choices"][0]["message"]["content"]
print(assistant_message)

Schritt 4: Best Practices

Fehlerbehandlung

Implementieren Sie immer eine ordentliche Fehlerbehandlung für API-Anfragen.

Rate Limiting

Beachten Sie die Rate Limits und implementieren Sie Retry-Logik.

Sicherheit

Speichern Sie API-Schlüssel niemals im Code – verwenden Sie Umgebungsvariablen.

Logging

Protokollieren Sie Anfragen für Debugging und Monitoring.

Beispiel: Robuste Implementierung

import requests
import os
import time
from typing import Optional

class LocalmindClient:
    def __init__(self, api_key: Optional[str] = None):
        self.api_key = api_key or os.getenv("LOCALMIND_API_KEY")
        self.base_url = "https://api.localmind.ai/v1"
        if not self.api_key:
            raise ValueError("LOCALMIND_API_KEY muss gesetzt sein")
    
    def chat(self, message: str, model: str = "gpt-4", max_retries: int = 3):
        """Sende eine Chat-Nachricht mit Retry-Logik."""
        url = f"{self.base_url}/chat/completions"
        headers = {
            "Authorization": f"Bearer {self.api_key}",
            "Content-Type": "application/json"
        }
        data = {
            "model": model,
            "messages": [{"role": "user", "content": message}]
        }
        
        for attempt in range(max_retries):
            try:
                response = requests.post(url, json=data, headers=headers, timeout=30)
                response.raise_for_status()
                return response.json()
            except requests.exceptions.RequestException as e:
                if attempt == max_retries - 1:
                    raise
                time.sleep(2 ** attempt)  # Exponential backoff
        
        return None

# Verwendung
client = LocalmindClient()
response = client.chat("Hallo, Localmind!")
print(response["choices"][0]["message"]["content"])

Nächste Schritte

Glückwunsch! Sie haben erfolgreich Ihre erste API-Anfrage gestellt. Hier sind die nächsten Schritte:
Brauchen Sie Hilfe? Unser Support-Team steht Ihnen gerne zur Verfügung. Kontaktieren Sie uns unter support@localmind.ai oder besuchen Sie unsere Community.