Dokumentation

Dyad

Dyad akzeptiert jeden OpenAI-kompatiblen Endpunkt über Add Custom Provider: drei Felder, ein Schlüssel auf der Provid erseite und anschließend ein Eintrag pro gewünschter Modell-ID in der Auswahlliste.

Dyad akzeptiert jeden OpenAI-kompatiblen Endpunkt über Settings → AI Providers → Add Custom Provider: API Base URL https://api.kunavo.com/v1, Schlüssel auf der eigenen Anbieterseite, danach eine Add-Custom-Model-Zeile pro Modell-ID.

Settings → AI Providers → Add Custom Provider

Settings → AI Providers → Add Custom Provider
  ID                  kunavo
  Display Name        Kunavo
  API Base URL        https://api.kunavo.com/v1

Then on the new provider's own page
  Set Kunavo API Key  sk-kn-...            → Save Key

Provider page → bottom → Add Custom Model
  Model ID            claude-sonnet-5
  Name                Claude Sonnet 5 (Kunavo)
  Description         Kunavo, OpenAI-compatible
  Max Output Tokens   128000
  Context Window      1000000

Die Basis-URL behält ihr /v1 – aber nicht, weil es in der Dokumentation steht. Auf der Seite zu benutzerdefinierten Modellen steht nur: „You can usually find the API Base URL in the provider's documentation“, ein Beispiel wird nicht gezeigt. Damit ist die Frage nicht geklärt. Zwei Dinge in der ausgelieferten App geben die Antwort: Der Platzhalter im Dialog lautet E.g., https://api.example.com/v1, und ein benutzerdefinierter Provider wird als OpenAI-kompatibler Client erstellt; Ihr Wert wird unverändert als baseURL verwendet – Dyad hängt den Endpunktpfad an, niemals das /v1. Jede OpenAI-kompatible URL, die Dyad fest codiert, endet auf dieselbe Weise. Fehlt es in der Basis-URL, schlägt die Anfrage mit einem 404 fehl, nicht mit einem abgewiesenen Schlüssel.

Zwei Felder finden sich nicht auf der Dokumentationsseite. Im ausgelieferten Dialog heißt das erste Provider ID statt ID; hinzu kommt Environment Variable (Optional) – ein Variablenname wie KUNAVO_API_KEY, der nur ausgelesen wird, wenn in den Einstellungen kein Schlüssel gespeichert ist. Der Schlüssel selbst lässt sich in diesem Dialog nirgends eingeben: Erstellen Sie zuerst den Provider, öffnen Sie ihn und verwenden Sie auf seiner Seite das Feld Set Kunavo API Key.

Geben Sie das Context Window ein und lassen Sie das Feld nicht leer. Dyad weist lediglich darauf hin, dass leere Felder auf „default values, which may be smaller than optimal“ zurückfallen. Der ausgelieferte Standardwert beträgt 128,000 Tokens. Dyad fasst eine Konversation zusammen, sobald der niedrigere Wert aus der providerspezifischen Obergrenze und Ihrem Context Window abzüglich 25,000 erreicht ist. Ein benutzerdefinierter Provider wird unter einer custom::-ID gespeichert, gilt daher weder als Google- noch als OpenAI-Provider, sondern hat die Obergrenze 250,000. Bleibt das Feld leer, beginnt ein Modell mit einer Million Tokens Kontext daher schon bei 103,000 Tokens mit Zusammenfassungen statt bei 250,000 – es erfolgen also unnötig viele Komprimierungsdurchläufe für dieselbe Arbeit.

Diese Konfiguration wurde am unten genannten Datum anhand der Dyad-Dokumentation und des ausgelieferten Quellcodes geprüft. Kunavo hat Dyad nicht mit seinem Endpunkt ausgeführt – weder einen Build noch eine gestreamte Bearbeitung oder einen Tool-Roundtrip im Agent-Modus. Dasselbe gilt für jeden Client dieser Familie. Eine veröffentlichte Einrichtungsseite ist kein Kompatibilitätstest. Halten Sie Ihre bisher funktionierende Route verfügbar, während Sie diese ausprobieren, und testen Sie ein einzelnes, begrenztes Feature, bevor Sie ein Projekt darauf umstellen.

Kunavo bietet kein Embedding-, Text-to-Speech- oder Speech-to-Text-Modell an. Ein auf diese Weise hinzugefügter benutzerdefinierter Provider beantwortet daher Chat-Completions und sonst nichts. Dyads Build-Schleife fragt nicht nach den anderen drei, sodass Ihnen hier keine Funktion verloren geht – der hinzugefügte Provider ist lediglich kein direkter Ersatz für einen Stack, der auch diese Modelle benötigt.

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 Dyad-Einrichtung.

