Skip to main content
Dify を BetterToken に接続するには、API Key を用意し、以下の Base URL を入力して、モデル広場から現在の Model ID を選択します。

​
主要な設定

​
前提条件

​
追加要件

  • Dify Cloud またはプラグインを有効にしたセルフホスト型 Dify インスタンス
  • モデルプラグインのインストールとワークスペースモデルの管理権限
このガイドで設定するのは LLM Chat のみです。GPT チャットモデルを Text Embedding、Rerank、Speech-to-Text、Text-to-Speech として追加しないでください。

​
インストール

​
OpenAI 互換モデルプラグインをインストールする

1

Model Providers を開く

Dify ワークスペースで Integrations > Model Providers を開きます。
2

公式プラグインをインストールする

Install model providers をクリックし、OpenAI-API-compatible を検索してインストールします。Dify はモデルプロバイダーをワークスペースレベルのプラグインとして管理します。インストール後、必要なワークスペース権限を持つアプリはこのプロバイダーからモデルを選択できます。
3

カスタムモデルを追加する

OpenAI-API-compatible カードで Add Model をクリックします。カードに最初に Setup または Configure が表示された場合は、それを開いてからモデル追加のオプションを選択します。

​
手動設定

この設定は Dify のモデルプロバイダー UI で行います。設定ファイルを編集する必要はありません。

​
モデル設定を入力する

最初のモデルには次の値を使用します。
API Base URL には https://www.bettertoken.ai/v1 だけを入力します。Dify プラグインが必要な Endpoint を呼び出すため、/chat/completions は追加しないでください。
残りの任意機能には控えめな値を使用します。
  • Thinking Mode Support：モデルの対応を確認した後にのみ有効にします
  • Stream function calling：最初のテストでは Not Support を選択します
  • Vision Support：モデルと Endpoint の両方が画像入力を受け付ける場合にのみ有効にします
  • Structured Output：通常のチャットが機能するまでオフのままにします
Save をクリックします。Dify が API Key、Base URL、モデル ID を検証します。

​
アプリでモデルを使用する

1

Dify アプリを作成または開く

Chatbot、Agent、Chatflow、Workflow を開きます。
2

モデルを選択する

アプリのモデルセレクターまたは LLM ノードで、OpenAI-API-compatible に追加したモデルを選択します。
3

まず通常のチャットをテストする

最初の Request はツールや画像なしの短いテキスト入力で実行します。
4

その後に Agent 機能を有効にする

通常のチャットが機能した後、ツール呼び出しが必要であればモデル設定を編集します。Function Call Type をモデルが対応するモードに設定します。OpenAI 互換のツール呼び出しでは通常 Tool Call を使用しますが、選択したモデルと Endpoint の対応状況を確認する必要があります。

​
接続を確認する

短いテストプロンプトを送信します。認証エラーや Model ID エラーなしでツールから Response が返れば、接続は機能しています。設定を変更した後はツールを完全に再起動してください。

​
モデルを切り替える

モデルセレクターを開くか、設定内の Model フィールドを変更します。モデル広場にある正確な Model ID を使用し、現在のセッションを再起動します。 Dify はカスタム設定をモデル ID ごとに保存します。対応プロバイダーの別のモデルを追加するには、同じプロバイダーで再び Add Model をクリックします。新しい ID を Model Name と model name for API endpoint の両方に使用します。Base URL と API Key は再利用できます。

​
よくあるエラー

​
保存時に 401 が返る

  • API Key が完全であることを確認します
  • Model ID が対応プロバイダーのものであることを確認します
  • BetterToken Dashboard で Key の状態と残高を確認します

​
保存時に 404 が返る

  • API Base URL は https://www.bettertoken.ai/v1 である必要があります
  • /chat/completions を追加しないでください
  • model name for API endpoint がモデル広場の ID と完全に一致することを確認します

​
Dify が model not found を報告する

Model Name は Dify でのモデルの表示と選択に影響することがあります。実際の Request モデルは model name for API endpoint で制御されます。両方の項目に、対応プロバイダーの同じモデル ID を使用します。

​
通常のチャットは機能するが Agent ツールが失敗する

Function Call Type を Not Support に戻して基本的な LLM ノードを確認します。選択したモデルがツール呼び出しに対応する場合にのみ Tool Call に変更し、ツール引数を再度テストします。

​
Knowledge がこのモデルを Embedding Model として使用できない

これは想定どおりの動作です。チャット LLM は Embedding モデルの代わりにはなりません。このガイドでは Dify 用の BetterToken embedding または rerank Endpoint は確認していません。Knowledge 用には対応する embedding プロバイダーを別途設定してください。

​
高度な設定

​
対応プロバイダー

ここに示す対応状況は、このページで説明する BetterToken の設定方法に適用されます。
  • 手動設定：API Key、Base URL、Model を入力します。
  • 未対応：検証済みの直接接続方法はまだありません。

​
関連ガイド

​
技術的な詳細

この設定では https://www.bettertoken.ai/v1 を使用します。ツールが OpenAI 互換の Endpoint パスを追加します。特定のフィールドで明示的に必要とされない限り、/chat/completions や /responses を追加しないでください。