KI-Anbieterschlüssel

Mit Bring your own key (BYOK) können unterstützte KI-Anfragen über Ihr eigenes Konto beim KI-Anbieter laufen. Sie benötigen keinen Schlüssel: Standardmäßig stellt die Plattform die Modelle bereit. Zum Speichern eines Schlüssels ist der Tarif Scale erforderlich. Bereits hinterlegte Schlüssel funktionieren weiterhin in Launch und Operate. Sie zahlen weiterhin den Make Agent Fast-Tarif plus eine pauschale Plattformgebühr pro Aktion; die Modellnutzung stellt Ihnen der Anbieter direkt in Rechnung.

Unterstützte Anbieter#

Neue Schlüssel können nur für zwei Anbieter hinzugefügt werden – einen für Text und einen für Sprache:

Legacy-Schlüssel#

Direkte Anbieterschlüssel, die vor der Umstellung auf OpenRouter und Speko gespeichert wurden, erscheinen unter Legacy-Schlüssel. Sie funktionieren weiter, bis Sie sie widerrufen, und Sie können sie weiterhin widerrufen, aber keine neuen hinzufügen oder bestehende ersetzen:

Die Verfügbarkeit der Anbieter hängt außerdem von den auf der Plattform konfigurierten Text-, Sprach- und Echtzeitanbietern ab. Das Speichern eines gültigen Schlüssels erzwingt nicht, dass jede Funktion diesen Anbieter verwendet.

Anbieterschlüssel hinzufügen#

1. Erstellen Sie in der Konsole von OpenRouter oder Speko einen Schlüssel und aktivieren Sie gegebenenfalls die Abrechnung beim Anbieter oder ein Ausgabenlimit.
2. Öffnen Sie Dashboard → Einstellungen → KI-Anbieterschlüssel. Nur der Abrechnungsinhaber eines Scale-Workspace kann einen Schlüssel speichern.
3. Fügen Sie den Schlüssel in die Karte OpenRouter oder Speko ein.
4. Wählen Sie Testen & speichern.
5. Warten Sie auf das Validierungsergebnis und testen Sie anschließend die Funktion, die den Anbieter verwendet.

Make Agent Fast führt vor dem Speichern eines Schlüssels eine Live-Validierungsanfrage durch; dabei werden weder Modell-Token noch Plattform-Credits verbraucht. Der Schlüssel darf keine Leerzeichen oder Zeilenumbrüche enthalten und muss zwischen 16 und 512 Zeichen lang sein. OpenRouter-Schlüssel müssen mit sk-or- beginnen; Speko-Schlüssel müssen mit sk_speko_ oder sk_live_ beginnen. Maßgeblich ist die Live-Validierung.

Wenn Sie einen weiteren funktionierenden Schlüssel für denselben Anbieter speichern, ersetzt er den zuvor gespeicherten Wert. Ein Schlüssel, der die Validierung nicht besteht, wird nicht gespeichert, sodass der bereits hinterlegte Schlüssel weiter funktioniert. Das Dashboard behält nur unkritische Identifikationsdaten wie die letzten vier Zeichen, den Validierungszeitpunkt und den Status.

So funktioniert die Auswahl des Textanbieters#

Für die Textgenerierung hat ein aktiver OpenRouter-Schlüssel Vorrang. Ist keiner vorhanden, sucht Make Agent Fast nach einem aktiven Legacy-Schlüssel, der zum auf der Plattform konfigurierten Textanbieter passt, und danach in dieser Reihenfolge nach den anderen Legacy-Textschlüsseln (Anthropic, OpenAI, Gemini, xAI, DeepSeek). Existiert kein geeigneter BYOK-Schlüssel, wird der Plattformanbieter verwendet, sofern Tarif und Bereitstellung dies zulassen.

Sprachschlüssel sind anbieterspezifisch. Ein Speko-Schlüssel wird verwendet, wenn die Sprachverarbeitung über Speko läuft. Ein Legacy-Schlüssel von Deepgram wird nur verwendet, wenn der aktive Speech-to-Text-Anbieter Deepgram ist; ein Legacy-Schlüssel von ElevenLabs wird nur verwendet, wenn Text-to-Speech für ElevenLabs konfiguriert ist.

BYOK-Schlüssel ersetzen derzeit nicht die Zugangsdaten der Plattform für Wissens-Embeddings. Die Aufnahme und der Abruf von Wissen laufen weiterhin über den in der Bereitstellung konfigurierten Embedding-Anbieter.

Abrechnung und Credits#

• Der externe Anbieter berechnet die KI-Token-Nutzung dem Konto, das den Schlüssel ausgestellt hat.
• Make Agent Fast berechnet weiterhin das Abonnement sowie eine pauschale Plattformgebühr für jede Aktion, die mit Ihrem Schlüssel ausgeführt wird: 1 Credit pro Chat-Antwort anstelle der tokenbasierten Berechnung. Die Gebühr deckt Retrieval, Orchestrierung und Hosting rund um den Aufruf ab und ist kein Prozentsatz Ihrer Token-Rechnung.
• Die Gebühr fällt pro Anbieteraufruf an. Sprachschritte, die die Plattform finanziert (zum Beispiel die Transkription, wenn Sie nur einen Textschlüssel haben), werden zum normalen Tarif berechnet, und Live-Anrufe werden immer zum Plattformtarif abgerechnet.
• Ist das Kontingent beim Anbieter erschöpft, kann eine Anfrage fehlschlagen, selbst wenn noch Make Agent Fast-Credits vorhanden sind.

Prüfen Sie sowohl Nutzung & Credits in Make Agent Fast als auch das eigene Nutzungs-Dashboard des Anbieters.

Schlüsselstatus und Fehlerbehandlung#

Wenn eine Anfrage fehlschlägt, weil ein Anbieter die Zugangsdaten oder das Kontingent ablehnt, kann Make Agent Fast den gespeicherten Schlüssel als ungültig markieren. Wenn Sie den Schlüssel beim Anbieter korrigieren, wird das gespeicherte Geheimnis dadurch weder offengelegt noch überschrieben; bei einem OpenRouter- oder Speko-Schlüssel prüfen Sie ihn mit Verbindung testen erneut oder speichern den funktionierenden Schlüssel noch einmal. Ein Legacy-Schlüssel, der ungültig wird, kann nicht durch einen anderen Legacy-Schlüssel ersetzt werden – stellen Sie diesen Anbieter stattdessen auf OpenRouter oder Speko um.

Anbieterschlüssel rotieren#

1. Erstellen Sie einen neuen Anbieterschlüssel, ohne den alten zu löschen.
2. Speichern Sie den neuen Schlüssel in Make Agent Fast und stellen Sie sicher, dass er aktiv wird.
3. Testen Sie den Text-Chat oder Sprachnachrichten – je nachdem, was diesen Anbieter verwendet.
4. Widerrufen Sie den alten Schlüssel in der Konsole des Anbieters.
5. Prüfen Sie die Anbieterprotokolle auf unerwartete Nutzung des alten Schlüssels.

Wurde ein Schlüssel in der Versionsverwaltung oder im Browsercode offengelegt, widerrufen Sie ihn sofort beim Anbieter. Wenn Sie ihn nur in Make Agent Fast löschen, kann ein anderer Besitzer ihn weiterhin direkt beim Anbieter verwenden.