Schritt für Schritt

Erstellen Sie unter /app/keys einen Schlüssel und kopieren Sie ihn — er wird nur einmal angezeigt.
Gehen Sie in Dyad zu Settings, suchen Sie den Abschnitt AI Providers und klicken Sie auf Add Custom Provider. Füllen Sie die oben genannten Felder ID, Display Name und API Base URL aus. Die ID wird „used internally and cannot be changed later“; wählen Sie also einen Wert, mit dem Sie dauerhaft leben können. Der Display Name wird in der Auswahlliste angezeigt und dient nur der Optik.
Öffnen Sie den soeben erstellten Provider, fügen Sie den Schlüssel in Set Kunavo API Key ein und klicken Sie auf Save Key. Wenn Sie die Basis-URL leer lassen, weist Dyad die Anfrage sofort mit dem Fehler missing the API Base URL zurück, statt einen Netzwerkfehler zu melden.
Scrollen Sie auf derselben Seite nach unten und klicken Sie auf Add Custom Model. Die Model ID muss exakt dem Katalog-Slug entsprechen – laut Dyad-Dokumentation „must match exactly what's specified in the provider's API documentation. It's the identifier sent to the API“ –, also claude-sonnet-5 und kein Anzeigename.
Füllen Sie Max Output Tokens und Context Window anhand von /models aus, statt die Felder leer zu lassen. Wiederholen Sie dann Add Custom Model für jede gewünschte ID in der Auswahlliste – es gibt weder einen Sammelimport noch eine automatisch abgerufene Liste.
Wählen Sie das neue Modell in der Modellauswahl aus und geben Sie ihm eine echte Aufgabe – etwa eine Komponente hinzuzufügen, nicht nur eine Begrüßung. Der Build-Modus ist eine agentische Schleife, die bei jedem Schritt erneut einen Arbeitsumfang übermittelt. Daher sollte ein erster Test Streaming und wiederholte Bearbeitungen abdecken.

Abgeglichen mit Dyads Seite zu benutzerdefinierten Modellen 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 der Dyad-Leitfaden zu Preisen und API-Kosten.

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 Dyad.

# 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 Dyad hineinpasst
`claude-sonnet-5`	$1.40 / $7.00	das Standardmodell im Build-Modus – Programmierqualität pro Dollar in einer Schleife, die den ganzen Tag läuft
`claude-opus-5`	$3.50 / $17.50	Plan-Modus für ein Refactoring, bei dem ein falscher Plan eine ganze Sitzung kostet
`claude-haiku-4-5`	$0.70 / $3.50	Ask-Modus und schnelle Fragen zur Codebasis, bei denen das Volumen entscheidend ist
`gpt-5-6-sol`	$2.00 / $12.00	eine zweite Meinung aus einer anderen Familie – als zweites benutzerdefiniertes Modell beim selben Provider hinzufügen
`gpt-5-6-terra`	$0.70 / $4.20	ein großer Arbeitsumfang, sobald das Feld Context Window korrekt ausgefüllt ist

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.

Drei Einschränkungen, die Sie vor dem Wechsel kennen sollten

Dies sind Regeln von Dyad selbst, nicht von Kunavo. Jede davon beeinflusst, auf welche Funktionen ein Kundenschlüssel zugreifen kann. Deshalb beschreibt diese Seite einen Weg zu den Modellen und nicht zu allen Funktionen von Dyad.

Pro-Modi sind absichtlich nicht mit Ihrem eigenen Schlüssel verfügbar. In der Preis-FAQ von Dyad steht es unmissverständlich: Pro-Modi wie Smart Context lassen sich nur mit den KI-Credits von Dyad Pro verwenden, nicht mit eigenen API-Schlüsseln, da sie serverseitige Verarbeitung über mehrere Modelle hinweg erfordern. Turbo Edits ist der andere Modus. Mit einem benutzerdefinierten Provider erhalten Sie Zugriff auf die Modelle und die gewöhnlichen Modi, nicht auf diese Funktionen.
Der Agent-Modus ist im kostenlosen Tarif begrenzt. Das Limit beträgt 20 Agent-Nachrichten innerhalb eines Zeitfensters von 23 Stunden und gilt unabhängig davon, wessen Schlüssel Sie konfigurieren – für Build, Ask und Plan gibt es keine Obergrenze. Ein unerwarteter Abbruch mitten in der Sitzung kann daher an Dyads Kontingent liegen und muss nichts mit Ihrem Guthaben oder Endpunkt zu tun haben.
Das Anthropic-Messages-Protokoll ist über Dyad nicht erreichbar. Ein benutzerdefinierter Provider wird immer als OpenAI-Chat-Completions-Client erstellt; beim integrierten Anthropic-Provider lässt sich die Basis-URL nicht überschreiben. Claude-Modelle werden daher über die OpenAI-kompatible Schnittstelle eingebunden – genau das macht die obige Anleitung, und deshalb verwendet auch die Verifizierungsanfrage auf dieser Seite das OpenAI-Format.

