カスタムAPIエンドポイントとは?OpenAI互換APIの接続方法
カスタムAPIエンドポイントとBase URLとは何か、OpenAI互換API・中継サービス・プロキシ・ゲートウェイをアドレスとキーだけで接続する方法を解説します。
- カスタムAPIエンドポイントとは、アプリに組み込まれていないAIサービスのWebアドレス(Base URL)のことで、OpenAI互換API、中継サービス(リレー)、プロキシ、ゲートウェイなどがあります。Oriveoで接続するのに必要なのは、たいていそのアドレスとAPIキーの2つです。
- Oriveoはプロトコル(OpenAI Chat Completions、OpenAI Responses、Anthropic Messages、Gemini)を自動で判別し、ルートのアドレスだけを入力した場合は/v1などのバージョンのパスを補います。
- 公開アドレスはHTTPSでなければなりません。第三者のサービスは、そこを通る内容をすべて見ることができるので、支出上限を設定した専用のキーを使い、公式プロバイダーのキーは絶対に渡さないでください。

Base URL・APIエンドポイントとは?
AIサービスには、アプリがリクエストを送る先のWebアドレスがあります。開発者はこれをBase URL(ベースURL)、APIエンドポイント、リクエストURLなどと呼びますが、ここではどれも同じ意味です。見た目は普通のWebアドレスで、たとえばOpenAIのものはhttps://api.openai.com/v1です。
Oriveoでは、15社の組み込みプロバイダーのアドレスはあらかじめ入っているので、キーを貼り付けるだけで使えます。カスタムエンドポイントは、それ以外のすべてのためのものです。OpenAI互換APIを提供しているサービス、企業が運営する中継サービスやゲートウェイ、自分のサーバーで動かしているゲートウェイなどが当てはまります。
「OpenAI互換」とは、OpenAIのAPIと同じ形式のリクエストを受け付けるという意味で、OpenAI向けに作られたアプリがそのままやり取りできます。この形式に対応しているプロバイダーやゲートウェイはたくさんあります。
中継サービス・プロキシ・ゲートウェイの違い
これらの言葉はかなり曖昧に使われていますが、アプリから接続するという点では同じように働きます。アプリとモデルのプロバイダーのあいだにサービスが入り、リクエストを受け取って先へ渡す仕組みです。複数のプロバイダーを1つのキーと1つの請求にまとめるもの、チーム向けに利用管理の機能を加えるもの、自分のサーバーで動かすソフトウェアなどがあります。
Oriveoは、特定のサービスを推薦したり、順位を付けたりしません。どれを使う場合でも、下の手順は同じです。
カスタムエンドポイントの接続に必要なもの
たいていは次の2つで、どちらもサービスの管理画面かドキュメントに載っています。
- リクエストURL(Base URL)。例:https://api.example.com/v1。公開されたインターネット上のサービスなら、https://で始まっている必要があります。
- サービスから発行されたAPIキー。「キーをもう 1 つ追加」で、複数のキーを登録することもできます。
- 任意で、接続の名前。ほかの接続と見分けやすくなります。
Oriveoでカスタムエンドポイントを追加する方法
手順はiPhone・Android・Webで同じです。
- 「プロバイダー」を開き、「+」ボタン(iPhone・Androidでは「プロバイダーの追加」、Webでは「プロバイダーを追加」)をタップします。
- 「カスタム」のチップを選び、「カスタムリレー」(「自分のモデルサービスに接続」)を選びます。
- 「カスタムリレーに接続」の画面で、リクエストURLとAPIキーを貼り付けます。「リクエスト先: …」の行に、Oriveoが実際に使う完全なアドレスが表示されます。「次へ」をタップします。
- Oriveoが接続を確認し、モデル一覧を読み込んで、モデルごとにプロトコルを判別します。この段階では一覧を読むだけで、チャットのメッセージは送りません。
- 使いたいモデルにチェックを入れ、「保存(N 個選択中)」をタップします。サービスがモデル一覧を出していない場合は、「モデル ID を手動で追加」を使います。
- 保存する前に、Oriveoは選んだ最初のモデルにごく小さなリクエストを1回送ります。このテストに通れば接続が保存され、失敗した場合は同じ画面に残るので、その場で直せます。

