メインコンテンツへスキップ

Documentation Index

Fetch the complete documentation index at: https://docs.elkapi.com/llms.txt

Use this file to discover all available pages before exploring further.

​
準備

始める前に、以下を確認してください：
  1. Difyアカウントの登録済み
    Dify公式サイトにアクセスしてアカウントを登録し、クラウド版または自己ホスト版を選択
  2. ElkAPI APIキーの取得済み
    ElkAPIコンソールにログインしてAPIキー（sk-で始まる）を取得
ヒント： ElkAPIアカウントをお持ちでない場合は、まずElkAPIで登録してAPIキーを取得してください。

​
ステップ1：Difyにログインして設定にアクセス

​
1.1 Difyプラットフォームへのアクセス

  • クラウド版： https://cloud.dify.aiにアクセスしてログイン
  • 自己ホスト版： お使いのDifyデプロイメントアドレスにアクセス
Dify メインインターフェース

​
1.2 モデル設定ページへの移動

  1. 右上のアバターアイコンをクリック
  2. 設定を選択
  3. 左メニューでモデルプロバイダーを選択
モデルプロバイダー設定ページ
注意： Difyは複数のモデルプロバイダーの設定をサポートしています。ElkAPIを他のプロバイダーと並行して使用できます。

​
ステップ2：ElkAPIモデルプロバイダーの追加

設定方法の説明： DifyでElkAPIを設定する方法は2つあります：方法1（推奨）： OpenAIプロバイダーのカスタムAPI機能を使用
  • OpenAIプロバイダー設定でBase URLをhttps://api.elkapi.com/v1に直接変更
  • ElkAPIのAPIキーを入力
  • より高速で簡単な設定
方法2： カスタムモデルプロバイダーとして追加（本ガイドの方法）
  • より柔軟で、ElkAPIプロバイダーを個別に管理可能
  • 複数のAPIプロバイダーを同時に使用する場合に便利
どちらの方法も機能的には同じです。お好みに応じて選択してください。

​
2.1 設定方法の選択

​
方法1：OpenAIカスタムAPIを使用（推奨）

  1. モデルプロバイダーページでOpenAIプロバイダーを見つける
  2. 設定ボタンをクリック
  3. 設定ページで：
    • API Key：ElkAPI APIキーを入力（sk-xxxxxxxxxxxx）
    • API Base URLまたはBase URL：https://api.elkapi.com/v1を入力
  4. 保存をクリック
OpenAI カスタムAPI設定
OpenAI カスタムAPI設定
  1. 設定完了後、OpenAIプロバイダーページに戻り、モデルリストを表示
  2. モデルリストで、使用したいモデルを見つける（例：gpt-5.5、gpt-5.4-mini、gpt-5.5など）
  3. モデル右側のスイッチをクリックして有効化（青色は有効を示す）
OpenAI モデルリスト
重要： ElkAPIが実際にサポートしているモデルのみを有効化してください！DifyのOpenAIモデルリストには多くのモデルが表示されますが、ElkAPIがサポートしているモデルのみが正常に動作します。サポートされていないモデルを有効化すると、API呼び出しが失敗します。サポートされているモデルの完全なリストについては、ElkAPI APIドキュメントを参照してください。
ElkAPIサポート推奨モデル：GPTシリーズ：
  • gpt-5.5 / gpt-5.5-pro - GPT-5シリーズモデル
  • gpt-5.4 / gpt-5.4-mini - GPT-5.4シリーズモデル
  • gpt-5.4-mini - 高速で経済的なバージョン
  • gpt-5.4 / gpt-5.4-mini - GPT-5.4シリーズ
Claudeシリーズ：
  • claude-sonnet-4-6 - Claude Sonnet 4.6
  • claude-sonnet-4-6 - Claude Opus 4.7
Geminiシリーズ：
  • gemini-3.1-flash-lite-preview - Google Gemini 3.1 Flash Lite
複数のモデルを同時に有効化し、アプリケーションで柔軟に切り替えて使用できます。
完了後、すぐに使用できます。ステップ3にジャンプしてください。

