自社プロダクトに AI エージェントを組み込みたいが、一から作りたくはない。ホワイトラベルのエージェントは、当社ではなくあなたのブランディングをまとったクラウドエージェント、つまり自社ブランドの AI エージェントです。エージェントのページ、その周辺のページ、エージェント自身の名乗りに、あなたのエージェント名、ロゴ、配色、フォント、ウェルカムメッセージが使われます。独自ドメインを接続すれば、ユーザーの目に触れるものに Lovely Router の名前は一切出ません。自社のユーザー 1 人につき 1 つのエージェントを作成し、リンクを渡すか API でエージェントを呼び出して、費用は 1 つのプリペイド残高から支払います。
AI エージェントに任せる
このプロンプトを Claude Code、Cursor、Codex などのコーディングエージェントに貼り付けてください。ドキュメントの場所と API キーの使い方をエージェントに伝えます。
Give my own users Lovely Router cloud agents under my brand (white-label): my name, logo and domain, my users never see Lovely Router. - Docs (read first): https://lovelyrouter.com/docs/agents/white-label.md and https://lovelyrouter.com/docs/api/agents.md - Agents: POST https://lovelyrouter.com/v1/agents; create a branding: POST https://lovelyrouter.com/v1/agents/brandings; a token per end user: POST https://lovelyrouter.com/v1/agents/<id>/tokens. Keep my API key on my server and hand users only those tokens. - Auth: read my API key from the LOVELY_API_KEY environment variable and send it as `Authorization: Bearer $LOVELY_API_KEY`. Never print or commit the key. If it is not set, ask me to create one at https://lovelyrouter.com/app/keys. - Billing is prepaid: every call is charged to my balance, so test with a small request before running anything large. - Every docs page is plain Markdown; the full index is https://lovelyrouter.com/llms.txt. My task: <describe what you want to build or get>
仕組み
ブランディングをデザインする
コンソールの「クラウドエージェント → ブランディング」で、名前、ロゴ、テーマ、配色、フォント、ウェルカムメッセージを設定します。設定中はエージェントのページがプレビューにその場で表示されます。API で作成することもできます。
cURLcurl https://lovelyrouter.com/v1/agents/brandings \ -H "Authorization: Bearer $LOVELY_API_KEY" \ -H "content-type: application/json" \ -d '{"agent_name": "Nova Assistant", "scheme": "light", "colors": {"accent": "#0d9488"}, "font": "Inter", "welcome": "How can Nova help today?"}'ブランディングを適用したエージェントを作成する
エージェントの作成時または更新時に、ブランディングの ID を送ります。エージェントの次回の起動から適用されます。
cURLcurl https://lovelyrouter.com/v1/agents \ -H "Authorization: Bearer $LOVELY_API_KEY" \ -H "content-type: application/json" \ -d '{"name": "Nova for cust-42", "user": "cust-42", "branding": "brd_6c1f0a9e3b7d2c4e8f5a1b0d"}'ユーザーにページを渡す
uiスコープのエージェントトークンには、あなたのブランディングでエージェントのページをサインイン済みで開くリンクが付きます。ページはユーザーに見せず、API で実行を送るだけにすることもできます。cURLcurl https://lovelyrouter.com/v1/agents/agt_3f9a1c7e0b2d4e6f8a9b0c1d/tokens \ -H "Authorization: Bearer $LOVELY_API_KEY" \ -H "content-type: application/json" \ -d '{"scopes": ["ui"], "expires_in": 86400}'
ユーザーに見えるもの
ページタイトル、サイドバー、ブラウザのタブにあなたのエージェント名が表示されます。サイドバーのマーク、メッセージ入力欄の上のマーク、ファビコンにはあなたのロゴが使われ、ダークまたはライトのテーマで、あなたのウェルカムメッセージ、配色、フォントが表示されます。
エージェントのアドレスに表示される起動中…、サインイン、停止中などのお知らせもあなたのブランディングで表示され、Lovely Router へのリンクは一切ありません。残高や予算の都合でエージェントを起動できない場合も、ユーザーには「現在利用できません」とだけ伝えます。
エージェントはあなたのエージェント名で名乗り、提供するモデルもその名前の下に並びます。組み込みツールも Lovely Router に触れません。
ブランディングの下にあるのは、ほかのすべてのクラウドエージェントと同じエージェントです。専用のサンドボックスとワークスペースを持ち、データツールとブラウザエージェントを使えます。
ブランディングに含まれるもの
：ユーザーに表示され、エージェントが名乗る名前です。英字、数字、スペース、. _ - で 1〜40 文字。
：自分用のラベルで、ユーザーには表示されません。
：64 KB までの PNG、JPEG、WebP、SVG。設定しない場合は、アクセントカラーの上にエージェント名の頭文字が表示されます。
：ダークまたはライトで、アクセントカラーと背景色を指定します。ほかの色はこの 2 色から自動で導き出され、1 色ずつ微調整もできます。
：本文用フォントとコード用フォントを Google Fonts の一覧から選ぶか、ページ既定のフォントを使います。
：最初のメッセージ入力欄の上に表示される見出しで、最大 80 文字です。
ブランディングは最大 50 個まで保存でき、それぞれの下にいくつでもエージェントを作成できます。ブランディングの変更は、それを使うすべてのエージェントに次回の起動時に反映されます。ブランディングの保存は無料です。
独自ドメイン
agents.yourcompany.com のような自社のドメインで、ブランディングのエージェントを提供できます。エージェントのリンク、サインイン、ページ、共有リンクはすべてそのドメインを使うようになります。
- ドメインを接続する。 コンソールでブランディングにドメインを入力するか、
PUT /v1/agents/brandings/{id}/domainを呼び出します。 - DNS レコードを 1 つ追加する。 DNS プロバイダーで、表示された
CNAMEを追加します。ルートドメインを使う場合は、ルートに CNAME レコードを置ける DNS プロバイダー（CNAME フラットニングまたは ALIAS）が必要です。 - 証明書の発行を待つ。 レコードが反映されると証明書が自動で発行され（通常は数分以内）、ステータスが有効になります。オプションの TXT レコードを使えば、ドメインを当社に向ける前に証明書を準備しておけます。
あなたのドメインで応答するのは、そのブランディングのエージェントだけです。当社のほかのサービスが応答することはありません。ドメインはブランディング 1 つにつき 1 つです。
ユーザーごとのエージェント
各エージェントは、ユーザーの自社 ID を付けて {"user": "cust-42"} で作成します。ユーザーにはキーの代わりにエージェントトークンを渡してください。トークンは 1 つのエージェントにしかアクセスできず、1 分〜30 日の期限が来ると自動で失効し、いつでも取り消せます。ui スコープではブランディングされたページが開き、api スコープではページなしで実行の送信とファイルの読み取りができます。エージェントごとの予算に達するとそのエージェントは停止し、作成したファイルは共有リンクでサインインなしに開けます。
活用例
顧客アカウントごとにブランディングしたエージェントを 1 つ用意し、アプリから ui トークンで開き、予算で上限を設けます。
クライアントごとに 1 つのブランディングを用意し、それぞれをクライアント自身のドメインで提供して、請求はすべて自分のアカウントにまとめます。
バックエンドから api トークンと実行を使います。ユーザーが目にするファイルや共有リンクには、引き続きあなたのドメインが使われます。
支払う料金
ホワイトラベルのエージェントは、サンドボックスの料金（計算とストレージ）が標準料金の 1.5× です。エージェントが使うモデル、データツール、ブラウザエージェントは通常料金のままです。
| サイズ | 標準 | ホワイトラベル |
|---|---|---|
| 小（共有 vCPU 2 個、2 GiB） | 1 時間あたり $0.05 | 1 時間あたり $0.075 |
| 中（共有 vCPU 4 個、4 GiB） | 1 時間あたり $0.10 | 1 時間あたり $0.15 |
| 大（共有 vCPU 8 個、8 GiB） | 1 時間あたり $0.20 | 1 時間あたり $0.30 |
支払うのはエージェントの実行中の料金と、ワークスペースのストレージ料金だけです。接続したドメインは 1 日あたり $0.50 です。エージェントのブランディングをオンまたはオフにすると、次回の起動から料金が変わります。サブスクリプションはなく、すべてプリペイド残高から支払われます。料金とクラウドエージェントの料金を参照してください。
よくある質問
ホワイトラベルの AI エージェントとは何ですか？+
当社ではなく、あなたのプロダクトの名前、ロゴ、配色、ウェルカムメッセージをユーザーに表示するホスト型 AI エージェントです。専用のワークスペースを持つ専用のクラウドサンドボックスで動作し、リンクでユーザーに渡すことも、API で呼び出すこともできます。
独自ドメインを使えますか？+
はい。ブランディング 1 つにつき 1 つのドメインを接続し、表示された CNAME レコードを追加してください。証明書は自動で発行され、通常は数分以内に完了します。以降、リンク、サインイン、ページ、共有リンクはあなたのドメインを使います。
ホワイトラベルのエージェントはどれくらい割高ですか？+
サンドボックスの料金が、計算とストレージのいずれも標準料金の 1.5× になります。モデルのトークン、データツール、ブラウザエージェントは通常料金のままで、独自ドメインは接続している間、1 日単位で課金されます。
AI エージェントを再販できますか？+
はい。代理店や再販事業者なら、クライアントごとに 1 つのブランディングを用意し、それぞれをクライアント自身のドメインで提供できます。請求はすべてあなたのアカウントにまとまります。
ユーザーは当社のアカウントを作る必要がありますか？+
いいえ。エージェントはあなたが作成し、各ユーザーにエージェントトークンを渡します。ui トークンには、そのユーザーのエージェントのページをサインイン済みで開くリンクが付きます。
残高がなくなるとユーザーには何が表示されますか？+
エージェントのページには、あなたのブランディングで「現在利用できません」とだけ表示され、当社へのリンクはありません。残高がゼロを下回るとエージェントは停止します。ワークスペースを残すには、24 時間以内にチャージしてください。
まずはクラウドエージェントの概要とホワイトラベルのドキュメントを、すべてのフィールドについてはブランディング API リファレンスを参照してください。