ドキュメント
Dyad
Dyad では Add Custom Provider から任意の OpenAI 互換エンドポイントを利用できます。必要なのは3つのフィールドと、プロバイダーのページでのキー設定です。その後、モデル選択メニューに表示したいモデル ID ごとに1行追加します。
DyadはSettings → AI Providers → Add Custom Providerから任意のOpenAI互換エンドポイントに接続できます:API Base URLはhttps://api.kunavo.com/v1、キーはプロバイダー固有のページで設定し、モデルIDごとにAdd Custom Model行を1つ追加します。
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/v1 も含めますが、その根拠はドキュメントにはありません。カスタムモデルのページには「通常、API Base URL はプロバイダーのドキュメントで確認できます」とあるだけで、例は掲載されていないため、この点は明確になりません。実際のアプリの2つの動作が答えを示しています。ダイアログのプレースホルダーには E.g., https://api.example.com/v1 とあり、カスタムプロバイダーは OpenAI 互換クライアントとして構成され、入力した値が変更されずに baseURL として使われます。Dyad が追加するのはルートであり、/v1 ではありません。Dyad が独自にハードコードしている OpenAI 互換エンドポイントも、すべて同じ形式で終わります。ベース URL にこれがないと、キーが拒否されるのではなく 404 エラーになります。KUNAVO_API_KEY のような変数名で、設定にキーが保存されていない場合にのみ読み込まれます。キー自体はこのダイアログにありません。先にプロバイダーを作成してから開き、そのページにある Set Kunavo API Key 欄を使ってください。custom:: ID で保存されるため、Google 用でも OpenAI 用でもなく、250,000の上限が適用されます。空欄のままだと、100万トークンのモデルでも250,000トークンではなく103,000トークンで要約が始まります。同じ作業に対して圧縮の回数が増えるだけです。sk-kn-で始まります)。$10からクレジットを追加すると、呼び出しはその残高から支払われ、失敗した呼び出しは課金されません。ダッシュボードを開くと、Dyad設定が表示されます。手順
/app/keysでキーを作成してコピーします。キーは一度だけ表示されます。- Dyad で Settings を開き、AI Providers セクションを見つけて、Add Custom Provider をクリックします。上記のとおり、ID、Display Name、API Base URL を入力します。ID は「内部で使用され、後から変更できない」ため、今後も使い続けられるものを選んでください。Display Name はモデル選択メニューに表示される名前で、見た目だけに使われます。
- 作成したプロバイダーを開き、キーを Set Kunavo API Key に貼り付けて、Save Key をクリックします。ベース URL が空欄だと、Dyad はネットワークエラーではなく API Base URL が未指定 エラーを返し、リクエストを拒否します。
- 同じページの一番下までスクロールし、Add Custom Model をクリックします。Model ID にはカタログのスラッグを正確に指定してください。Dyad のドキュメントには「プロバイダーの API ドキュメントに記載されたものと正確に一致している必要があります。これは API に送信される識別子です」とあります。つまり、表示名ではなく
claude-sonnet-5を指定します。 - Max Output Tokens と Context Window に
/modelsの値を入力し、空欄のままにしないでください。その後、モデル選択メニューに追加したい ID ごとに Add Custom Model を繰り返します。ここには一括インポートも、モデル一覧の取得機能もありません。 - 新しいモデルをモデル選択メニューから選び、実際のタスクを与えてください。挨拶ではなく、追加するコンポーネントなどを依頼します。Build モードは各ステップで作業セットを再送信するエージェントループのため、最初の実行ではストリーミングと繰り返し編集を試してください。
Dyad の Custom Models ページで2026年9月21日に確認しました。サードパーティの設定は変更されます。ここに記載されたフィールド名が表示内容と一致しなくなった場合は、このページではなく、そのページを正しい情報源としてください。
クライアントをデバッグする前に確認すること
1回のリクエストで、失敗の原因がエンドポイント、キー、設定ファイルのどれかを特定できます。これがJSONを返すなら、同じベースURLとキーが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-..."フィールドに入力するモデルID
すべてのテキストモデルにはモデルIDでアクセスできます。現在の一覧はGET /v1/models、価格付きのカタログはモデルページにあります。料金は100万トークンあたりのUSDで、入力 / 出力の順です。
| モデル ID | Kunavo 入力 / 出力 | Dyadでの位置付け |
|---|---|---|
claude-sonnet-5 | $1.40 / $7.00 | Build モードのデフォルトモデル — 終日実行されるループで、1ドルあたりのコーディング品質を重視 |
claude-opus-5 | $3.50 / $17.50 | 計画の誤りがセッション全体のコストにつながる、リファクタリング時の Plan モード |
claude-haiku-4-5 | $0.70 / $3.50 | Ask モードやコードベースに関する簡単な質問。呼び出し量が中心 |
gpt-5-6-sol | $2.00 / $12.00 | 別のファミリーからのセカンドオピニオン — 同じプロバイダーに2つ目のカスタムモデルとして追加 |
gpt-5-6-terra | $0.70 / $4.20 | Context Window フィールドに正しい値を設定したうえで、大きな作業セットを扱う場合 |
切り替える前に知っておくべき3つの制約
これらは Kunavo ではなく Dyad 独自のルールで、それぞれが顧客キーで利用できる範囲を変えます。そのため、このページでは Dyad のすべての機能ではなく、モデルへの接続方法を説明しています。
- 設計上、独自のキーでは Pro モードを利用できません。Dyad の料金に関する FAQ には、Smart Context などの Pro モードは複数のモデルにわたるサーバー側処理を必要とするため、独自の API キーではなく Dyad Pro の AI クレジットでのみ利用できると明記されています。もう1つの対象は Turbo Edits です。カスタムプロバイダーを追加するとモデルと通常モードを利用できますが、これらの機能は利用できません。
- 無料プランではAgentモードの利用回数に上限があります。 23時間ごとの期間につきAgentメッセージは20件までで、この上限は誰のキーを設定するかにかかわらず適用されます。Build、Ask、Planには上限がありません。そのため、セッションの途中で予期せず停止した場合、残高やエンドポイントではなくDyadの利用上限が原因かもしれません。
- DyadからAnthropic Messagesプロトコルには接続できません。 カスタムプロバイダーは常にOpenAI Chat Completionsクライアントとして構成され、組み込みのAnthropicプロバイダーではベースURLを上書きできません。そのため、ClaudeモデルはOpenAI互換のインターフェース経由で利用します。上記の設定はその方法であり、このページの検証リクエストがOpenAI形式なのもそのためです。
よくある質問
DyadにカスタムAPIプロバイダーを追加するにはどうすればよいですか?
[Settings]を開き、[AI Providers]セクションで[Add Custom Provider]をクリックします。内部で使用され、後から変更できないID、プロバイダー選択画面に表示されるDisplay Name、エンドポイントのAPI Base URLを入力します。保存したら、作成したプロバイダーを開き、そのページの「Set <name> API Key」欄にキーを貼り付けます。キーは作成ダイアログでは入力しません。最後にページ下部までスクロールし、利用可能にしたいモデルIDごとに[Add Custom Model]を使います。Dyadのドキュメントでは、エンドポイント側の要件を次のように簡潔に説明しています。OpenAI互換APIを提供していれば、どのプロバイダーでも利用できます。
DyadのAPI Base URLの末尾に/v1を付ける必要がありますか?
OpenAI互換エンドポイントの場合は必要です。例:https://api.kunavo.com/v1。DyadのCustom Modelsドキュメントには明記されていません。API Base URLは通常プロバイダーのドキュメントに記載されていると説明されているだけで、例もありません。判断材料になるのは、ダイアログのプレースホルダーが「E.g., https://api.example.com/v1」と示していることと、Dyadのクライアント構築方法です。入力した値は変更されずにOpenAI互換クライアントのbaseURLとなり、ルートだけが後から追加されます。/v1がないベースURLでは認証エラーではなく404になり、すでに/chat/completionsを含むURLでも同様です。
AnthropicアカウントなしでDyadからClaudeモデルを使えますか?
はい。Dyad組み込みのAnthropic項目ではなく、カスタムプロバイダーを使います。DyadはすべてのカスタムプロバイダーをOpenAI Chat Completionsクライアントとして構築するため、入力したモデルIDはアプリ内ではなく、設定したエンドポイントで解決されます。そのため、ClaudeのIDを送信できます。役に立たないのは組み込みのAnthropicプロバイダーです。これはベースURL引数なしで構築されるため、ANTHROPIC_BASE_URLのような上書き手段はなく、Anthropic独自のエンドポイントにしか接続しません。
DyadのカスタムプロバイダーとOpenRouterの利用方法は異なりますか?
違いは設定方法だけで、種類は同じです。Dyadのプロバイダー一覧で複数ベンダー対応の独立したゲートウェイとして組み込みプリセットがあるのはOpenRouterだけなので、キーだけで設定できます。他のゲートウェイはすべて[Add Custom Provider]から追加し、各モデルのID、Max Output Tokens、Context Windowも手動で入力します。あるゲートウェイをプリセットに追加してほしいという要望に対し、Dyadのメンテナーが案内したのもまさにこの方法です。どちらを選ぶかは、一覧にロゴがあるかではなく、価格、チャージ条件、実際に使いたいモデルで比較してください。
Dyadのカスタムモデルが会話をすぐに要約し始めるのはなぜですか?
Context Window欄が空欄のままになっている可能性があります。空欄の場合、Dyadは128,000トークンをデフォルト値として使い、プロバイダーごとの上限と「コンテキストウィンドウから25,000を引いた値」のうち低い方で会話を圧縮します。カスタムプロバイダーに適用される上限は250,000で、GoogleやOpenAIの上限ではありません。そのため、空欄のままでは、実際のウィンドウが大幅に大きいモデルでも約103,000トークンで圧縮が始まります。プロバイダーのカタログにある正確な値をMax Output TokensとContext Windowに入力すると、しきい値は上限値に移ります。