すべて自分で設定したいなら「手動設定」
「手動設定」では、アドレス、キー、モデルID、任意の接続名、デフォルトのプロトコル(最初は自動)を1ページで入力し、「検証して保存」をタップします。確認に失敗した場合はまだ何も保存されていません。失敗を知らせるカードの「未検証のまま保存」を選べば、接続を残しておいて、あとでテストできます。
プロトコルは自動で判別される?
ほとんどの場合は自動です。AIサービスは、プロトコルと呼ばれるいくつかのリクエスト形式のどれかを使います。Oriveoが対応しているのは、OpenAI Chat Completions、OpenAI Responses、Anthropic Messages、Gemini generateContentの4つです。
判別はモデルごとに行います。サービスが各モデルについて情報を出していればそれを使い、なければモデルの系統から可能性の高い候補を選びます。保存するときは最初に選んだモデルを実際のリクエストでテストし、ほかのモデルは使い始めたときに確認します。
そのため、たいていはアドレスとキーだけで足ります。サービスのドキュメントが特定のプロトコルを指定している場合や、モデルの確認に失敗した場合は、「手動設定」でプロトコルを自分で選んでください。
アドレスに/v1を付ける必要はある?
たいていは不要です。https://api.example.comのようにルートのアドレスだけを入力すると、Oriveoがプロトコルに合った標準のバージョンのパスを付け足します。OpenAI形式とAnthropic形式なら/v1、Gemini形式なら/v1betaです。
/api/paas/v4のように、アドレスにすでにバージョンが含まれている場合は、そのまま使います。/chat/completions、/responses、/messages、:generateContentで終わる完全なエンドポイントを貼り付けた場合は、その末尾を取り除き、サービスがどのプロトコルを使うかの判断材料にします。
「次へ」をタップする前に、「リクエスト先: …」の行を確認してください。確認の結果「アドレスがウェブページを指している可能性があります。/v1 が抜けていないか確認してください。」と表示された場合は、入力したアドレスをサービスのドキュメントと見比べてください。
| 入力したアドレス | Oriveoのリクエスト先(OpenAI形式) |
|---|---|
| https://api.example.com | https://api.example.com/v1 |
| https://api.example.com/v1 | https://api.example.com/v1 |
| https://api.example.com/v1/chat/completions | https://api.example.com/v1(Chat Completionsを使用) |
| https://api.example.com/api/paas/v4 | https://api.example.com/api/paas/v4 |
使えるアドレスは?
キーを守るため、Oriveoはいくつかのルールに従っています。
- 公開アドレスはhttps://で始まる必要があります。公開インターネット上のhttp://のアドレスは、テストも保存もできません。
- ユーザー名やパスワードを含むアドレスや、クエリパラメータ(「?」以降の部分)を含むアドレスは受け付けません。Oriveoがクエリパラメータに入ったAPIキーを試すこともありません。
- 自宅のネットワークやプライベートVPN上のhttp://のアドレス(自分のパソコンで動かしているモデルサーバーなど)は、「カスタムリレー」ではなく、別にあるローカル接続の入口(Androidは「ローカル計算」、iPhoneは「ローカル・LAN コンピューティング」、Webは「ローカル計算環境」)から追加します。
- iPhoneとAndroidでは、アプリがそのアドレスに直接接続します。
- Web版では、ブラウザーのCORS制限(多くの直接リクエストをブロックする、ブラウザーのセキュリティ上のルール)を回避するため、公開リクエストURLはOriveoのサーバー経由で転送されます。APIキーはそのリクエスト中だけメモリ上で使用され、保存もログ記録もされません。ローカルネットワーク上のアドレスには端末から直接接続しますが、いずれの場合もHTTPSが必要です。自宅のネットワーク上のhttp://のアドレスを使うには、iPhoneまたはAndroidのアプリと、そのローカル接続の入口が必要です。
- キーはこの端末にのみ保存され、クラウド同期ではアップロードされません。
組み込みプロバイダーのBase URL一覧
Oriveoではこれらを入力する必要はなく、プロバイダー名を選ぶだけです。ほかのツールのために調べる人が多いので載せています。いずれも2026年11月18日時点で、各プロバイダーのドキュメントに記載されている公式のOpenAI互換アドレスです。
- AnthropicはOpenAI互換のレイヤーをテストや比較のためのものと位置づけていて、Mistralのクイックスタートは自社のAPIをOpenAI互換とは説明していません。この2社は、組み込みプロバイダーとして追加してください。
| プロバイダー | OpenAI互換のBase URL |
|---|---|
| OpenAI | https://api.openai.com/v1 |
| Google Gemini | https://generativelanguage.googleapis.com/v1beta/openai/ |
| OpenRouter | https://openrouter.ai/api/v1 |
| DeepSeek | https://api.deepseek.com |
| xAI(Grok) | https://api.x.ai/v1 |
| Groq | https://api.groq.com/openai/v1 |
| Together AI | https://api.together.ai/v1 |
| Fireworks AI | https://api.fireworks.ai/inference/v1 |
| MiniMax(国際版) | https://api.minimax.io/v1 |
| Z.ai(国際版) | https://api.z.ai/api/paas/v4/ |
| Qwen(シンガポールリージョン) | https://dashscope-intl.aliyuncs.com/compatible-mode/v1 |
| Kimi(国際版) | https://api.moonshot.ai/v1 |
| SiliconFlow(国際版) | https://api.siliconflow.com/v1 |
中継サービスや第三者のAPIは安全?
注意が必要です。あなたとモデルのあいだに入るサービスは、プロンプト、添付したファイル、回答をすべて読むことができ、料金も独自に決めています。Oriveoは、その内部を確認することも、安全を保証することもできません。
- 公式プロバイダーのアカウントで作ったAPIキーを、第三者のサービスには絶対に渡さないでください。そのサービスが発行したキーを使います。
- Oriveo専用のキーを作り、サービスが対応していれば支出上限を設定するか、残高を少なめにしておきます。
- パスワード、身分証の番号、仕事の機密情報を、信頼できないサービス経由で送らないでください。
- 利用状況は、サービス自身の管理画面で確認します。Oriveoのコスト表示は概算で、最終的な基準はサービス側の記録です。
- キーが漏れたら、サービスの管理画面で削除して新しいキーを作ります。
カスタムエンドポイントにつながらないときは
何がうまくいかなかったのかを、Oriveoが1行で知らせます。主なメッセージは次のとおりです。
- 401、402、429などのコードの意味は、APIキーのエラーガイドで説明しています。
| Oriveoのメッセージ | 確認すること |
|---|---|
| アドレスがウェブページを指している可能性があります。/v1 が抜けていないか確認してください。 | アドレスをサービスのドキュメントと見比べ、バージョンのパスを足すか削る |
| キーが無効です。 | サービスの管理画面からキーをコピーし直す |
| このキーにはモデル一覧を取得する権限がありません。モデルは手動で追加できます。 | 次の画面で、モデルIDを自分で追加する |
| 接続できません。ネットワークまたはプロキシを確認してください。 | インターネット接続と、そのアドレスにアクセスできるかを確認する |
| このアドレスのサービスはレート制限中です。 | 少し待ってから再試行する |
| この接続から上流のプロバイダーにつながりませんでした。 | その先にあるサービス自身のアカウントが無効、クレジット不足、またはレート制限中の可能性がある。運営者に問い合わせる |