ドキュメント

ドキュメント

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
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
ベース URL には /v1 も含めますが、その根拠はドキュメントにはありません。カスタムモデルのページには「通常、API Base URL はプロバイダーのドキュメントで確認できます」とあるだけで、例は掲載されていないため、この点は明確になりません。実際のアプリの2つの動作が答えを示しています。ダイアログのプレースホルダーには E.g., https://api.example.com/v1 とあり、カスタムプロバイダーは OpenAI 互換クライアントとして構成され、入力した値が変更されずに baseURL として使われます。Dyad が追加するのはルートであり、/v1 ではありません。Dyad が独自にハードコードしている OpenAI 互換エンドポイントも、すべて同じ形式で終わります。ベース URL にこれがないと、キーが拒否されるのではなく 404 エラーになります。
ドキュメントのページにないフィールドが2つあります。実際のダイアログでは、1つ目は ID ではなく Provider ID と呼ばれており、Environment Variable (Optional) も追加されています。これは KUNAVO_API_KEY のような変数名で、設定にキーが保存されていない場合にのみ読み込まれます。キー自体はこのダイアログにありません。先にプロバイダーを作成してから開き、そのページにある Set Kunavo API Key 欄を使ってください。
Context Window は入力してください。空欄のままにしないでください。Dyad が示す注意点は、空欄の場合「最適な値より小さい可能性のあるデフォルト値」が使われるということだけです。実際のデフォルト値は128,000トークンで、Dyad はプロバイダーごとの上限と、コンテキストウィンドウから25,000を引いた値のうち小さい方で会話を圧縮します。カスタムプロバイダーは custom:: ID で保存されるため、Google 用でも OpenAI 用でもなく、250,000の上限が適用されます。空欄のままだと、100万トークンのモデルでも250,000トークンではなく103,000トークンで要約が始まります。同じ作業に対して圧縮の回数が増えるだけです。
この設定は、以下の日付時点で確認した Dyad のドキュメントと実際のソースコードに基づいています。Kunavo は Dyad からエンドポイントへの接続を実行していません。ビルドも、ストリーミング編集も、Agent モードでのツールの往復呼び出しも試していません。この系列のすべてのクライアントについて同様です。設定手順を公開していることは、互換性のテストを意味しません。試す際は、現在動作している接続方法も引き続き使える状態にしておき、プロジェクトで使い始める前に、範囲を限定した機能を1つ実行してください。
Kunavo は埋め込み、テキスト読み上げ、音声認識モデルを提供していないため、この方法で追加したカスタムプロバイダーが対応するのはチャット補完のみです。Dyad のビルドループでは残り3つの機能を使わないため、ここで機能が失われることはありません。これは、これらの機能も必要とするスタックでは、追加したプロバイダーをそのまま代替として使うことはできないという意味にすぎません。
まだキーをお持ちですか?Kunavoアカウントを作成し、キーを作成します(sk-kn-で始まります)。$10からクレジットを追加すると、呼び出しはその残高から支払われ、失敗した呼び出しは課金されません。ダッシュボードを開くと、Dyad設定が表示されます。

手順

  1. /app/keys でキーを作成してコピーします。キーは一度だけ表示されます。
  2. Dyad で Settings を開き、AI Providers セクションを見つけて、Add Custom Provider をクリックします。上記のとおり、ID、Display Name、API Base URL を入力します。ID は「内部で使用され、後から変更できない」ため、今後も使い続けられるものを選んでください。Display Name はモデル選択メニューに表示される名前で、見た目だけに使われます。
  3. 作成したプロバイダーを開き、キーを Set Kunavo API Key に貼り付けて、Save Key をクリックします。ベース URL が空欄だと、Dyad はネットワークエラーではなく API Base URL が未指定 エラーを返し、リクエストを拒否します。
  4. 同じページの一番下までスクロールし、Add Custom Model をクリックします。Model ID にはカタログのスラッグを正確に指定してください。Dyad のドキュメントには「プロバイダーの API ドキュメントに記載されたものと正確に一致している必要があります。これは API に送信される識別子です」とあります。つまり、表示名ではなく claude-sonnet-5 を指定します。
  5. Max Output Tokens と Context Window に /models の値を入力し、空欄のままにしないでください。その後、モデル選択メニューに追加したい ID ごとに Add Custom Model を繰り返します。ここには一括インポートも、モデル一覧の取得機能もありません。
  6. 新しいモデルをモデル選択メニューから選び、実際のタスクを与えてください。挨拶ではなく、追加するコンポーネントなどを依頼します。Build モードは各ステップで作業セットを再送信するエージェントループのため、最初の実行ではストリーミングと繰り返し編集を試してください。

Dyad の Custom Models ページで2026年9月21日に確認しました。サードパーティの設定は変更されます。ここに記載されたフィールド名が表示内容と一致しなくなった場合は、このページではなく、そのページを正しい情報源としてください。

これが短い概要です。完全な手順 — モデルの選択、実際のセッション費用、失敗するケース — はDyad の料金と API コストに関するガイドにあります。

クライアントをデバッグする前に確認すること

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で、入力 / 出力の順です。

モデル IDKunavo 入力 / 出力Dyadでの位置付け
claude-sonnet-5$1.40 / $7.00Build モードのデフォルトモデル — 終日実行されるループで、1ドルあたりのコーディング品質を重視
claude-opus-5$3.50 / $17.50計画の誤りがセッション全体のコストにつながる、リファクタリング時の Plan モード
claude-haiku-4-5$0.70 / $3.50Ask モードやコードベースに関する簡単な質問。呼び出し量が中心
gpt-5-6-sol$2.00 / $12.00別のファミリーからのセカンドオピニオン — 同じプロバイダーに2つ目のカスタムモデルとして追加
gpt-5-6-terra$0.70 / $4.20Context Window フィールドに正しい値を設定したうえで、大きな作業セットを扱う場合
請求は月額料金なしの前払い残高からトークン単位で行われます — 請求を参照してください。繰り返し送られるコンテキスト(エディターやチャットクライアントが送る内容の大半)では、プロンプトキャッシュのほうがモデル選択より請求額を大きく左右します。

切り替える前に知っておくべき3つの制約

これらは Kunavo ではなく Dyad 独自のルールで、それぞれが顧客キーで利用できる範囲を変えます。そのため、このページでは Dyad のすべての機能ではなく、モデルへの接続方法を説明しています。

  1. 設計上、独自のキーでは Pro モードを利用できません。Dyad の料金に関する FAQ には、Smart Context などの Pro モードは複数のモデルにわたるサーバー側処理を必要とするため、独自の API キーではなく Dyad Pro の AI クレジットでのみ利用できると明記されています。もう1つの対象は Turbo Edits です。カスタムプロバイダーを追加するとモデルと通常モードを利用できますが、これらの機能は利用できません。
  2. 無料プランではAgentモードの利用回数に上限があります。 23時間ごとの期間につきAgentメッセージは20件までで、この上限は誰のキーを設定するかにかかわらず適用されます。Build、Ask、Planには上限がありません。そのため、セッションの途中で予期せず停止した場合、残高やエンドポイントではなくDyadの利用上限が原因かもしれません。
  3. 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に入力すると、しきい値は上限値に移ります。