Dokumentation

Amp

Amp leitet Modelle serverseitig weiter. Daher müssen Sie auf Ihrem Rechner keine Variable für die Basis-URL festlegen: Fügen Sie unter „Model Routing“ eine Verbindung vom Typ „Custom URL“ hinzu, und Amp ruft den Endpunkt aus der Cloud auf. Die Funktion ist einem kostenpflichtigen Tarif vorbehalten. Prüfen Sie daher zuerst Ihren Tarif.

Eine Custom-URL-Verbindung in Amps Model Routing — API-Format chat-completions, Basis-URL https://api.kunavo.com/v1, Schlüssel als Bearer-Token — verschiebt zugeordnete Modelle mit einem Schlüssel auf die verfügbaren Stufen.

Settings → Model Routing → Add → Custom URL

Connection type    Custom URL            (Model Routing → Add)
API format         chat-completions      OpenAI Chat Completions API, the default
Base URL           https://api.kunavo.com/v1
Key                sk-kn-...             sent as Authorization: Bearer <key>
Headers            —                     nothing extra is needed
Query Parameters   —                     nothing extra is needed
Model mapping      anthropic/claude-opus-4-6 -> claude-opus-4-6
                   anthropic/claude-fable-5  -> claude-fable-5
                   openai/gpt-5.6-sol        -> gpt-5-6-sol

Prüfen Sie zuerst Ihren Amp-Tarif. Auf der Seite „Model Routing“ von Amp steht am 2026-09-21: „KI-Modellrouter und Gateways sind experimentell und nur im Early Access für Megawatt-, Gigawatt- und Enterprise-Kunden verfügbar. Wir werden sie bald für alle bereitstellen.“ Eine Verbindung vom Typ „Custom URL“ gehört zu dieser Kategorie. Daher wird sie im Menü Add eines Hobby-Kontos nicht angeboten. Amp nennt keinen Termin für die Bereitstellung, und diese Seite sagt keinen voraus.

Kunavo hat Amp nicht mit diesem Endpunkt ausgeführt. Alle Angaben oben stammen aus der Dokumentation von Amp selbst und nicht aus einer hier abgeschlossenen Sitzung — die Funktion ist einem kostenpflichtigen Amp-Tarif vorbehalten. Betrachten Sie dies als Wiedergabe der Amp-Spezifikation und nutzen Sie Check Access, um zu prüfen, ob es funktioniert.

chat-completions behält das Suffix /v1 in der Basis-URL bei, da Amp nur die Route anhängt. Das dokumentierte Beispiel von Amp klärt die Frage: „Eine Basis-URL https://api.example.com/v1 mit chat-completions sendet Anfragen an https://api.example.com/v1/chat/completions.“ Auf derselben Seite steht außerdem, dass eine Basis-URL, die bereits mit /v1 endet, „akzeptiert und nicht doppelt angefügt“ wird. Im Verbindungsformular wird die Anfrage-URL während der Eingabe angezeigt. So können Sie die zusammengesetzte URL vor dem Speichern prüfen.

Die Systemmodelle Dictation und Realtime Voice von Amp sind Sprachfunktionen, und Kunavo bietet weder ein Speech-to-Text-Modell noch ein Text-to-Speech-Modell an. Eine Verbindung vom Typ „Custom URL“ kann keines dieser Modelle bereitstellen. Belassen Sie diese Zeilen bei Amp.

Noch kein Schlüssel? Erstelle ein Kunavo-Konto, erstelle einen Schlüssel (er beginnt mit sk-kn-) und füge ab $10 Guthaben hinzu – Aufrufe werden aus diesem Guthaben bezahlt, fehlgeschlagene Aufrufe werden nicht berechnet. Das Dashboard öffnet anschließend die Amp-Einrichtung.

Schritt für Schritt

