こんにちは、HolySheep AI公式ブロクです。今日は、AIアプリケーションを簡単に作れるオープンソースツール「Dify」の活用方法を、API経験がまったくない初心者さんに向けてゼロから解説します。

Difyとは?なぜ使うの?

Dify(ディファイ)は、AIアプリケーションを構築するためのオープンソースプラットフォームです。コードを一切書かずに、ドラッグ&ドロップでAIワークフローを作れます。

Step 1:Difyのインストール

まずはDifyをあなたのPCにインストールしましょう。Dockerが必要です。

Docker Desktopのインストール

公式サイト(https://www.docker.com/)からDocker Desktopをダウンロードしてインストールしてください。インストール後、Dockerを起動しておく必要があります。

💡 スクリーンショットポイント:Docker Desktopを起動すると、ステータスバーにクジラのアイコンが表示されます。緑色になったら準備完了です。

Difyのセットアップ

# 作業用フォルダを作成
mkdir dify-workflow
cd dify-workflow

Difyをクローン

git clone https://github.com/langgenius/dify.git

Docker Composeで起動

cd dify/docker cp .env.example .env docker-compose up -d

起動には3〜5分程度かかります。完了したらブラウザで http://localhost:80 にアクセスしてください。

💡 スクリーンショットポイント:初期設定画面が表示されます。「Sign up」をクリックして管理者アカウントを作成してください。

Step 2:HolySheep AI APIキーの取得

DifyでAIを使うには、APIキーが必要です。今すぐ登録してAPIキーを取得しましょう。

HolySheep AIを選ぶべき理由は主に3つあります:

2026年 最新API価格 (/MTok)

Step 3:DifyにHolySheep AIを設定

Difyにログインしたら、モデルプロバイダーとしてHolySheep AIを追加します。

設定手順

  1. Difyダッシュボードの右上にあるアバターをクリック
  2. 「Settings」→「Model Providers」を選択
  3. 「OpenAI Compatible API」をクリック

💡 スクリーンショットポイント:「Add Model Provider」セクションに「OpenAI Compatible API」が表示されます。

# 設定値を入力
Base URL: https://api.holysheep.ai/v1
API Key: YOUR_HOLYSHEEP_API_KEY(HolySheepから取得したキー)

「Save」をクリックして保存

モデルの追加

保存後、同じページで「Add Model」をクリックして、使いたいモデルを追加します。

# 設定例
Model Type: Chat
Model Name: gpt-4o(或其他喜欢的模型)
Base URL: https://api.holysheep.ai/v1(自動入力済み)

💡 スクリーンショットポイント:モデルが追加されると、緑色のチェックマークが表示されます。

Step 4:初めてのAIワークフローを作成

では実際に、簡単なAIチャットボットワークフローを作ってみましょう。

ワークフローの新規作成

  1. ダッシュボードの「Create App」をクリック
  2. 「Start from Blank」を選択
  3. 「Workflow」を選んでアプリ名を「My First Bot」に設定

💡 スクリーンショットポイント:アプリタイプ選択画面では「Workflow」が青色でハイライトされています。

ワークフローエディタの基本操作

ワークフローエディタでは、ノード(ブロック)をドラッグ&ドロップしてAIの流れを構築します。

最初のノードを追加:LLM

  1. 左サイドバーの「Nodes」→「LLM」をワークスペースにドラッグ
  2. ノードをクリックして設定を開く
  3. Modelで「gpt-4o@HolySheep」を選択
  4. Promptに以下を入力:
    あなたは親切なアシスタントです。
    ユーザーの入力に対して、丁寧で簡潔に答えてください。
    
    ユーザー: {{input}}

💡 スクリーンショットポイント:LLMノードの右側に「Input」ドロップダウンがあります。

開始・終了ノードの設定

  1. 「Start」ノードをクリック
  2. 「Add Variable」をクリック
  3. Variable Name: input、Type: Textに設定
  4. 「End」ノードをクリック
  5. 「Add Variable」をクリック
  6. Variable Name: output、Type: Textに設定

ノードを接続

ノード下部の青い点をドラッグして、他のノードの上部の点に接続します。

# 接続順序
Start → LLM → End

💡 スクリーンショットポイント:接続が成功すると、線の上に小さなチェックマークが表示されます。

Step 5:ワークフローをテスト

ワークフローが完成したら、実際に動かしてみましょう。

  1. 画面右上の「Publish」→「Run」をクリック
  2. テスト入力欄に「こんにちは、元気ですか?」と入力
  3. 「Run」ボタンをクリック

数秒待つと、HolySheep AIが生成した回答が表示されます。

💡 スクリーンショットポイント:回答生成中、LLMノードに回転するアニメーションが表示されます。

Step 6:外部からAPIとして呼び出す

Difyで作成したワークフローは、REST APIとして外部から呼び出すこともできます。

APIエンドポイントの確認

  1. アプリダッシュボードの「Improve & Access」→「API Reference」をクリック
  2. 「App ID」と「API Key」をコピー

💡 スクリーンショットポイント:API Referenceページの上部に「Base URL」「App ID」「Secret Key」が表示されます。

cURLでテスト

curl -X POST 'https://api.dify.ai/v1/chat-messages' \
  -H 'Authorization: Bearer YOUR_DIFY_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "inputs": {"input": "AI的好处是什么?"},
    "query": "AI的好处是什么?",
    "response_mode": "blocking",
    "user": "user123"
  }'