Häufig gestellte Fragen

Wie füge ich Dyad einen benutzerdefinierten API-Provider hinzu?

Gehen Sie zu Settings, suchen Sie den Abschnitt AI Providers und klicken Sie auf Add Custom Provider. Geben Sie eine ID ein, die intern verwendet wird und später nicht mehr geändert werden kann, einen Display Name für die Auswahlliste sowie die API Base URL Ihres Endpunkts. Speichern Sie den Eintrag, öffnen Sie den soeben erstellten Provider und fügen Sie Ihren Schlüssel auf dessen Seite in das Feld „Set <name> API Key“ ein – der Schlüssel gehört nicht zum Erstellungsdialog. Scrollen Sie schließlich auf dieser Seite nach unten und verwenden Sie Add Custom Model einmal pro gewünschter Modell-ID. Laut Dyad-Dokumentation gilt auf Endpunktseite nur eine Voraussetzung: Jeder Provider funktioniert, solange er eine OpenAI-kompatible API bereitstellt.

Muss Dyads API Base URL mit /v1 enden?

Für einen OpenAI-kompatiblen Endpunkt: ja, zum Beispiel https://api.kunavo.com/v1. Dyads Dokumentation zu benutzerdefinierten Modellen klärt diese Frage nicht: Sie besagt lediglich, dass Sie die API Base URL in der Regel in der Dokumentation des Providers finden, und enthält kein Beispiel. Ausschlaggebend ist der Dialog selbst: Sein Platzhalter lautet „E.g., https://api.example.com/v1“. Außerdem wird Ihr Wert unverändert als baseURL eines OpenAI-kompatiblen Clients übernommen; Dyad hängt nur den Pfad an. Fehlt /v1 in der Basis-URL, schlägt die Anfrage mit einem 404-Fehler statt einem Authentifizierungsfehler fehl. Dasselbe gilt, wenn die URL bereits /chat/completions enthält.

Kann ich Dyad mit Claude-Modellen ohne Anthropic-Konto verwenden?

Ja, über einen benutzerdefinierten Provider statt über Dyads integrierten Anthropic-Eintrag. Dyad erstellt jeden benutzerdefinierten Provider als OpenAI-Chat-Completions-Client. Daher wird die eingegebene Modell-ID am konfigurierten Endpunkt aufgelöst und nicht in der App; eine Claude-ID kann also dorthin gesendet werden. Der integrierte Anthropic-Provider hilft hier nicht: Er wird ohne Basis-URL-Argument erstellt, bietet somit keine Überschreibung im Stil von ANTHROPIC_BASE_URL und erreicht ausschließlich den Anthropic-eigenen Endpunkt.

Unterscheidet sich ein benutzerdefinierter Provider in Dyad von der Nutzung von OpenRouter?

Nur bei der Einrichtung, nicht grundsätzlich. OpenRouter ist das einzige unabhängige Multi-Vendor-Gateway mit einer integrierten Voreinstellung in Dyads Providerliste. Dafür benötigen Sie nur einen Schlüssel. Jedes andere Gateway wird über Add Custom Provider eingebunden; dort müssen Sie außerdem die ID, Max Output Tokens und Context Window jedes Modells von Hand eingeben. Als ein Gateway um eine Voreinstellung bat, verwies Dyads Maintainer genau auf diesen Weg. Vergleichen Sie beide nach Preis, Finanzierungsbedingungen und den Modellen, die Sie tatsächlich nutzen möchten – nicht danach, welches ein Logo in der Liste hat.

Warum beginnt mein benutzerdefiniertes Dyad-Modell so früh, die Konversation zusammenzufassen?

Wahrscheinlich ist das Feld Context Window leer. Dyad verwendet dann standardmäßig 128,000 Tokens und fasst die Konversation zusammen, sobald der niedrigere Wert aus der providerspezifischen Obergrenze und dem Context Window abzüglich 25,000 erreicht ist. Für einen benutzerdefinierten Provider gilt die Obergrenze 250,000, nicht die von Google oder OpenAI. Bleibt das Feld leer, beginnt die Zusammenfassung also bei etwa 103,000 Tokens, selbst wenn das Modell ein deutlich größeres Kontextfenster hat. Tragen Sie die tatsächlichen Werte aus dem Katalog des Providers in Max Output Tokens und Context Window ein. Dann verschiebt sich der Schwellenwert bis zur Obergrenze.