Base URL の設定方法
Base URL を正しく設定することは、MoleAPI 接続を成功させるための最初のステップです
Base URL は、クライアントまたは SDK が API をリクエストする際に使用するベースとなるアドレスです。
これは「リクエストをどこに送るか」を示すものと考えるとわかりやすいです。
このアドレスを誤って設定すると、API Key が正しくてもリクエストは失敗します。
MoleAPI で最も一般的な設定方法
OpenAI 互換インターフェースに対応したほとんどのツールや SDK では、以下を直接設定することを推奨します。
https://api.moleapi.com/v1これは、特に初心者が最初に覚えておくべき設定です。
多くのケースで /v1 が必要な理由
多くの SDK やクライアントでは、入力した Base URL の末尾に、さらに次のようなパスを自動で連結します。
/chat/completions/responses/embeddings/images/generations
そのため、以下のように設定した場合：
https://api.moleapi.com/v1最終的に組み立てられる完全な URL は次のようになります。
https://api.moleapi.com/v1/chat/completions通常、これが正しい形式です。
/v1 を省略できるのはどんなときか
一部のツールでは、「サイトのルート URL」を入力するよう求められ、内部で /v1 が自動的に補完されることがあります。
その場合は、次を試してください。
https://api.moleapi.comただし、よくわからない場合は、まず https://api.moleapi.com/v1 を試すことを優先してください。
初心者向けのシンプルな結論
設定方法に迷ったら、まずは https://api.moleapi.com/v1 を使用してください
よくある誤った設定
誤り 1：OpenAI 公式の URL を設定してしまう
例：
https://api.openai.com/v1この場合、リクエストは MoleAPI を経由せず、直接 OpenAI 公式に送信されます。
誤り 2：/v1 を付け忘れる
一部のアプリケーションでは /v1 まで含めて設定する必要があります。
もし次のように設定すると：
https://api.moleapi.com以下のような問題が発生する可能性があります。
- 404
- Invalid URL
- インターフェースが存在しない
- リクエストパスの連結エラー
誤り 3：完全なエンドポイントパスを Base URL として設定してしまう
たとえば、次のように設定した場合です。
https://api.moleapi.com/v1/chat/completions通常、これは正しくありません。多くの SDK はその後ろにさらにパスを連結するため、最終的な URL が不正になります。
特定のツールで完全なエンドポイント URL の入力が明示的に求められていない限り、Base URL は通常、以下までにしてください。
https://api.moleapi.com/v1誤り 4：コピー時に空白、全角記号、または誤ったプロトコルが混入する
例：
https//api.moleapi.com/v1http://api.moleapi.com/v1- URL の前後に余分な空白がある
- 全角文字が混入している
この種の問題は非常によくあり、見た目だけではすぐに気づけないこともあります。
正しく設定できているかを素早く確認する方法
次の順番で確認してください。
- Base URL が
https://api.moleapi.com/v1になっているか - API Key が MoleAPI コンソールで作成した
sk-...であるか - モデル名が現在の Group で利用可能なモデルであるか
- クライアントが OpenAI 互換インターフェースに対応しているか
これらに問題がないことを確認してもなお失敗する場合は、より詳細なログやエラーコードを確認してください。
よくある利用シーンごとの推奨設定
シーン 1：サードパーティ製クライアントとの接続
Chatbox、NextChat、Immersive Translate、Cherry Studio などのツールの場合：
- まず
https://api.moleapi.com/v1を設定 - API Key にはあなたの
sk-...を設定
シーン 2：OpenAI SDK での接続
Node.js、Python、その他の OpenAI 互換 SDK でも、通常は次を優先して設定します。
https://api.moleapi.com/v1シーン 3：エラーメッセージに api.openai.com が表示される
通常、これはリクエストが MoleAPI に到達しておらず、引き続き OpenAI 公式 URL に送られていることを示します。まず Base URL が正しく変更されているかを確認してください。
次に確認する項目
このガイドはいかがですか？
最終更新日