​
方法2：カスタムモデルプロバイダーの追加

モデルプロバイダーページで：
  1. カスタムモデルセクションまでスクロール
  2. + モデルを追加ボタンをクリック
カスタムモデルセクション

​
2.2 ElkAPIプロバイダーの設定

設定ダイアログで、以下の情報を入力：
フィールド値
モデル名称ElkAPIまたはカスタム名
モデルタイプLLM（大規模言語モデル）を選択
API KeyElkAPIのAPIキー（sk-xxxxxxxxxxxx）
API endpoint URLhttps://api.elkapi.com/v1
Endpointモデル名具体的なモデル名を入力（例：gpt-5.5、gpt-5.4-mini、claude-sonnet-4-6など）
プロバイダー追加ダイアログ
重要：
  • Base URLには/v1サフィックスを含める必要があります：https://api.elkapi.com/v1
  • API KeyはElkAPIコンソールから取得したsk-で始まるキーである必要があります
  • APIキーに十分な残高があることを確認してください

​
2.3 さらにモデルを追加（オプション）

さらにモデルを追加する場合は、上記の手順を繰り返します：
  1. カスタムモデルセクションで、+ モデルを追加ボタンを再度クリック
  2. 別のモデルの設定情報を入力
  3. 保存をクリック
追加推奨モデル：

​
GPT-4/5シリーズ

モデルIDモデル名コンテキスト長使用例
gpt-5.5GPT-5128,000複雑なタスク、長文処理
gpt-5.5GPT-5.5128,000高品質な対話、コード生成
gpt-5.4-miniGPT-5.4 Mini128,000高速応答、コスト効率

​
Claudeシリーズ

モデルIDモデル名コンテキスト長使用例
claude-sonnet-4-6Claude Sonnet 4.6200,000複雑な推論、コード分析
claude-sonnet-4-6Claude Opus 4.7200,000高速応答、簡単なタスク

​
Geminiシリーズ

モデルIDモデル名コンテキスト長使用例
gemini-3.1-flash-lite-previewGemini 3.1 Flash Lite32,000マルチモーダル、リアルタイムアプリ
パフォーマンス推奨：
  • 💰 コスト効率： gpt-5.4-mini、claude-sonnet-4-6
  • 🚀 高性能： gpt-5.5、gpt-5.5-pro、claude-sonnet-4-6
  • ⚡ 高速応答： gemini-3.1-flash-lite-preview、gpt-5.4-mini

​
ステップ3：アプリケーションでElkAPIモデルを使用

​
3.1 新しいアプリケーションの作成

  1. Difyホームページに戻る
  2. アプリを作成ボタンをクリック
  3. アプリケーションタイプを選択：
    • チャットボット - 会話型アプリケーション
    • テキストジェネレーター - テキスト生成アプリケーション
    • エージェント - インテリジェントエージェント
    • ワークフロー - 複雑なワークフローアプリケーション

​
3.2 ElkAPIモデルの選択

アプリケーションオーケストレーションページで：
  1. モデル設定エリアを見つける
  2. モデルを選択ドロップダウンをクリック
  3. ElkAPIプロバイダーを選択
  4. 設定したモデルを選択（例：gpt-5.5）

​
3.3 モデルパラメーターの設定

必要に応じてモデルパラメーターを調整：
パラメーター説明推奨値
Temperature出力のランダム性を制御0.7（創造的）/ 0.3（正確）
Max Tokens最大出力長2000-4000
Top Pニュークリアスサンプリングパラメーター0.9
Presence Penalty繰り返しを減らす0.0-0.5
Frequency Penalty頻出語を減らす0.0-0.5

​
ステップ4：アプリケーションの構築とテスト

​
4.1 プロンプトの追加

アプリケーションオーケストレーションページで：
  1. システムプロンプトエリアにプロンプトを記述
  2. 変数を使用してアプリを動的にする：
    • {{variable_name}} - ユーザー入力変数
    • {{context}} - ナレッジベースコンテキスト
プロンプト例： 
あなたはプロフェッショナルなカスタマーサービスアシスタントで、製品に関する質問に答えることが得意です。

