> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tokenlab.sh/llms.txt
> Use this file to discover all available pages before exploring further.

# Dify

> OpenAIプロバイダーとカスタムベースURLを使用して、TokenLabをDifyに統合する

## 概要

Difyは、OpenAI互換のモデルプロバイダーフローを通じてTokenLabとスムーズに連携します。

これはチャット補完（chat-completions）指向の統合パスです。Difyが専用のCodex統合と同じレスポンスやWebSocketの動作を保証するものではないことに注意してください。

現在のDifyバージョンにおいて、最も安全な手順は以下の通りです：

* 標準の **OpenAI** プロバイダーを選択する
* TokenLabのAPIキーを設定する
* カスタムベースURLに `https://api.tokenlab.sh/v1` を設定する

<Note>
  一部の古いDifyビルドでは、カスタムベースURLフィールドを持つ標準の `OpenAI` プロバイダーではなく、`OpenAI-API-compatible` として公開されている場合があります。お使いのDifyのUIが異なる場合は、そのバージョンで利用可能な、最も近いOpenAI互換のカスタムプロバイダーフローを使用してください。
</Note>

<Note>
  **タイプ**: フレームワークまたはプラットフォーム

  **主要なパス**: OpenAI互換チャットパス

  **サポートの信頼性**: 範囲制限付きでサポート
</Note>

## 前提条件

* APIアクセス権を持つTokenLabアカウント
* Dify Cloudまたはセルフホスト版Dify

## 設定手順

### ステップ 1: APIキーの取得

1. [TokenLabダッシュボード](https://tokenlab.sh/dashboard)にログインします
2. [API Keys](https://tokenlab.sh/dashboard/api)を開きます
3. `sk-` で始まるAPIキーを作成またはコピーします

### ステップ 2: プロバイダーの設定

<Steps>
  <Step title="モデルプロバイダーを開く">
    Difyで、**設定** → **モデルプロバイダー** に移動します
  </Step>

  <Step title="OpenAIを選択">
    **OpenAI** プロバイダーの設定を開きます。お使いのDifyのバージョンでカスタムベースURLが提供されていない場合は、そのバージョンで公開されているOpenAI互換のカスタムプロバイダーオプションを使用してください。
  </Step>

  <Step title="TokenLabの設定を入力">
    以下の値を入力します：

    | フィールド                          | 値                            |
    | ------------------------------ | ---------------------------- |
    | API Key                        | `sk-your-tokenlab-key`       |
    | API Base URL / Custom Base URL | `https://api.tokenlab.sh/v1` |
  </Step>

  <Step title="モデルの追加">
    使用したいモデルを追加します。例：

    * `gpt-5.4`
    * `gpt-5.4-mini`
    * `claude-sonnet-5`
    * `claude-opus-4-8`
    * `gemini-3.5-flash`
    * `gemini-3.1-flash-lite`
    * `deepseek-v4-flash`
  </Step>
</Steps>

### ステップ 3: 接続テスト

1. `gpt-5-mini` や `gpt-4o` などのモデルを1つ選択します
2. テストプロンプトを送信します
3. Difyが有効なレスポンスを受信することを確認します

## ナレッジベース用の埋め込み（Embeddings）

RAGやナレッジベースのインデックス作成には、以下のような埋め込みモデルを追加してください：

* `text-embedding-3-small`
* `text-embedding-3-large`

その後、関連するナレッジベースまたはアプリケーション設定で、デフォルトの埋め込みモデルとして設定します。

## 推奨モデルの役割

| ユースケース    | 推奨モデル                                                      |
| --------- | ---------------------------------------------------------- |
| デフォルトチャット | `gpt-5.4-mini`, `gpt-5.4`, `claude-sonnet-5`               |
| 高度な推論     | `gpt-5.5`, `gpt-5.4`, `claude-opus-4-8`, `deepseek-v4-pro` |
| 高速/安価     | `gpt-5.4-mini`, `gemini-3.5-flash`, `deepseek-v4-flash`    |
| 埋め込み      | `text-embedding-3-small`, `text-embedding-3-large`         |

## ベストプラクティス

<AccordionGroup>
  <Accordion title="標準のOpenAIプロバイダーから始める">
    新しいDifyバージョンでは、カスタムベースURLを備えた標準のOpenAIプロバイダーが、TokenLabにとって最もクリーンなセットアップとなります。
  </Accordion>

  <Accordion title="反復作業には安価なモデルを使用する">
    反復作業中は `gpt-5.4-mini`、`gemini-3.5-flash`、または `deepseek-v4-flash` を使用し、必要に応じてより強力なモデルへ切り替えてください。
  </Accordion>

  <Accordion title="Difyは通常チャット補完指向であることを理解する">
    ほとんどのDifyフローはOpenAI互換のチャット動作を使用します。Codex固有のレスポンスやWebSocketの動作が必要な場合は、Difyではなく専用のCodex統合を使用してください。
  </Accordion>
</AccordionGroup>

## トラブルシューティング

<AccordionGroup>
  <Accordion title="接続エラー">
    * ベースURLが正確に `https://api.tokenlab.sh/v1` であることを確認してください
    * Difyが末尾のスラッシュを重複させる場合は削除してください
    * Difyサーバーがパブリックインターネット経由でTokenLabに到達できることを確認してください
  </Accordion>

  <Accordion title="401 Unauthorized">
    * APIキーを再確認してください
    * TokenLabダッシュボードでキーが有効であることを確認してください
    * Difyに貼り付けた値に余分なスペースや改行が含まれていないことを確認してください
  </Accordion>

  <Accordion title="モデルが見つからない">
    * モデル名を正確に確認してください
    * プロバイダーUIが古い値をキャッシュしている場合は、モデルエントリを再度追加してください
    * TokenLabのドキュメントまたはダッシュボードで、現在のモデルの可用性を確認してください
  </Accordion>
</AccordionGroup>