独自のモデルキーを接続する

モデルプロバイダーまたはゲートウェイのキーを使用します。接続を成功させるには、プロバイダー、エンドポイント、モデル ID、アカウント権限が一致している必要があります。

接続情報を用意する

呼び出すサービスの API キー、その API の Base URL、利用可能なモデル ID、および互換性のあるプロトコルまたはプリセットが必要です。一般消費者向けチャットサイトのアカウントを持っているだけでは、API へのアクセス権や API クレジットは付与されません。

プロバイダーを選択し、そのキー、API の Base URL、モデルを一致させます。

Free を含むすべてのプランで BYOK を利用できます。プロバイダーキーでは、OpenDesign の残高ではなく、そのプロバイダーの請求と利用枠が適用されます。

プロバイダーを追加する

Settings → Models & providers → API providers を開きます。
キーを発行したサービスのプリセットを選択します。Custom provider の場合は、そのサービスのドキュメントに記載されたプロトコルに合わせます。
API Key にはシークレットだけを貼り付けます。Bearer、引用符、JSON 設定のラッパーは追加しないでください。
Base URL を確認します。プリセットのアドレスがロックされている場合は、別のエンドポイントを入力する前に、カスタム URL オプションを使用します。
利用可能なリストからモデルを選択するか、Custom で正確な API モデル ID を入力します。モデルを読み込めるかどうかは、サービスとアカウントによって異なります。
Test を実行します。応答内容を確認してください。テストの成功は、この小さなリクエストが検証されたことを意味し、すべてのツール、メディアモデル、今後のリクエストを保証するものではありません。
保存完了の確認が表示されるまで待ちます。設定を開き直してプロバイダー、アドレス、モデルを確認した後、プロジェクトに戻り、小さなタスクを送信する前にその接続を選択します。

キーは非公開にしてください。ローカルで確認する場合は Show でフィールドの内容を表示できますが、スクリーンショットを共有する前に必ずキーを隠してください。

OpenRouter では、独自のキー、ゲートウェイアドレス、プロバイダー接頭辞付きのモデル ID を使用します。

例：DeepSeek

DeepSeek Platform でキーを作成します。Base URL には https://api.deepseek.com を使用し、アカウントから呼び出せるモデルを選択します。モデル ID（例：deepseek-flash）はプロバイダーの最新のモデル一覧で確認してください。一方、インストール済みクライアントのスクリーンショットには古いプリセットの別名が残っています。必要に応じて、現在の ID をカスタムモデルとして入力してください。インストール済みの 0.25.0 では、Get key ショートカットから誤ったプロバイダーページが開くことがあります。無関係な OpenAI キーを作成せず、プロバイダー独自のコンソールを使用してください。

フィールド	DeepSeek 直接接続の例
プロバイダー／プロトコル	DeepSeek プリセット、または OpenAI プロトコルと互換性のあるカスタムプリセット
API Key	DeepSeek Platform アカウントによって発行されたキー
Base URL	https://api.deepseek.com
モデル ID	アカウントで有効になっている場合は deepseek-flash

古いスクリーンショットの表示名ではなく、最新の DeepSeek API ドキュメントから正確な ID をコピーしてください。この OpenAI プロトコルの例では、別個の /anthropic エンドポイントを使用しないでください。

例：OpenRouter

OpenRouter のキー設定でキーを作成します。https://openrouter.ai/api/v1 を使用してください。OpenRouter の利用可能なモデル一覧から、プロバイダー接頭辞を含むモデル ID をコピーします。Anthropic または OpenAI の直接接続用キーを OpenRouter プリセットに入力しないでください。キーは、リクエストを受信するゲートウェイに属している必要があります。

API providers で OpenRouter を選択し、OpenRouter が発行したキーを貼り付けます。
Base URL には https://openrouter.ai/api/v1 を使用します。
OpenRouter モデルディレクトリから、プロバイダー接頭辞を含む正確なモデル ID をコピーします。
接続をテストし、保存されるまで待ってから、リクエストを実行する前にプロジェクトでその接続を選択します。

別のプロバイダーを確認する

項目	確認する内容
プロトコル	プリセットは、ドキュメントに記載された API プロトコルと一致している必要があります。
Base URL	ダッシュボードのパスや重複したバージョン部分を含めず、プリセットが想定する API ルートを使用します。
モデル	マーケティング名ではなく、API モデル ID を使用します。
権限	プロバイダーアカウントで、モデルへのアクセス権、地域での提供状況、クォータ、請求設定を確認します。

キーだけでは実行環境は整いません

BYOK タスクでも、エージェントのファイル操作やツール操作を実行する、サポート対象のランタイムが必要です。ランタイムを利用できないとアプリに表示された場合は、そのランタイムのインストール手順または再スキャン手順に従ってください。キーを交換しても実行ファイルはインストールされません。

請求について理解する

BYOK リクエストの料金は、入力したキーを発行したプロバイダーまたはゲートウェイから請求されます。OpenDesign のサブスクリプションと外部プロバイダーの残高は別々です。有効なキーでもタスクを実行できない場合は、請求と接続のトラブルシューティングを参照してください。

テスト結果を確認して復旧する

結果	次の対応
401 / 無効なキー	発行元のサービスを確認し、余分な書式を追加せずに完全なキーを貼り付けます。失効したキーは発行元で再発行してください。
403 / アクセス拒否	プロバイダーで、モデルの権限、地域、アカウントのアクセス権を確認します。有効なシークレットだけではモデルへのアクセス権は付与されません。
404 / モデルが見つからない	API ルートと正確なモデル ID を確認します。ダッシュボードのパスと重複した /v1 部分を削除してください。
429 / クォータまたはレート制限	プロバイダーのエラーを読み、残高不足なのか一時的なレート制限なのかを判別します。再試行する前に、そのアカウントコンソールを確認してください。
タイムアウト／ネットワークエラー	クライアント環境からこのエンドポイントに到達できるか確認します。ネットワークの問題を解決してから、小さなリクエストを再試行してください。

テストが成功したら、既存のプロジェクトで小さなリクエストを 1 件送信し、その応答と作成されたファイルを確認します。テストには合格してもファイル操作に失敗する場合は、実行環境のセクションで説明しているランタイムを確認してください。正常に動作するキーを繰り返し交換しないでください。