製品情報：{{product_info}}

ユーザーの質問に基づいて、正確で親しみやすい回答を提供してください。不明な場合は、正直にユーザーに伝えてください。

ユーザーの質問：{{user_question}}

​
4.2 ナレッジベースの追加（オプション）

RAG（検索拡張生成）機能が必要な場合：
  1. 左メニューでナレッジベースをクリック
  2. 新しいナレッジベースを作成してドキュメントをアップロード
  3. アプリケーションオーケストレーションページでナレッジベースをリンク
  4. 検索パラメーターを設定

​
4.3 アプリケーションのテスト

  1. 右側のプレビューパネルにテスト質問を入力
  2. AI応答の効果を確認
  3. 必要に応じてプロンプトとパラメーターを調整
  4. 満足するまでテストを繰り返す

​
4.4 アプリケーションの公開

テスト後：
  1. 右上の公開ボタンをクリック
  2. 公開方法を選択：
    • API呼び出し - APIによる統合
    • ウェブサイトに埋め込み - 埋め込みコードを生成
    • 公開リンク - 共有リンクを生成

​
ステップ5：監視と最適化

​
5.1 アプリケーションログの表示

アプリケーション詳細ページで：
  1. ログタブをクリック
  2. すべての会話記録を表示
  3. ユーザーの質問とAI応答を分析
  4. 改善の機会を発見

​
5.2 API使用状況の監視

ElkAPIコンソールにログインして表示：
  • 📊 API呼び出し統計 - 総呼び出し数、成功率
  • 💰 コスト詳細 - 日次/月次コスト
  • 📈 使用傾向 - 使用量の変化傾向
  • 🔍 リクエストログ - 詳細なリクエスト記録

​
5.3 アプリケーションパフォーマンスの最適化

監視データに基づいて最適化：
  1. モデル選択の調整
    • 簡単なタスクにはgpt-5.4-miniを使用してコストを削減
    • 複雑なタスクにはgpt-5.5またはclaude-sonnet-4-6を使用して品質を向上
  2. プロンプトの最適化
    • プロンプトをより明確で具体的にする
    • 例を追加して効果を向上
    • 思考の連鎖を使用して推論能力を向上
  3. キャッシュの設定
    • 類似の質問に対してキャッシュを有効化
    • API呼び出しコストを削減

​
よくある質問

​
Q1: ElkAPIサービスに接続できない？

解決策：
  1. Base URLの確認：
    • https://api.elkapi.com/v1（/v1を含む）であることを確認
    • 追加のパスを追加したり、/v1を省略したりしない
  2. API Keyの検証：
  3. ネットワーク接続の確認：
    • サーバーがhttps://api.elkapi.comにアクセスできることを確認
    • 自己ホスト版では、サーバーのネットワーク接続を確認

​
Q2: モデルの応答が遅い？

解決策：
  1. より高速なモデルへの切り替え：
    • gpt-5.5の代わりにgpt-5.4-miniを使用
    • より高速な応答のためにgemini-3.1-flash-lite-previewを使用
  2. プロンプト長の最適化：
    • 不要なコンテキストを削減
    • プロンプトの説明を簡略化
  3. ナレッジベース検索の調整：
    • 検索ドキュメント数を削減
    • 類似度閾値を上げる

​
Q3: API呼び出しが失敗またはエラーを返す？

一般的なエラーと解決策：
エラーメッセージ原因解決方法
401 Unauthorized無効または期限切れのAPI KeyAPI Keyを再取得して設定を更新
429 Too Many Requestsリクエスト頻度制限超過アプリの同時実行設定を調整するか、待機して再試行
500 Internal Server Error一時的なサーバー障害数分待って再試行
insufficient_quotaアカウント残高不足コンソールでチャージ
context_length_exceeded入力がコンテキスト長を超過入力長を減らすか、より大きなコンテキストのモデルを使用

​
サポート＆ヘルプ

問題が発生した場合：

ElkAPIを始める

今すぐElkAPIに登録して、APIキーを取得し、Difyで強力なAIアプリケーションを構築しましょう！