Dokumentation

API-Schlüssel

Funktionsweise

Metamorfon arbeitet mit Ihren eigenen API-Schlüsseln (Modell Bring Your Own Key“, BYOK). Sie erstellen die Schlüssel direkt bei den Modellanbietern, die Sie nutzen möchten; die Abrechnung aller API-Aufrufe (Tokens, Kontingente, Abonnements) erfolgt ausschließlich über diese Anbieter und Ihr dortiges Konto. Metamorfon berechnet keine API-Aufrufe. Die Anwendung zeigt lediglich Nutzungsindikatoren in der Oberfläche an — Token-Verbrauch und geschätzte Kosten — um die Überwachung Ihrer Nutzung zu erleichtern.

Wo Sie Ihre Schlüssel eingeben

Gehen Sie zu Einstellungen > API-Schlüssel.

Für jeden Anbieter können Sie:

• Ihren API-Schlüssel einfügen
• ihn ein- oder ausblenden
• ihn validieren, um zu prüfen, ob er akzeptiert wird
• nach der Validierung die Liste der verfügbaren Modelle für Ihr Konto abrufen

Speicherung und Datenschutz

Ihre API-Schlüssel werden lokal auf Ihrem Gerät gespeichert — im Browser oder in der Desktop-Anwendung, je nach Ihrer Installation. Sie werden nicht an einen entfernten Metamorfon-Server gesendet. Sie dienen ausschließlich dazu, der Anwendung die Kommunikation mit den offiziellen APIs der von Ihnen konfigurierten Anbieter zu ermöglichen.

Lokales Backend und Validierung

