作成する内容
各プロバイダを個別に設定せずに、Dify により多くの AI モデルを追加できる API サービスはどれでしょうか？実用的な選択肢のひとつが CometAPI です。Dify の CometAPI モデルプラグインを一度インストールし、CometAPI キーを 1 つ保存するだけで、同じ Dify ワークスペース内で OpenAI、Anthropic、Google、DeepSeek のモデルを利用できます。
キーが 1 つでも、モデル設定は 1 つとは限りません: CometAPI は認証と API アクセスを一元化しますが、どの LLM ノードがどのモデルを呼び出すべきかは Dify に知らせる必要があります。したがって、同じプロバイダ接続の下で複数のモデル ID を設定することがあります。
このガイドを読み終える頃には、1 つのプロバイダ接続の下で 4 つのテキストモデルを Dify で利用できるようになります。加えて、Dify の外で同じエンドポイントとキーを使う小さな Python のスモークテストも用意し、Dify の設定問題と API 側の問題を切り分けやすくします。
プロバイダ接続を保存したら、各モデル ID を個別の選択可能な設定として追加または有効化します。これにより、認証と課金の接続を共有したまま、モデル固有の機能、制限、ルーティングの判断を可視化できます。
開始前の準備
モデルプラグインをインストールできる Dify ワークスペース、CometAPI の API キー、最新のモデル ID が必要です。キーは Dify のクレデンシャルストアまたはサーバー側のシークレットに保管し、公開リポジトリ、ブラウザバンドル、スクリーンショット、共有されたワークフロー書き出しに含めないでください。
OpenAI 互換のベース URL は https://api.cometapi.com/v1. です。CometAPI の Dify プラグインは内部でこのエンドポイントを設定します。Dify の汎用 OpenAI-API 互換プロバイダを使う場合は、同じベース URL を手動で入力してください。
1 つの API キーで複数の AI モデルを Dify に追加できますか？
はい。CometAPI のプロバイダ接続を使うと、OpenAI、Anthropic、Google、DeepSeek などの対応モデルに対して 1 つのクレデンシャルを Dify で再利用できます。各 LLM ノードがどのルートを呼ぶべきかを示すため、各モデル ID は個別に設定しますが、モデルファミリーごとに異なる上流のクレデンシャルや課金アカウントを維持する必要はありません。
各プロバイダを直接接続する代わりに CometAPI を使う理由は？
CometAPI は、互換チャットのワークロードに対して 1 つのベース URL、1 つの API キー、1 つの利用アカウントを提供することで、統合作業を軽減します。これにより、Dify 内でのモデル評価や切り替えが容易になりつつ、モデル固有の選択も可視化されます。とはいえ、プロバイダ専用の機能、契約、地域デプロイ、サポートが必要な場合は直接接続が適していることもあるため、ワークフローで必要な正確なモデル機能をテストしてください。
Dify に追加できるモデルは？
| ファミリー | CometAPI モデル ID | CometAPI 公開日（UTC） | ライブ料金 |
|---|---|---|---|
| OpenAI | gpt-5.6 | July 9, 2026 | 現在の料金を表示 |
| Claude | claude-opus-5 | July 24, 2026 | 現在の料金を表示 |
| Gemini | gemini-3.7-flash | August 13, 2026 | 現在の料金を表示 |
| DeepSeek | deepseek-v4-flash | August 12, 2026 | 現在の料金を表示 |
上記の最新 ID と CometAPI 公開日は、2026 年 8 月 26 日に public catalog API と照合しました。固定のレートをコピーするのではなく、各リンク先の CometAPI モデルページを動的な料金ソースとして使用してください。提供状況、モダリティ、Dify プラグイン対応も変わり得るため、デプロイ前にアカウント内の該当モデルを必ず確認してください。
CometAPI を Dify に接続する方法
Step 1 — CometAPI モデルプラグインをインストール
Dify の Marketplace または Plugins セクションで CometAPI を検索します。CometAPI model provider plugin をインストールしてください。Dify Cloud とセルフホスト版でナビゲーションのラベルは異なる場合があるため、固定のメニューパスに頼らず、プラグインの現行の設定画面を使用してください。
Step 2 — CometAPI プロバイダを設定
CometAPI プラグインの現行の設定画面を開き、CometAPI キーを貼り付けてプロバイダのクレデンシャルを保存します。Dify は小さなモデルリクエストで検証する場合があります。プラグインは互換チャットのワークロードを https://api.cometapi.com/v1 にルーティングするため、OpenAI、Anthropic、Google、DeepSeek の個別のクレデンシャルは不要です。
Dify のデプロイで CometAPI プラグインをインストールできない場合は、代わりに公式のOpenAI-API 互換モデルプロバイダをインストールします。各モデルを Chat モードの LLM として追加し、同じ CometAPI キーを再利用し、API Base URL を https://api.cometapi.com/v1. に設定します。このフォールバック手順ではモデルごとにカスタムエントリを作成する必要がありますが、プロバイダごとのアカウントを避けられます。
Step 3 — 4 つのモデル ID を追加
CometAPI プロバイダに戻り、モデル一覧から 4 つの ID を探します。ID がすでに定義済みの場合は有効化してください。インストール済みプラグインのバージョンにまだ表示されていない場合は、プロバイダのカスタムモデルオプションを選び、上の表の正確な現行 ID を入力します。Completion mode は Chat のままにします。
Dify がカスタムモデルのコンテキストサイズを求める場合は、推測値ではなく確認済みの値を使用してください。マルチモーダルの切り替えでは、ライブカタログに示されている機能のみを有効化します。あるモデルが Chat Completions をサポートしていても、画像、ツール、構造化出力、推論制御を別のモデルと同じようにサポートするとは限りません。
Step 4 — Dify アプリでモデルを選択
Dify Studio の Chatflow、Workflow、Agent、チャットボットを開きます。LLM ノードを追加し、プロバイダに CometAPI を選んで、設定済みモデル ID のいずれかを選択します。「モデルファミリーを 1 文で答えてください」のような短いプロンプトを使い、ノードを実行します。他の 3 モデルでも繰り返してください。変更するのは選択したモデル ID のみで、プロバイダのクレデンシャルは同じです。
Python で接続をテストする方法
Dify を介さずに同じ 4 つのルートをチェックするため、このスタンドアロンのスモークテストを使用します。OpenAI Python SDK をインストールし、環境変数に COMETAPI_KEY を保存し、信頼できるマシンからスクリプトを実行します。成功結果はキー、エンドポイント、現行モデル ID を検証しますが、実際の Dify ワークフロー内でのテストの代替にはなりません。
import osfrom openai import OpenAIMODELS = { "OpenAI": "gpt-5.6", "Claude": "claude-opus-5", "Gemini": "gemini-3.7-flash", "DeepSeek": "deepseek-v4-flash",}client = OpenAI( api_key=os.environ["COMETAPI_KEY"], base_url="https://api.cometapi.com/v1", timeout=30.0, max_retries=2,)for family, model in MODELS.items(): try: response = client.chat.completions.create( model=model, messages=[ {"role": "user", "content": "Reply with one short sentence."} ], ) text = response.choices[0].message.content or "" print(f"{family}: OK | {response.model} | {text[:80]}") except Exception as error: print(f"{family}: ERROR | {type(error).__name__} | {error}")
このテストは Dify ワークフローの外で実施してください。役割はキー、エンドポイント、モデル ID を検証することです。ここでモデルが成功するなら、Dify の失敗はプラグイン設定、モデル機能の設定、もしくはワークフロー自体に起因する可能性が高いと考えられます。
デプロイ前にモデル提供状況を検証する方法
デプロイ前に、現在の CometAPI モデルディレクトリ または Models API でモデルの提供状況を検証できます。アカウント内に該当のモデル ID が存在することを確認し、プロダクションの Dify ワークフローに追加する前に小さな認証済みリクエストを実行してください。
自身のキーで、非ストリーミング呼び出しが成功すると Chat Completions オブジェクトが返ります。生成文言は異なりますが、レスポンスには次のフィールドが含まれるはずです:
{ "id": "chatcmpl-...", "object": "chat.completion", "model": "the-routed-model-id", "choices": [ { "index": 0, "message": { "role": "assistant", "content": "..." }, "finish_reason": "stop" } ], "usage": { "prompt_tokens": 0, "completion_tokens": 0, "total_tokens": 0 }}
Dify では、同等の成功シグナルは出力パネルにテキストが表示された完了済みの LLM ノードです。選択したモデル、経過時間、トークン使用量、正規化されたプロバイダエラーについては Dify の実行ログを確認してください。
Dify に適したモデルを選ぶ方法
プロバイダ名ではなくワークロードから始めてください。難易度の高い推論、大規模コードベース作業、高付加価値の回答にはフロンティアモデルを、インタラクティブなチャットや繰り返しのワークフローステップには高速なモデルを、分類・抽出など範囲の限られたタスクには低コストのテキストモデルを選びます。同じプロンプトセットでモデルを比較し、回答品質、レイテンシ、トークン使用量、ツール動作、成功 1 回あたりのコストを記録してください。また、選択したルートが必要なすべての入力と機能をサポートしていることを確認します。共通の CometAPI 接続により切り替えは簡単になりますが、コンテキスト上限、マルチモーダル入力、ツール、構造化出力、推論制御はモデル間で同一にはなりません。
よくあるトラブルと解決策
Dify が 401 でクレデンシャルを拒否する。 CometAPI ダッシュボードからキーをコピーし直し、前後のスペースを取り除いてください。Dify の API Key フィールドに Bearer の語を含めないでください。プラグインが認証ヘッダーを組み立てます。
汎用プロバイダが 404 や HTML を返す。 ベース URL は完全な https://api.cometapi.com/v1. を使用してください。Dify のベース URL に /v1 を省略したり /chat/completions を追加したりすると、最終パスが誤ることがあります。
モデルが Dify に表示されない。 CometAPI プラグインを更新し、ID をライブカタログと照合してください。現行 ID が定義済みでない場合は、同じ CometAPI プロバイダの下でカスタムモデルとして追加します。似た名前のモデルで代用しないでください。
テキストは動くが画像やツールが失敗する。 OpenAI 互換性はリクエストの表面仕様を示すものであり、API の振る舞いが OpenAI と同一であることを意味しません。モデルに記載のモダリティと、プラグインのビジョン、ツール呼び出し、構造化出力、推論設定を再確認してください。
リクエストがコンテキストウィンドウを超える。 Dify のカスタムモデルのコンテキストサイズを確認し、取得ドキュメントや会話履歴を短縮し、出力分の余地を確保してください。カタログ上の大きなコンテキストは、Dify のワークフロー制限やプロバイダ固有のトークンルールを取り除くものではありません。
429 や断続的な 5xx エラーを受け取る。 429、タイムアウト、一時的なサーバーエラーは指数バックオフとジッターでリトライしてください。認証エラー、無効なモデル、誤ったリクエストは自動リトライしないでください。
運用上の注意
シークレットはサーバー側に保管。 開発と本番で CometAPI キーを分け、適切なクォータを設定し、露出したキーはローテーションし、Dify アプリの書き出しに実クレデンシャルを含めないでください。
テスト済みのモデル ID を固定。 カタログに新しい名前が現れたからといって、モデルを黙って置き換えないでください。同一プロバイダでも、能力、レイテンシ、出力スタイル、価格はバージョン間で変わり得ます。
ルートごとに計測。 本番の各呼び出しについて、モデル ID、レイテンシ、トークン使用量、エラーコード、Dify アプリのバージョンを記録します。これにより、印象に頼らずにモデル比較やコスト変化の調査が可能になります。
機能単位でフォールバック設計。 ルーティンなトラフィックには低コストモデル、エスカレーションには高性能モデルを使いますが、同じ入力と必要なツールをサポートするモデル同士だけを組み合わせてください。切り替え前に一時的失敗はリトライし、合計レイテンシの上限を設け、すべてのフォールバックルートをテストします。プロダクションパターンは CometAPI のモデルフォールバックガイドを参照してください。
ローンチ前に価格を再確認。 この記事のレートは時点のスナップショットであり契約ではありません。予算設定やコストの公表前に、料金ガイドとライブのモデルディレクトリを確認してください。
FAQs
CometAPI 経由で OpenAI を Dify に追加する方法は？
CometAPI モデルプロバイダプラグインをインストールし、CometAPI キーを保存し、gpt-5.6 を選択可能な LLM モデルとして追加します。Dify が補完モードを尋ねたら Chat を選び、短いテキストプロンプトを実行してから、本番ワークフローで有効化してください。現行の CometAPI カタログは、互換チャットおよび Responses ワークロード向けのルートを掲載していますが、Dify のプラグイン対応はバージョンにより異なることがあります。ID が定義済みでない場合は、プラグインを更新するか、カスタムモデルオプションを使用してください。共有のプロバイダクレデンシャルは変更せず、画像入力、ツール呼び出し、構造化出力、推論設定は依存前に個別に検証してください。
CometAPI 経由で Claude を Dify に追加する方法は？
同じ CometAPI プロバイダ接続の下で、claude-opus-5 を別の LLM モデルとして追加し、Claude が必要な Dify ノードで選択します。CometAPI カタログには現在、このモデル向けに Anthropic Messages と OpenAI 互換のチャットルートの両方が記載されています。Claude の ID、対応入力、トークン上限、振る舞いは OpenAI ルートと異なるため、Dify には独自のモデルエントリが必要です。短い応答と、代表的な長文またはツール補助タスクをそれぞれテストし、本番化前に Dify 実行ログで実際のモデル、レイテンシ、トークン使用量、正規化されたエラーを確認してください。
CometAPI 経由で Gemini を Dify に追加する方法は？
既存の CometAPI プロバイダの下で gemini-3.7-flash を追加し、該当する Dify の LLM ノードでそのエントリを選択します。CometAPI には現在、ネイティブの Gemini generating-content ルートと OpenAI 互換のチャットルートの両方が記載されています。基本的な Dify のチャットワークフローではテキストのみから始め、成功を確認してから画像、PDF、音声、動画入力をテストしてください。これらのモダリティは、モデルカタログに記載があってもプラグインのバージョンやノード設定に依存する場合があります。Gemini は個別のモデル設定として維持し、他ルートとの速度、品質、コストを比較できるようにしてください。
CometAPI 経由で DeepSeek を Dify に追加する方法は？
同じ CometAPI プロバイダのクレデンシャルを再利用しつつ、deepseek-v4-flash の Dify モデルエントリを別途作成します。現行の CometAPI カタログでは、このルートはテキスト間のチャットワークロード向けに記載されているため、OpenAI、Claude、Gemini の設定から画像関連の設定を転用しないでください。まず短いテキストプロンプトをテストし、続いて実際に実行予定のコーディングや推論タスクを試してください。モデルが Dify に見当たらない場合は、プラグインを更新するか、正確な現行 ID をカスタムモデルオプションで追加します。プロダクションにルーティングする前に、ライブのモデルページで動的な料金と提供状況を再確認してください。
同じ Dify ワークフローで OpenAI、Claude、Gemini、DeepSeek を併用できますか？
はい。各 LLM ノードは異なるモデルプロバイダ／モデル設定を使用できます。CometAPI を使えば、対応モデルは同じプロバイダクレデンシャルを共有しつつ、ワークフローが異なるモデル ID を選べます。
1 つの CometAPI キーで本当に Dify の OpenAI、Claude、Gemini、DeepSeek をカバーできますか？
はい。Dify の CometAPI モデルプラグインは 1 つのプロバイダクレデンシャルを保存し、それをこれらファミリーにまたがる対応モデルで使用します。Dify にどのモデルを呼ぶかを知らせるため、各モデル ID は引き続き選択または追加します。
Dify に CometAPI のベース URL を入力する必要はありますか？
専用の CometAPI プラグインを使用する場合は不要です。内部で https://api.cometapi.com/v1 を設定します。Dify の汎用 OpenAI-API 互換モデルプロバイダを使用する場合のみ、そのベース URL を手動入力してください。
Dify は OpenAI 互換 API 経由の Claude をサポートしますか？
Dify は OpenAI 互換のモデルプロバイダと連携できますが、互換性は Claude の API 振る舞いが OpenAI と同一であることを意味しません。ツール、構造化出力、ビジョン、推論固有の機能を有効化する前に、モデルの対応パラメータと機能を検証してください。
すべてのモデルで同じ Dify 設定を使えますか？
いいえ。エンドポイントとキーは共有できますが、コンテキスト上限、モダリティ、ツール対応、推論制御、レイテンシ、価格はモデル固有です。各モデルのマッピングをテスト済みの設定として扱ってください。
どのモデルをデフォルトにすべきですか？
自身のプロンプトでテストしてから決めてください。低コストのモデルは日常的な分類や書き換えを処理でき、より強力なモデルは複雑な推論や高付加価値の応答を担えます。ワークロードのデータなしに、普遍的な「ベスト」を主張するのは避けましょう。
結論
CometAPI を使うと、Dify ワークスペースは互換チャットワークロードに対して 1 つのプロバイダクレデンシャルと 1 つの統一 API エンドポイントで OpenAI、Claude、Gemini、DeepSeek を利用できます。セットアップは簡潔です。モデルプラグインをインストールし、キーを保存し、現行のモデル ID をマッピングし、各ルートをテストします。運用上の作業は依然としてモデル固有であり、機能、コンテキスト、価格、フォールバックの挙動は想定ではなく検証すべきです。