BYOK

Eigenen API-Schlüssel einrichten

Die BYOK-Freischaltung lässt Voxis mit Ihrem eigenen Google-Gemini- oder Alibaba-Qwen-API-Schlüssel laufen — ein Kauf gilt für die Windows-App und die Chrome-Erweiterung. Diese Seite zeigt, wie Sie den Schlüssel gleich beim ersten Mal richtig einrichten.

Die Freischaltung ist ein einmaliger Kauf für 99,99 $ und deckt beide Anwendungen ab; sie ist nach der Aktivierung nicht erstattungsfähig. Ab der Aktivierung läuft die Übersetzung über Ihren eigenen Schlüssel, und bereits bezahlte Voxis-Minuten auf dem Konto können nicht mehr genutzt werden. Siehe Preise und die Erstattungsrichtlinie.

1. Bevor Sie beginnen

  • Ihr Konto braucht die BYOK-Freischaltung — ein einmaliger Kauf, siehe Preise. Melden Sie sich in App oder Erweiterung mit dem Konto an, das sie gekauft hat.
  • Besorgen Sie einen Schlüssel beim Anbieter: Gemini im Google AI Studio, Qwen im Alibaba Cloud Model Studio (International).
  • Es gibt ein einziges Schlüsselfeld. Voxis erkennt den Anbieter am Schlüssel selbst: AIza… ist Gemini, sk-… ist Qwen. Beide können nebeneinander gespeichert werden — Voxis wählt dann je Zielsprache die beste Engine (Qwen spricht rund 29 Ziele mit natürlicher Stimme; Gemini deckt alle 79 ab).

2. Gemini-Schlüssel hinzufügen

Erstellen Sie im Google AI Studio einen API-Schlüssel, kopieren Sie den AIza…-Wert, fügen Sie ihn ins Schlüsselfeld ein und speichern Sie. Für Gemini erscheint keine Workspace-Zeile — das ist normal; Gemini braucht keinen.

3. Qwen-Schlüssel hinzufügen — die ganze Datei einfügen

Model Studio liefert den Schlüssel als kleine, herunterladbare Zugangsdatei (CSV). Die eine Regel, mit der alles funktioniert:

Fügen Sie nicht den Dateipfad ein, und auch nicht nur den Schlüssel. Öffnen Sie die Datei, markieren Sie den gesamten Inhalt, kopieren Sie ihn und fügen Sie alles ins Schlüsselfeld ein.

Voxis liest aus dem Eingefügten beide Hälften in einem Zug: den API-Schlüssel und den Workspace. Der Workspace zählt, weil ein Qwen-Schlüssel zu einem Workspace gehört und dieser — besonders im Browser — Teil der Verbindungsadresse selbst ist. Ohne ihn kann der Schlüssel gar nicht verbinden.

  • Nur den nackten sk-…-Schlüssel eingefügt? Voxis fragt namentlich nach dem Workspace.
  • Den Dateipfad eingefügt (etwa C:\Users\…\key.csv)? Sie sehen die Warnung „API-Schlüssel einfügen" — fügen Sie stattdessen den Inhalt der Datei ein.
  • Erstellen Sie den Schlüssel im International Model Studio. Ein Schlüssel aus der falschen Region scheitert so, als wäre er ungültig.

4. Übersetzung starten

In der Erweiterung: Öffnen Sie den Tab mit dem Video, klicken Sie auf das Voxis-Symbol und prüfen Sie die Zeile unter dem Start-Knopf — sie nennt den Tab, der übersetzt wird („Start übersetzt diesen Tab: …"). Steht dort der falsche Tab, wechseln Sie zum Video-Tab und öffnen das Popup dort. Dann Start drücken. In der Windows-App: Video/Spiel oder Meeting wählen und starten — die ersten übersetzten Worte können ein paar Sekunden brauchen.

Wenn etwas nicht funktioniert

  • Warnung „API-Schlüssel einfügen" — Sie haben einen Dateipfad oder bloßen Text eingefügt. Öffnen Sie die Datei und fügen Sie ihren Inhalt ein.
  • Fehler direkt nach Start, der den Workspace nennt — der Workspace fehlt. Fügen Sie die komplette Zugangsdatei erneut ein.
  • Schneller, konkreter Fehler zur Schlüssel/Workspace-Paarung — die beiden gehören nicht zusammen, oder die Region ist falsch. Datei neu herunterladen und erneut einfügen.
  • Verbunden, aber stumm — prüfen Sie, ob Sie Start im Tab mit dem Video gedrückt haben und das Video wirklich läuft.
  • Eine Sprache startet mit nur einem Qwen-Schlüssel nicht — dieses Ziel hat keine Qwen-Stimme. Fügen Sie zusätzlich einen Gemini-Schlüssel hinzu; Voxis routet automatisch.
FAQ

Häufige Fragen

01Wird mein API-Schlüssel an Voxis gesendet?
Nein. Der Schlüssel liegt nur auf Ihrem Gerät — in der App mit Windows DPAPI verschlüsselt, im Browser im lokalen Speicher der Erweiterung. Übersetzungssitzungen verbinden sich direkt von Ihrem Gerät zu Google oder Alibaba; Voxis prüft nur, dass Ihr Konto die BYOK-Lizenz besitzt.
02Verbrauchen BYOK-Sitzungen meine Voxis-Minuten?
Nein. Bei BYOK bleibt Ihr Voxis-Minutenguthaben unberührt — die Nutzung rechnet Ihr Anbieter über Ihren eigenen Schlüssel ab.
03Gilt ein Kauf für App und Erweiterung?
Ja. Die Lizenz hängt an Ihrem Konto; Windows-App und Chrome-Erweiterung werden mit demselben Kauf freigeschaltet.
04Kann ich Gemini- und Qwen-Schlüssel gleichzeitig speichern?
Ja. Beide Plätze bestehen nebeneinander, und Voxis wählt die Engine je Zielsprache. Speichern mit leerem Feld ändert nichts; Löschen entfernt die gespeicherten Schlüssel.