Erstellen Sie unter /app/keys einen Schlüssel und kopieren Sie ihn — er wird nur einmal angezeigt.
Öffnen Sie in Ihren persönlichen Einstellungen Model Routing (Workspace-Administratoren verwenden Workspace Model Routing, um eine Verbindung für alle Mitglieder freizugeben), öffnen Sie das Menü Add und wählen Sie Custom URL.
Legen Sie als API-Format chat-completions fest, fügen Sie https://api.kunavo.com/v1 als Basis-URL und Ihren sk-kn--Schlüssel als Schlüssel ein. Amp sendet ihn in allen Formaten als Authorization: Bearer <key>, also in dem Header, mit dem Kunavo die Anfrage authentifiziert. Lassen Sie deshalb Headers und Query Parameters leer.
Tragen Sie die Modellzuordnung ein, ein Muster pro Zeile. Links steht die kanonische Modell-ID von Amp, rechts von -> die ID, die Kunavo empfängt. Die Schreibweisen unterscheiden sich (Amp schreibt openai/gpt-5.6-sol, Kunavo erwartet gpt-5-6-sol), daher ist der Pfeil hier erforderlich. Verwenden Sie die Auswahl Models, um die kanonischen IDs einzufügen, statt sie aus dem Gedächtnis einzugeben.
Klicken Sie auf Check Access. Bei einer allgemein gehaltenen Zuordnung listet Amp die Modelle des Endpunkts auf; nennt die Zuordnung genau ein Modell, sendet Amp eine Anfrage mit einem Token. Prüfen Sie anschließend, ob der Routing-Graph unter der Verbindungsliste zeigt, dass Kunavo die zugeordneten Modelle bereitstellt und bei allen nicht zugeordneten Modellen weiterhin Amp angegeben ist.

Abgeglichen mit Dokumentation von Amp zu Model Routing am 21. September 2026. Einstellungen von Drittanbietern können sich ändern; wenn ein Feldname hier nicht mehr mit deiner Ansicht übereinstimmt, ist diese Seite maßgeblich, nicht diese hier.

Dies ist die Kurzfassung. Die vollständige Anleitung – Modellauswahl, Kosten einer tatsächlichen Sitzung und Fehlerszenarien – findest du in was Amp selbst kostet und inwiefern eine Verbindung die Abrechnung beeinflusst.

Vor dem Debugging des Clients prüfen

Eine Anfrage klärt, ob der Fehler am Endpunkt, am Schlüssel oder an der Konfigurationsdatei liegt. Wenn diese Anfrage JSON zurückgibt, funktionieren dieselbe Basis-URL und derselbe Schlüssel in Amp.

# Settles whether a failure is the endpoint, the key, or the client.
curl -sS https://api.kunavo.com/v1/models \
  -H "Authorization: Bearer sk-kn-..."

Welche Modell-ID in das Feld gehört

Jedes Textmodell ist über eine Modell-ID erreichbar – die aktuelle Liste findest du unter GET /v1/models, den Katalog mit Preisen auf der Modellseite. Die Tarife sind USD pro 1 Mio. Token, Eingabe / Ausgabe.

Modell-ID	Kunavo: Ein- und Ausgabe	Wo es in Amp hineinpasst
`gpt-5-6-sol`	$2.00 / $12.00	der Hauptagent und Puck im Medium-Modus — das Standardarbeitsmodell von Amp
`gpt-6-astra`	$4.00 / $20.00	der Hauptagent im High-Modus und der Oracle-Unteragent in den meisten Modi
`claude-fable-5-1`	$7.00 / $35.00	der Hauptagent im Ultra-Modus, der für anspruchsvolle offene Aufgaben vorgesehen ist
`gpt-5-6-terra`	$0.70 / $4.20	der Search-Unteragent — Codebasisabruf, bei dem das Anfragevolumen entscheidend ist
`claude-haiku-4-5`	$0.70 / $3.50	View Media, das Amp-Modell für Bilder, PDFs und Videos — Claude liest Bilder, aber keine Videos

Die Abrechnung erfolgt pro Token aus einem vorausbezahlten Guthaben ohne Monatsgebühr – siehe Abrechnung. Bei wiederholtem Kontext – dem Großteil dessen, was ein Editor oder Chat-Client sendet – verändert Prompt-Caching die Rechnung stärker als die Modellwahl.

Was eine Verbindung nicht ändert

Das Modell-Routing ändert nur, wer Ihre Tokens abrechnet. Die Amp-Orb-Rechenleistung wird separat und minutengenau abgerechnet. Eine Verbindung ändert daher an diesem Kostenpunkt nichts. Auch Nicht-Modellwerkzeuge wie die Websuche verbrauchen weiterhin Amp-Credits, unabhängig davon, wie die Modelle weitergeleitet werden. Das Amp-Abonnement, das die Option „Custom URL“ freischaltet, ist selbst ein Festpreis, der anfällt, bevor das erste Token verarbeitet wird.

