申請手順
LobeChat で Ace Data Cloud に接続するには、まず Ace Data Cloud コンソール にアクセスし、API Token を取得して控えておきます。
まだログインまたは登録していない場合は、自動的にログインページへ移動して登録とログインを案内します。ログイン・登録後は自動的に現在のページへ戻ります。
初回申請時には無料クレジットが付与され、Ace Data Cloud のモデルサービスを無料で試用できます。
Ace Data Cloud を設定する
LobeChat の アプリ設定 → 言語モデル に入り、OpenAI カードを見つけて有効にし、以下を入力します:
Chat Completions インターフェースを使用する場合は、Responses API Specification を無効のままにしてください。LobeChat は Base URL に
/v1 を自動的に追加しません。リクエストパスは直接 {API プロキシアドレス}/chat/completions になります:
LobeChat はデフォルトで
/v1/models を呼び出してモデルを自動取得します。Ace Data Cloud から返されるモデル数が多い場合、画面の一覧が非常に長くなるため、「モデルリスト → カスタムモデル名」で allow list を手動入力することを推奨します。英語のカンマで区切ってください。表示名をカスタマイズする必要がある場合は、= を使用できます。形式は MODEL_ID=表示名 です。
モデルを選択する
モデルカタログは継続的に更新されます。クライアントが自動読み込みしたモデルリストを優先して使用してください。手動で入力する必要がある場合は、まずGET https://api.acedata.cloud/v1/models をリクエストして現在のモデル ID を取得し、その後クライアントが対応するコンテキスト、画像、ツール呼び出し機能に応じて選択してください。
接続を検証する
問題が LobeChat にあるのかネットワークにあるのか不明な場合は、まず curl を使用してエンドポイントを直接検証できます({token} をあなたの Token に置き換えてください):
chat.completion オブジェクトが返れば、Token とエンドポイントの両方が準備できていることを示します。HTTP 403 used_up が返る場合は、Token は有効ですが残高が不足していることを示します。コンソールでチャージしてください。
上級編:Docker セルフホスティング
チーム向けにプライベート版をデプロイしたい場合は、Docker の1行コマンドで起動できます({token} をあなたの Token に置き換えてください):
http://あなたのサーバーIP:3210 を開き、ACCESS_CODE を入力すれば使用できます。チームメンバーはそれぞれ Key を入力する必要がありません。上記で使用した OPENAI_API_KEY、OPENAI_PROXY_URL、OPENAI_MODEL_LIST などの環境変数の完全な説明は、LobeChat モデルプロバイダー環境変数ドキュメントを参照してください。nginx のリバースプロキシで HTTPS を追加する場合は、必ず proxy_buffering off; を追加してください。追加しないとストリーミングレスポンスがバッファリングされます。その他のデプロイ形態については、LobeChat セルフホスティング入門および Docker Compose デプロイを参照してください。
よくある質問
404 Not Found と表示される
通常、API プロキシアドレスが.../openai/v1 になっているか、/v1 が抜けています。https://api.acedata.cloud/v1 に変更してください。
モデルリストが空である
「クライアントリクエストモード」スイッチを有効にしてください。または、「カスタムモデル名」にモデル allow list を手動入力してください。401 Unauthorized と表示される
API Key に貼り付けたのが Ace Data Cloud の Token であること(Bearer プレフィックスを含まず、余分な空白がないこと)、および所属するアプリケーションの残高が十分であることを確認してください。

