--- title: "Dify の接続" description: "Dify の公式 OpenAI-API-compatible プラグインで 1折AI を設定し、モデルの接続、会話テスト、初回呼び出しの確認を行います。" headingIds: {"準備":"section-1","モデルの追加":"section-2","最初の会話から始める":"section-3","サンプル Chatflow のインポート":"section-4","よくある問題":"section-5","接続サポートの入手方法":"section-6","検証範囲":"section-7","English / Русский":"section-8"} --- Dify ユーザーは公式の **OpenAI-API-compatible** モデルプラグインを使用して、1折AI の OpenAI 互換インターフェースを設定できます。まずテキストモデルを検証し、その後ワークフローで使用します。出所不明のサードパーティプラグインのインストールは不要です。 ## 準備 - モデルプラグインをインストールできる Dify ワークスペース。 - 自分の 1折AI API キーと、そのキーが呼び出し権限を持つモデル ID。[コンソール](https://1zheai.com/console?lng=ja)で確認してください。 - アカウントに十分な利用可能クレジットがあること。モデル保存時の検証リクエストやアプリのテストは通常の API 費用が発生する場合があります。 完全なキーをサポートに送信したり、ワークフローの説明・スクリーンショット・公開リポジトリに書き込んだりしないでください。Dify の API Key キーフィールドにのみ保存してください。サードパーティがホストする Dify を使用する場合、そのインスタンスはあなたのキーを保持し、リクエストを転送します。 ## モデルの追加 1. Dify プラグインマーケットで **OpenAI-API-compatible** を見つけ、公開者が **langgenius** であることを確認します。 2. ワークスペース設定のモデルプロバイダーを開き、このプラグインを見つけ、LLM モデルを追加します。 3. 下の表に従って入力し、保存します。画面の名称は Dify のバージョンによって変わる場合があります。 | フィールド | 入力方法 | | --- | --- | | Model Name / モデル名 | 1折AI コンソールから完全なモデル ID をコピーし、表示名で代用しない | | API Key | 自分の 1折AI キー | | API Base URL | `https://1zheai.com/v1` | | Completion mode / 会話タイプ | `Chat` | | API endpoint 内のモデル名 | 通常は空欄のまま；設定する場合は実際のモデル ID と一致させること | | Model context size | 選択したモデルの実際の能力に従って入力；他のモデルのコンテキスト長をそのままコピーしない | ここには `/v1` が必要です。完全な `/v1/chat/completions` を入力せず、`/v1/v1` と重複させないでください。ルートアドレスのみを入力する他のクライアントの説明をそのまま適用しないでください。 ## 最初の会話から始める 空白のチャットアプリを作成し、先ほど保存したモデルを選択し、「一句の中国語で、あなたにできることを紹介してください」と入力します。完全なテキストが返ることを確認した後、ストリーミング出力を検証します。 1折AI コンソールの呼び出しログで、対応するリクエスト時刻・モデル・結果を確認してください。Dify の「保存成功」だけをアプリ接続の根拠にしないでください。最初の成功後にツール呼び出し・視覚入力・ナレッジベース検索を設定してください。これらの能力は特定のモデルとインターフェースに依存し、テキスト会話が成功したからといってすべて利用可能とは限りません。 ## サンプル Chatflow のインポート [キーなし Chatflow テンプレートをダウンロード](/ja/docs/downloads/1zheai-dify-chatflow.yml)し、Dify Studio で **Create → Import DSL file** を選択してアップロードします。テンプレートは `User Input → LLM → Answer`、DSL バージョン 0.7.0、公式互換プラグイン 0.0.68 を使用します。 まず上記の手順で自分の認証情報を追加してください。インポート後、LLM ノードを開き、Dify の試用モデルではなく自分のプロバイダーとモデルが選択されていることを確認します。サンプルモデル ID は `claude-haiku-4-5-20251001` で、アカウントで利用できない場合は自分の権限を持つモデルに変更し、能力設定を確認してください。テンプレートに API キーは含まれず、無料の呼び出しクレジットも提供されません。 ## よくある問題 | 症状 | 最初に確認すること | | --- | --- | | 503 / No available accounts | 現在のアップストリームが制限中か、利用可能な容量がない可能性があります。まずサービスステータスと呼び出しログを確認し、後で間隔を空けて再試行するかサポートに連絡してください。高頻度での再試行を続けず、キーの再生成を繰り返さないでください | | 401 / キーが無効 | 余分な空白がないか、キーが失効していないか、他のプラットフォームの Key を誤用していないか | | 404 | Base URL が正確に `https://1zheai.com/v1` か；モデル ID が存在するか | | モデルへの権限なしまたはクレジット不足 | 現在のキーのモデル制限、アカウントの利用可能クレジット、選択したモデル | | 保存は成功したがアプリから呼び出せない | アプリが正しいプロバイダーとモデルを選択しているか；ワークスペースのサーバーから API にアクセスできるか | | 通常の回答は正常だがストリーミングが異常 | プロキシの SSE サポート、プラグインバージョン、ストリーミング usage 設定を確認；調査用にマスキングしたエラーを保持してください | | ツール呼び出しまたは視覚が失敗 | 選択したモデルがその能力を実際にサポートしていることをまず確認し、プラグインのスイッチだけを変更して強制的に有効化しないでください | セルフホスト Dify のリクエストはそのサーバーから送信されます。ブラウザで公式サイトを開けることと、Dify サーバーが API に接続できることは別です。 ## 接続サポートの入手方法 公式サイトのオンラインサポートに、Dify バージョン、プラグインバージョン、モデル ID、エラー発生時刻、リクエスト ID、マスキング済みエラー情報を提供してください。完全な Key、顧客データ、ワークフロー内の機密プロンプトは送信しないでください。 ## 検証範囲 2026-10-19 に公式プラグイン 0.0.68 を使用し、Dify Cloud で Haiku のテキスト会話とストリーミング呼び出しを完了し、ゲートウェイログと対応しました。エクスポートしたキーなし DSL は同じワークスペースに新規アプリとしてインポートされました。インポート後の再テストでアップストリームの制限による 503 に遭遇したため、このラウンドをインポート後の実行成功とは記録しません。 これは明確な期間を定めた内部テストであり、継続的な可用性の保証ではありません。新規ワークスペース、旧版 Dify、ツール呼び出し、視覚、ナレッジベース検索は未検証です。自分の制限付きキーで最初のテストを完了してください。 [公式プラグインソースコード](https://github.com/langgenius/dify-official-plugins/tree/main/models/openai_api_compatible) · [Dify プラグインマーケット](https://marketplace.dify.ai/) ## English / Русский **English:** Install the official OpenAI-API-compatible plugin by langgenius. Set API Base URL to `https://1zheai.com/v1`, use your own API key and an exact model ID available to your account, and select Chat mode. Test a simple conversation before adding tools or vision. Text and streaming calls were verified in Dify Cloud on 2026-10-19. DSL import into a new app in the same workspace succeeded; its subsequent run encountered an upstream-capacity 503. Fresh-workspace import and advanced capabilities remain unverified. Never share your key with support. **Русский:** Установите официальный плагин OpenAI-API-compatible от langgenius. Укажите API Base URL `https://1zheai.com/v1`, собственный API-ключ и точный ID модели, доступной вашему аккаунту; выберите режим Chat. Сначала проверьте простой диалог, затем потоковый вывод. Текстовые и потоковые вызовы проверены в Dify Cloud 19 октября 2026 года. Импорт DSL в новое приложение того же рабочего пространства прошёл, но повторный вызов вернул 503 из-за недоступной мощности upstream. Новое рабочее пространство и расширенные функции ещё не проверены. Не отправляйте ключ службе поддержки. Доступность из конкретной сети и способы оплаты проверяются отдельно.