Zwei standardmäßig von Amp ausgeführte Modelle fehlen in der obigen Tabelle, da Kunavo sie nicht anbietet: die GLM-Modelle hinter dem Low-Modus und der Read Thread-Unteragent. Eine Verbindung kann Amp in seiner konfigurierten Form nicht auf der günstigsten Stufe nachbilden. Bei einer Zuordnung von */* verbleiben diese beiden Modelle daher unbemerkt bei Amp. Das ist das korrekte Ergebnis und kein Konfigurationsfehler: Laut der Regel von Amp stellt Amp alles bereit, was keine Verbindung anbietet.

Häufig gestellte Fragen

Kann Amp einen benutzerdefinierten API-Endpunkt verwenden?

Ja, über eine Verbindung vom Typ „Custom URL“ unter „Model Routing“, aber nicht in jedem Tarif. Laut der Dokumentation von Amp zu Model Routing sind KI-Modellrouter und Gateways — zu dieser Kategorie gehört „Custom URL“ — experimentell und nur für Megawatt-, Gigawatt- und Enterprise-Kunden im Early Access verfügbar. Amp will die Funktion bald für alle bereitstellen, nennt aber keinen Termin. Das war der Stand am 21. September 2026. In einem Hobby-Konto wird die Option im Menü „Add“ überhaupt nicht angeboten. Prüfen Sie daher zuerst Ihren Tarif und nicht die Basis-URL.

Muss die Amp-Basis-URL mit /v1 enden?

Das hängt vom gewählten API-Format ab. Deshalb wird dieses Feld so oft falsch verstanden. Bei chat-completions hängt Amp nur /chat/completions an. Die Basis-URL muss also auf /v1 enden: Aus dem dokumentierten Beispiel https://api.example.com/v1 wird https://api.example.com/v1/chat/completions. Bei anthropic-messages hängt Amp stattdessen /v1/messages an, daher ist dort der reine Ursprung korrekt. Amp gibt außerdem an, dass eine Basis-URL, die bereits mit /v1 endet, akzeptiert und nicht doppelt ergänzt wird. Das Verbindungsformular zeigt während der Eingabe die zusammengesetzte Anfrage-URL an, die Sie vor dem Speichern prüfen können.

Wo speichert Amp den API-Schlüssel für einen benutzerdefinierten Endpunkt?

Auf den Servern von Amp, nicht auf Ihrem Rechner. Amp vermittelt Inferenzanfragen über die eigene Cloud. Deshalb wird eine Verbindung vom Typ „Custom URL“ in den Kontoeinstellungen unter „Model Routing“ konfiguriert und nicht in einer lokalen Konfigurationsdatei oder Umgebungsvariable. Der angegebene Endpunkt muss von der Infrastruktur von Amp aus erreichbar sein. Amp sendet die Zugangsdaten in allen drei API-Formaten als Authorization: Bearer-Header. In der veröffentlichten Referenz zu den CLI-Einstellungen von Amp gibt es weder eine Einstellung für die Basis-URL noch eine für den API-Schlüssel. Aus Sicht des Clients ist das derselbe Sachverhalt.

Warum verwendet Amp nach dem Hinzufügen einer Verbindung weiterhin eigene Modelle?

Weil eine Verbindung nur die Modelle bereitstellt, die in ihrer Zuordnung enthalten sind, und Amp alle übrigen selbst bereitstellt. Prüfen Sie der Reihe nach drei Punkte: ob die Verbindung aktiv ist, an welcher Stelle der Prioritätsliste sie steht — zuerst persönliche Verbindungen, dann Workspace-Verbindungen, dann Amp; Priorität 0 wird zuerst versucht — und ob die Modellzuordnung tatsächlich zum Modell passt, das Ihr Modus ausführt. Der Routing-Graph unter der Verbindungsliste zeigt, welche Verbindung jedes Modell bereitstellt. Mit amp config model-providers check-access --provider-model führen Sie eine kurze Inferenz aus und erfahren, welche Verbindung sie tatsächlich bereitgestellt hat.

Hat Kunavo Amp mit seinem Endpunkt getestet?

Nein. Kunavo hat Amp nicht zur Laufzeit getestet. Diese Seite gibt die Dokumentation von Amp zu Model Routing wieder, wie sie am 21. September 2026 gelesen wurde; sie berichtet nicht von einer abgeschlossenen Sitzung. Die Funktion „Custom URL“ ist einem kostenpflichtigen Amp-Tarif vorbehalten. Daher wurden die Felder mit der veröffentlichten Spezifikation von Amp abgeglichen und nicht mit einem laufenden Client. Die Schaltfläche „Check Access“ von Amp prüft die Zugangsdaten beim Anbieter und ist der maßgebliche Test. Falls eine Feldbezeichnung auf dieser Seite nicht mehr mit der Anzeige in Amp übereinstimmt, ist die Seite von Amp maßgeblich.