ブラックフライデーチャージボーナス
対象のチャージごとに無料クレジットが付き、他の特典とも併用できます。
11月30日まで
AIコンパニオンアプリとは、ユーザーが何度も戻ってくるキャラクターのことです。会話を覚えていて、その人自身の声で答え、ときどき写真を送ってくる相手です。必要な部品は3つのAPIで、Lovely Router ではそれらが1つのキーと1つの前払い残高を共有します。チャットはOpenAIまたはAnthropic API経由で、トークンごとにストリーミングし、任意のチャットモデルを使えます。Claude、GPT、Gemini、あるいは拒否せずにキャラクターを保ち続ける無検閲モデルのいずれかです。声はテキスト読み上げから一度だけ設計して保存します。画像は画像生成APIから、キャラクターの参照ポートレートをもとに描くので、毎回同じ人物に見えます。キー、記憶、ユーザーのアカウントはバックエンドが保持し、キー単位の上限がアプリの各部分を予算内に保ちます。
AI エージェントに任せる
このプロンプトを Claude Code、Cursor、Codex などのコーディングエージェントに貼り付けてください。ドキュメントの場所と API キーの使い方をエージェントに伝えます。
Build the backend of an AI companion app with streaming chat, a speech voice and pictures on one Lovely Router key. - Docs (read first): https://lovelyrouter.com/docs/models/hosted.md and https://lovelyrouter.com/docs/api/audio.md and https://lovelyrouter.com/docs/models/images.md - Chat: POST https://lovelyrouter.com/v1/chat/completions with `stream: true` (pick the model from GET https://lovelyrouter.com/v1/models). Voice: POST https://lovelyrouter.com/v1/audio/speech. Pictures: POST https://lovelyrouter.com/v1/images/generations. Keep each end user's quota in this backend. - 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: <the companion's persona, its voice and the app stack>
仕組み
キャラクターを書く
コンパニオンが誰なのかを書いたシステムプロンプトです。名前、性格、話し方、ユーザーについて覚えていること。バックエンドが会話を保持し、直近のやり取りと、古いやり取りの短い要約を毎リクエストに添えて送ります。
返信をストリーミングする
会話を
stream: true付きでPOST /v1/chat/completions(または/v1/messages)に送り、届いた言葉から順に表示します。モデルはリクエストごとに変えられます。雑談には速く安いモデル、長いシーンには強いモデルを。声を与える
コンパニオンの声は
qwen3-ttsで説明文から一度だけ設計し、POST /v1/audio/voicesで保存して、返信はそのidで読み上げます。音声は返信を読み終えた時点でMP3またはOpusとして返ります。写真を送る
キャラクターの参照ポートレートを1枚用意します。物語が写真を求めたら、そのシーンのプロンプトとともに
POST /v1/images/editsに送ると、画像は同じ顔と見た目を保ちます。
返信、その声、そして写真
OpenAI SDKでNode.jsから返信をストリーミングします:
import OpenAI from 'openai';
const client = new OpenAI({ baseURL: 'https://lovelyrouter.com/v1', apiKey: process.env.LOVELY_API_KEY });
const stream = await client.chat.completions.create({
model: 'qwen3.5-9b-defiant-fable',
stream: true,
messages: [
{ role: 'system', content: 'You are Ava, a witty, warm companion. You remember that the user is training for a marathon. Keep replies short and talk like a friend.' },
...history, // the recent turns your backend keeps
{ role: 'user', content: 'Long run today. 28 km. My legs are gone.' },
],
});
let reply = '';
for await (const chunk of stream) {
const text = chunk.choices[0]?.delta?.content ?? '';
reply += text;
sendToClient(text); // forward each piece to the app as it arrives
}次に、それをコンパニオンの保存済みの声で読み上げ、彼女の参照ポートレートから絵を描きます:
import base64
import os
from openai import OpenAI
client = OpenAI(base_url="https://lovelyrouter.com/v1", api_key=os.environ["LOVELY_API_KEY"])
with client.audio.speech.with_streaming_response.create(
model="qwen3-tts",
voice="voice_8f2c4a1e9b7d3f60a5c2e1d4", # Ava's saved voice
input=reply,
instructions="Warm and teasing, a little proud of them",
response_format="opus",
) as audio:
audio.stream_to_file("reply.ogg")
picture = client.images.edit(
model="gpt-image-2",
image=[open("ava-portrait.png", "rb")],
prompt="The woman from the image at a sunny café terrace, raising a coffee cup to the camera, phone selfie",
size="1024x1536",
)
open("ava-cafe.png", "wb").write(base64.b64decode(picture.data[0].b64_json))ストリーミングガイドでは、各APIのストリームがどう見えるか、キャンセルしたストリームにいくらかかるかを説明しています。
モデル
キーで使えるチャットモデルならどれでも、コンパニオンの心として機能します。暗めの、ロマンチックな、あるいは成人向けのシーンでも、途中で降りずに役を保ち続ける必要があるキャラクターには、無検閲モデルが同じエンドポイントにそろっています:
| モデル | 入力 → 出力 | 価格 |
|---|---|---|
| DeepSeek V4.1 Flash Abliterated deepseek-v4.1-flash-abliterated | text+image | 100 万トークンあたり 入力 $0.80 · 出力 $2.00 |
| Qwen3.5 9B Defiant Fable (uncensored) qwen3.5-9b-defiant-fable | text+image | 100 万トークンあたり 入力 $0.90 · 出力 $14.40 |
| Qwen3.8 27B Heretic (uncensored) qwen3.8-27b-heretic | text+image | 100 万トークンあたり 入力 $1.40 · 出力 $21.90 |
| Huihui Qwen3.8 27B (abliterated) huihui-qwen3.8-27b-abliterated | text+image | 100 万トークンあたり 入力 $1.45 · 出力 $20.60 |
米ドルのリアルタイム価格。API の請求額と同じです。
deepseek-v4.1-flash-abliteratedはトークンあたり最安で、長いコンテキストを持ち、ウォームアップもありません。
qwen3.5-9b-defiant-fableは小さく速く、チャットや創作、ロールプレイ向けです。
qwen3.8-27b-hereticと huihui-qwen3.8-27b-abliterated はより強い27Bモデルで、ユーザーが送った画像も読み取ります。
dongfangshuo-27b-v2は中国語のフィクションとロールプレイ向けに調整されています。
27Bと9Bのモデルは自社GPUで動き、2分使われないとスリープします。静かな時間の後の最初のリクエストは、起動を待つ間10〜30秒かかり、その後はフルスピードで応答します。忙しいアプリでは起きたままです。ホスト型モデルをご覧ください。
用途別のツール
OpenAI Chat Completions、Anthropic Messages、Geminiを、それぞれの形式でストリーミングします。ゲートウェイは初期の失敗を保留し、最初のトークンより前に失敗した返信は別のチャネルで再試行します。ストリーミングをご覧ください。
OpenAIの音声API経由で qwen3-tts と zonos2。プリセット音声は9種類と3種類、説明文から設計する声、zonos2 の感情、10言語または40以上の言語。返信は最大4,096文字。テキスト読み上げをご覧ください。
GPT Image 2および2.5の編集で、参照画像は最大16枚、1枚あたり $0.04、通常は1枚40秒〜2分。高速なホスト型画像モデルはウォームアップ後なら数秒ですが、生成のみで参照画像は使えません。画像をご覧ください。
各キーには生涯支出上限、毎分リクエスト数上限、同時実行数上限、モデルの許可リスト、有効期限を設定できます。アプリと環境ごとに1つのキーを使い、無人で動くものには別のキーを使ってください。APIキーをご覧ください。
ユーザー向けの上限
キーはダッシュボードで作成するので、エンドユーザーごとではなくアプリの各部分向けです。チャット、音声、画像のワーカーには、それぞれに合った上限を付けた専用キーを与え、試用やデモ用には上限付きのキーを確保しておきます。上限に達したキーは、呼び出したAPIの形式で 402(支出)または 429(レートまたは同時実行数)として拒否され、拒否されたリクエストは課金されません。1日あたりのメッセージ数や週あたりの画像数といったユーザー単位の割り当ては、APIを呼ぶ前に使用量を数える自前のバックエンド側の役割です。キーをアプリ自体に同梱せず、必ずサーバーに置いてください。
成人向けコンパニオン
成人(18歳以上)には成人向けの会話と画像が許可されています。アプリで提供する場合、ユーザーの年齢確認はあなたの責任で、利用規約が適用されます。未成年が関わるものは常に不可、そして実在の人物の性的画像は本人の同意が必要です。
よくある質問
コンパニオンは過去の会話を覚えていますか?+
モデルは送った内容を覚えます。バックエンドが会話を保存し、直近のやり取りと古いやり取りの要約を毎リクエストに添えて送ります。ホスト型モデルは128Kトークンのコンテキストを受け取ります。
テキストが届いている間に音声をストリーミングできますか?+
いいえ。音声はストリーミングされません。返信を読み終えた時点で音声が返ります。多くのアプリはテキストを先に表示し、少し遅れて音声を再生するか、文が完成するごとに1文ずつ読み上げます。
キャラクターはどの写真でも同じに見えますか?+
毎回同じ参照ポートレートを編集に添え、シーンだけを描写してください。GPT Imageモデルはそこから顔と見た目を保ちます。
ロールプレイに無検閲モデルを使えますか?+
はい。システムプロンプトに従い、拒否せずに役を保ちます。Lovely Router はコンテンツフィルターを追加しません。アプリが生成する内容についてはあなたが責任を負います。
NSFWコンテンツは許可されていますか?+
成人向けのみです。アプリで提供する場合はユーザーの年齢を確認してください。未成年が関わるコンテンツは常に不可です。
ユーザーごとに専用のAPIキーを与えられますか?+
キーはダッシュボードで作るので、アプリの各部分や環境に向いています。ユーザー単位の使用量はバックエンドで追跡し、割り当てもそこで適用してください。
AIエージェントにアプリを作らせられますか?+
はい。このページのプロンプトをClaude Code、Cursor、Codexに貼り付けてください。Markdownのドキュメントを読み、あなたのキーでチャット、音声、画像の呼び出しを組み上げます。
分岐する選択肢のある長い物語についてはインタラクティブフィクションをご覧ください。始めるにはサインアップして、プレイグラウンドでキャラクターを試してみてください。