HolySheep AIをDifyのバックエンドとして活用することで、非常に低いコストでAPI呼び出しを実現できます。

よくあるエラーと対処法

エラー1:「Connection refused」が出る

Dockerが起動していない、またはDifyサービスが始動していない場合に発生します。

# 対処方法

1. Docker Desktopを再起動

docker-compose down docker-compose up -d

2. ステータスを確認

docker-compose ps

エラー2:「Invalid API Key」が出る

HolySheep AIのAPIキーが間違っているか、有効期限が切れています。

# 対処方法

1. HolySheep AIダッシュボードでAPIキーを再確認

https://www.holysheep.ai/

2. Difyの設定画面に戻り、Base URLとAPI Keyを再入力

Base URL: https://api.holysheep.ai/v1

※ 末尾の/v1を必ず含めること!

エラー3:「Model not found」が出る

Difyに設定したモデル名が間違っている、または利用不可の場合に表示されます。

# 対処方法

1. 利用可能なモデル一覧をHolySheep AIで確認

curl https://api.holysheep.ai/v1/models \ -H "Authorization: Bearer YOUR_HOLYSHEEP_API_KEY"

2. DifyのLLMノードで正しいモデル名を選択

例: "gpt-4o", "claude-sonnet-4-20250514", "deepseek-chat"

エラー4:「Quota exceeded」が出る

APIの使用量上限に達しました。HolySheep AIでは料金が非常に安く設定されているので、额度の追加も簡単です。

# 対処方法

1. HolySheep AIダッシュボードで使用量を確認

https://www.holysheep.ai/dashboard

2. WeChat PayまたはAlipayでチャージ

最低充值額: ¥100〜(汇率1$=¥1)

3. 無人死亡で追加クレジットを受け取るには登録が必要

https://www.holysheep.ai/register

応用:条件分岐を使った高度なワークフロー

基本的なチャットボットが作れたら、条件分岐も試してみましょう。

感情分析ワークフローの作成

  1. 新しいワークフローを作成
  2. Startノードに変数「user_message」を追加
  3. LLMノードを追加し、プロンプトを設定
    以下の文章の感情を「positive」「negative」「neutral」のいずれかで返してください。
    
    文章: {{user_message}}
    感情:
  4. 「Condition」ノードを追加して出力を分岐
  5. 3つの「End」ノードでそれぞれ肯定/否定/中立の回答を返す

💡 スクリーンショットポイント:Conditionノードは紫色のアイコンで、ドラッグしてLLMとEndノードの間に配置します。

まとめ

今回はDifyとHolySheep AIを組み合わせた、AIワークフローの作り方を紹介しました。

APIが初めての方も、この記事を参考にぜひAIアプリケーション作りに挑戦してみてください!


👉 HolySheep AI に登録して無料クレジットを獲得