Metamorfon verwendet einen lokalen Server (standardmäßig: http://127.0.0.1:8000) zur Validierung von API-Schlüsseln und zum Abrufen verfügbarer Modelle. Die Anwendung versucht, dieses Backend automatisch zu starten. Falls die Validierung fehlschlägt oder der Server nicht verfügbar erscheint:

• warten Sie einige Sekunden
• klicken Sie auf Erneut versuchen im Bereich API-Schlüssel
• stellen Sie sicher, dass kein anderes Programm Port 8000 verwendet
• konsultieren Sie bei anhaltenden Problemen die Dokumentation oder die in der Anwendung angezeigten Logs

Unterstützte Anbieter

Metamorfon unterstützt derzeit folgende Modellanbieter:

• OpenAI
• Anthropic
• Google
• Mistral
• xAI
• DeepSeek
• Cohere

Häufige Fehlermeldungen

Ungültiger oder abgelaufener Schlüssel, oder kein Modell verfügbar Prüfen Sie, ob der Schlüssel korrekt ist, zum richtigen Konto oder Projekt gehört, und ob mindestens ein kompatibles Modell für Ihr Abonnement oder Ihre Region aktiviert ist.

Kontingent überschritten oder Rate-Limit erreicht Prüfen Sie im Dashboard des Anbieters den Abrechnungsstatus, Nutzungslimits oder die Dienstverfügbarkeit.

Lokales Backend nicht erreichbar Stellen Sie sicher, dass der lokale Server korrekt läuft, dass Port 8000 frei ist, und versuchen Sie die Validierung erneut.

Sicherheits-Best-Practices

• Teilen Sie niemals einen API-Schlüssel im Klartext.
• Stellen Sie Ihre Schlüssel nicht in Screenshots, Foren oder Support-Tickets aus.
• Wenn ein Schlüssel kompromittiert ist, widerrufen Sie ihn sofort auf der Website des Anbieters und generieren Sie einen neuen.
• Verwenden Sie wenn möglich Schlüssel mit eingeschränkten Berechtigungen.

Für fortgeschrittene Nutzer

In benutzerdefinierten Konfigurationen — insbesondere wenn Sie das Backend selbst betreiben — können Umgebungsvariablen wie OPENAI_API_KEY, ANTHROPIC_API_KEY oder GOOGLE_API_KEY die manuelle Eingabe in der Oberfläche ergänzen oder ersetzen. Für den Standardbetrieb über die grafische Anwendung reicht der Bereich Einstellungen > API-Schlüssel aus.

Schnellstart

1. Installieren und starten Sie Metamorfon auf einem unterstützten System (Windows oder macOS).
2. Warten Sie, bis das lokale Backend läuft (siehe Lokales Backend). Die App startet es in der Regel automatisch; der Status wird in der Oberfläche angezeigt.
3. Öffnen Sie Einstellungen → API-Schlüssel, fügen Sie mindestens einen Schlüssel für einen Anbieter hinzu, validieren Sie ihn und synchronisieren Sie die Modelle.
4. Erstellen Sie eine neue Sitzung, wählen Sie Ihre Dialogstrategie und Modelle, geben Sie Ihren Prompt ein und starten Sie den ersten Zug.
5. Nutzen Sie den Export für eine portable Kopie der Sitzung (Markdown, Word oder JSON-Snapshot — siehe Sitzungen, Export & Import). Bei Problemen in Schritt 2 oder 3 siehe Fehlerbehebung.

Konto & Abonnement

Ihr Abonnement verwalten

Um Ihren Plan zu verwalten, Ihre Zahlungsmethode zu aktualisieren oder Rechnungen herunterzuladen, öffnen Sie die Anwendung und navigieren Sie zu :
Konto (unteres linkes Panel) → Mein Konto → Abonnement verwalten
Dadurch wird das Stripe-Abrechnungsportal in Ihrem Browser geöffnet, über das Sie alle abonnementbezogenen Aktionen durchführen können.

Ihr Abonnement kündigen

Um zu kündigen, folgen Sie demselben Pfad : Konto → Mein Konto → Abonnement verwalten → Plan kündigen
Die Kündigung tritt am Ende des aktuellen Abrechnungszeitraums in Kraft — bis dahin behalten Sie vollen Zugang.
Wenn Sie während des 14-tägigen Testzeitraums kündigen, wird keine Zahlung erhoben.

Plan wechseln

Sie können jederzeit über das Stripe-Portal vom Monats- zum Jahresplan wechseln (oder umgekehrt). Änderungen treten mit dem nächsten Abrechnungszyklus in Kraft.

Lokales Backend

Metamorfon verwendet einen lokalen FastAPI-Server (standardmäßig unter http://127.0.0.1:8000) für Aufgaben wie API-Schlüssel-Validierung, Auflistung verfügbarer Modelle und Orchestrierung von Aufrufen während der Nutzung. Die Anwendung versucht, diesen Server automatisch zu starten.

Falls Validierung oder Modell-Synchronisierung fehlschlagen:

• Warten Sie einige Sekunden und verwenden Sie Erneut versuchen im API-Schlüssel-Bereich.
• Stellen Sie sicher, dass kein anderes Programm Port 8000 auf Ihrem Computer verwendet.
• Prüfen Sie, ob Ihre Firewall oder Sicherheitssoftware den lokalen Traffic zu dieser Adresse blockiert.
• Bei anhaltenden Problemen nutzen Sie die in der App angezeigten Log-Pfade oder Diagnosen, oder folgen Sie Ihrer internen Prozedur zum manuellen Starten des Backends (für fortgeschrittene Konfigurationen).

Das Backend ist lokal; es entspricht nicht dem Senden von Daten an die Metamorfon-Website.

Datenschutz & Datenfluss

API-Schlüssel werden auf Ihrem Gerät gespeichert. Sie werden nicht an Metamorfons Server im Internet gesendet. Sie ermöglichen der Anwendung, die offiziellen APIs der von Ihnen gewählten Anbieter gemäß deren Bedingungen aufzurufen.

Prompts, Antworten und verwandte Inhalte werden gemäß Ihrer Sitzungskonfiguration (Modelle, Webzugang usw.) verarbeitet. Bei normaler Nutzung mit Cloud-Modellen werden diese Inhalte an die von Ihnen ausgewählten LLM-Anbieter gesendet — nicht an Metamorfon als zentralen Verarbeiter Ihrer Gespräche. Für genaue rechtliche Formulierungen (Aufbewahrung, Unterauftragnehmer, Regionen) verweisen Sie auf Ihre Datenschutzrichtlinie.

Exporte können den vollständigen Sitzungstext enthalten; behandeln Sie geteilte Dateien wie sensible Dokumente (siehe Sitzungen, Export & Import).

Sitzungen, Export & Import

Der Export ermöglicht es, den Dialog in mehreren Formaten aus der App zu extrahieren: Markdown (leicht, in jedem Editor lesbar), Word oder ein JSON-Snapshot des Sitzungszustands.

Der Import (wo verfügbar) stellt eine Sitzung aus einem JSON-Snapshot wieder her, um mit denselben Parametern und demselben Verlauf fortzufahren, je nach Versionskompatibilität.

Vor dem Teilen eines Exports: Entfernen oder schwärzen Sie sensible Inhalte; exportierte Dateien werden nicht automatisch anonymisiert.

Metriken & Kosten

Die Oberfläche zeigt Nutzungsindikatoren wie Tokens und geschätzte Kosten an, damit Sie den Verbrauch während einer Sitzung verfolgen können. Diese Werte dienen zur Überwachung der Nutzung in der App; sie stimmen möglicherweise nicht Zeile für Zeile mit der Rechnung des Anbieters überein (Rundungen, Preisstaffeln, gecachte Tokens oder anbieterspezifische Abrechnungsregeln).

Die Abrechnung für API-Aufrufe erfolgt zwischen Ihnen und dem jeweiligen LLM-Anbieter über Ihr Konto (BYOK). Metamorfon berechnet keine Nutzung der Anbieter-APIs.

Wichtige Einstellungen (Überblick)

• Temperatur (pro Modell): Passt Zufälligkeit im Verhältnis zu Determinismus an; niedrigere Werte tendieren zur Fokussierung, höhere zur Variationsbreite.
• Webzugang (wenn verfügbar): Ermöglicht der Sitzung die Nutzung von Live-Webquellen, wo unterstützt. Kann Latenz, Kosten und den Datenfluss außerhalb Ihres Geräts beeinflussen. Nur bei Bedarf aktivieren.
• Standardmodelle (z.B. für Synthese oder Zusammenfassung): Legen Sie sinnvolle Standards in Einstellungen fest, um nicht jede Sitzung neu konfigurieren zu müssen.
• Dialogstrategien & Debattiermodi: Diese bestimmen, wie Modelle abwechseln und wie stark sie einander herausfordern. Kurzerklärungtexte in der App helfen bei der Orientierung.

Fehlerbehebung

Systemanforderungen & Umgebung

• Betriebssystem: Windows- und macOS-Versionen wie auf der Website angeboten.
• Netzwerk: Erforderlich für Cloud-LLM-APIs und optionale Web-Funktionen; lokales Backend verwendet localhost.
• Unternehmensnetzwerke: Falls API-Aufrufe nur im Büro-WLAN fehlschlagen, wenden Sie sich an die IT bezüglich TLS-Inspektion, Proxy oder Ausgangsregeln für Anbieter-Domains.