Dify で BeatAPI を使う

Dify はチャットアプリ、エージェント、ワークフローを構築する LLMOps プラットフォームです。BeatAPI をモデル接続先として一度登録すると、ワークスペースの各アプリで選択できます。

以下のモデル設定は、Dify Marketplace の BeatAPI ツールプラグインとは別です。Marketplace には現在、ミュージックビデオ用ツール 2 つを含む v0.1.0 が掲載されています。拡張版の v0.2.1 はMarketplace の審査に提出済みですが、提出しただけでは Marketplace が更新されたことや、すべての新しいツールが Dify ワークスペースで実行を完了したことを意味しません。

前提条件

1. Dify ワークスペース。 クラウド版またはセルフホスト版を使います。
2. BeatAPI API キー。 ダッシュボード → API キーで作成します。

ステップ 1：モデル設定を開く

右上のアバターから Settings を開き、左メニューの Model Provider を選択します。

ステップ 2：BeatAPI を追加する

2 つの設定方法で同じ結果を得られます。方法 A は手早く、方法 B はほかの接続先と分けて管理できます。

方法 A：OpenAI 接続を利用する

1. OpenAI の Configure を押します。
2. 次を入力します。

3. 保存し、モデル一覧で利用するモデルを有効にします。

方法 B：カスタムモデルを追加する

1. Custom Model まで移動し + Add Model を押します。
2. 次を入力します。

モデルごとに追加します。入力は増えますが、実際に動くモデルだけを一覧に置けます。

ステップ 3：モデルを選ぶ

詳細は Text API、料金は料金ページを参照してください。

ステップ 4：構築して公開する

1. Chatbot、Text Generator、Agent、Workflow のいずれかのアプリを作成します。
2. Model Settings で BeatAPI のモデルを選びます。
3. ユーザー入力に {{variable}}、ナレッジベースの内容に {{context}} を使ってシステムプロンプトを記述します。
4. プレビューパネルでテストし、Publish から API、埋め込み、共有リンクとして公開します。

設定を推奨するパラメーター

よくある質問

Dify が接続できません

1. Base URL は /v1 を含み、末尾スラッシュのない https://api.beatapi.io/v1 を指定します。
2. ダッシュボード → API キーでキーが有効か確認します。
3. セルフホストでは、ブラウザーだけでなく Dify のサーバーが api.beatapi.io に到達できるか確認します。

実行時にだけモデルが失敗します

Dify の一覧で有効になっていても、アカウントでは提供していない可能性があります。料金ページと ID を照合してください。

402 insufficient_credits

残高が 0、またはリクエストの料金に不足しています。ダッシュボードからチャージしてください。残高が空の間は公開アプリの利用者にも影響するため、監視を推奨します。

429 rate_limit_exceeded

キーのリクエスト数が上限を超えています。ワークフローの並列呼び出しが原因になりがちです。同時実行数を減らすか、上限を増やしてください。毎分の上限はチャージ累計額に応じて増え、ダッシュボードに表示されます。

コストを管理するには

• アプリごとに BeatAPI キーを分け、GET /v1/usage の by_api_key でアプリ別の料金を確認します。
• 分類、ルーティング、抽出などは安いモデルに振り分け、最終回答に高性能モデルを使います。
• 各ノードの Max Tokens に上限を設けます。ワークフローノードの初期値は大きめです。

サポート

ダッシュボードからチケットを作成し、失敗したレスポンスの request_id を添えてください。