ロシアでDifyを使う：OpenAI互換APIと最初のワークフロー

Difyでは、公式のモデルプロバイダー OpenAI-API-compatible を通じて外部APIを接続できます。必要なのは、自分のAPI Key、互換性のあるBase URL、現在のModel IDです。設定を確かめるには、テキスト入力、LLMノード1個、テキスト出力からなるワークフローを作り、1回だけ実行して、結果をプロバイダーの記録と照合します。

この workflow に自分の API Key が必要ですか？ BetterToken アカウントを作成

外部アクションなしでDifyを1つのワークフローから試す場合は、BetterTokenのテスト用Keyを分けて使い、最新のDifyガイドを開いてください。このガイドが対象とするのはモデルAPIへの接続です。Difyのインストール、Marketplace、サードパーティ製プラグイン、Agent、Toolは別のレイヤーです。

準備するもの

• 利用可能なDify Cloud、またはセルフホストしたDify環境;
• Integrations/Marketplace と Model Providers へのアクセス;
• 自分のBetterToken API Key;
• BetterTokenのmodel plazaにある現在のModel ID;
• Toolも外部アクションも含まない新規テスト用ワークフロー。

ロシアからBetterToken API EndpointへはVPNなしで接続できます。ただし、Dify Cloud、Marketplace、GitHub、Docker registry、サードパーティ製プラグインの利用可否を保証するものではありません。

1. 公式プロバイダーをインストールする

Difyで Integrations または Marketplace を開き、Model Providers に進みます。公式の OpenAI-API-compatible プロバイダーを探し、まだ利用できない場合はインストールしてください。

Dify公式Marketplaceで、作成者と掲載内容を確認します。似た名前の任意のプラグインは使用しないでください。入力項目やcredentialの処理が異なる可能性があります。

2. BetterTokenモデルを追加する

プロバイダー設定を開き、新しいLLMモデルを追加します。次のように入力します。

1. Model Type: LLM。
2. Model Name / ID: 正確な現在のModel ID。
3. API Key: 自分のBetterToken API Key。
4. API Base URL: https://www.bettertoken.ai/v1。
5. Completion mode: 選択したプロバイダーとモデルで必要な場合は Chat。

Base URLに/chat/completionsを付け加えないでください。完全なパスはプロバイダーが構築します。実際のcredentialをアプリのエクスポート、スクリーンショット、issueにコピーしてはいけません。

UIがcontext size、max tokens、vision、streamingのパラメーターを求める場合は、現在のモデルドキュメントにある値だけを使います。最初のテストに追加機能は必要ありません。

3. credentialを保存して検証する

Difyは保存時にcredentialを検証します。これはプロバイダーが認証手順を完了できたことだけを示し、ワークフロー全体の動作確認にはなりません。

エラーが起きたときは、次の安全な診断情報だけを残してください。

• プロバイダー名とバージョン;
• Model ID;
• Keyを含まないBase URL;
• 短いエラー種別とHTTP status;
• 試行した時刻。

API Keyや完全な機密応答を保存してはいけません。

4. 最小のワークフローを作成する

Workflowタイプの新しいアプリケーションを作成します。追加する要素は3つだけです。

1. questionというテキスト変数を持つ Start。
2. 追加したBetterTokenモデルを使う LLM。
3. LLMの応答テキストを出す End。

LLMには次のシンプルなprompt templateを使います。

1行で答えてください。入力: {{question}}

Start → LLM → End の順に接続します。HTTP Tool、データベース、knowledge retrieval、Agent loop、公開処理は追加しません。最初の失敗の原因を切り分けにくくなるためです。

5. 1回テストを実行する

次の入力を渡します。

2 + 2の合計としてDIFY_OKと数字の4を返してください。

次の条件を満たせば、設定は確認できています。

• Difyが期待どおりのテキストを表示する;
• LLMノードがcredential、model、endpointのエラーなしで完了する;
• BetterToken Dashboardに期待したモデルとstatusの記録が表示される;
• Dashboardにinput、output、該当するcache token、対応する請求が表示される。

Difyの実行とDashboardを照合すると、ワークフローが気付かないうちに別のプロバイダーやモデルを使っていた可能性を除外できます。

エラーを切り分ける

プロバイダーまたはプラグインをインストールできない

これはDify Marketplace/plugin-daemonのレイヤーの問題です。セルフホスト環境では、Difyのバージョン、plugin daemonのネットワークアクセス、HTTPS、証明書チェーンを確認してください。BetterToken API Keyを変更しても解決しません。

ToolProviderCredentialValidationError または 401

Keyを再入力し、余分な空白がないか、選択中のプロバイダーが正しいかを確認します。credentialが無関係なToolプラグインではなく、モデルに属するものであることを確かめてください。

404

Base URLを確認します。

https://www.bettertoken.ai/v1

フィールドがAPI Base URLを求めている場合は、手動で追加した/chat/completionsを削除してください。

model not found

model plazaから現在のIDをコピーします。そのIDが、新しく作成したKeyと選択したOpenAI互換プロバイダーで利用可能かを確認してください。

credentialは保存できるが、ワークフローが失敗する

LLMノードだけをテストします。Tool、streaming、structured outputを外してから、短いテキスト入力／テキスト出力の実行を繰り返します。成功したら、追加ノードを1つずつ戻してください。

この設定で確認できる範囲

最初のワークフローで確認できるのは、公式のOpenAI-API-compatibleプロバイダー経由の1回のモデルリクエストです。すべてのDify Agent、コミュニティプラグイン、Tool、外部サービスとの互換性を証明するものではありません。副作用を伴うアクションごとに別のテストを作成し、明示的なユーザー確認を求めてください。

現在の項目と制限は、Dify向けBetterToken Docsで確認できます。動的なModel IDと価格は、設定する当日に確認してください。