API для приложения AI-компаньона:
чат, голос и картинки на одном ключе
Приложение AI-компаньона на одном предоплатном ключе: потоковый чат, голос для каждого ответа, картинки и лимиты на ключ.
Обновлено 2026-11-05
Бонус за пополнение: Чёрная пятница
Каждое подходящее пополнение даёт бесплатные средства, а также суммируется с другими предложениями.
До 30 ноября
Приложение AI-компаньона — это персонаж, к которому возвращаются: тот, кто помнит разговор, отвечает своим голосом и время от времени присылает картинку. Собирается это из трёх API, и на Lovely Router у них общий ключ и общий предоплатный баланс. Чат — через OpenAI или Anthropic API, потоком, токен за токеном, на любой чат-модели: Claude, GPT и Gemini или на одной из безцензурных моделей, которые не выходят из роли и не отказываются. Голос — из синтеза речи, созданный один раз и сохранённый. Картинки — из API генерации изображений, по референсному портрету персонажа, чтобы на каждом снимке был один и тот же человек. Ключ, память и аккаунты пользователей живут в вашем бэкенде; лимиты на ключ держат каждую часть приложения в её бюджете.
Передайте это своему ИИ-агенту
Скопируйте этот промпт в 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>
Как это работает
Опишите персонажа
Системный промпт о том, кто такой компаньон: имя, характер, манера речи, что он помнит о пользователе. Ваш бэкенд хранит переписку и отправляет с каждым запросом последние реплики плюс краткое резюме более старых.
Отвечайте потоком
Отправьте переписку в
POST /v1/chat/completions(или/v1/messages) сstream: trueи показывайте слова по мере поступления. Меняйте модель на каждый запрос: быструю и дешёвую для болтовни, посильнее — для длинных сцен.Дайте персонажу голос
Создайте голос компаньона один раз с помощью
qwen3-ttsпо описанию, сохраните его черезPOST /v1/audio/voicesи озвучивайте каждый ответ по его id. Аудио приходит, когда ответ озвучен целиком, в MP3 или Opus.Пришлите картинку
Держите один референсный портрет персонажа. Когда по сюжету нужна картинка, отправьте его в
POST /v1/images/editsс промптом сцены — изображение сохранит то же лицо и облик.
Ответ, его голос и картинка
Стримьте ответ в Node.js через OpenAI SDK:
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 | $0.80 вход · $2.00 выход за 1 млн токенов |
| Qwen3.5 9B Defiant Fable (uncensored) qwen3.5-9b-defiant-fable | text+image | $0.90 вход · $14.40 выход за 1 млн токенов |
| Qwen3.8 27B Heretic (uncensored) qwen3.8-27b-heretic | text+image | $1.40 вход · $21.90 выход за 1 млн токенов |
| Huihui Qwen3.8 27B (abliterated) huihui-qwen3.8-27b-abliterated | text+image | $1.45 вход · $20.60 выход за 1 млн токенов |
Актуальные цены в долларах — столько же списывает 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, каждый стримится в своём формате. Шлюз придерживает ранние сбои, поэтому ответ, упавший до первого токена, повторяется на другом канале. См. стриминг.
qwen3-tts и zonos2 через API речи OpenAI: девять и три готовых голоса, голоса по описанию, эмоции на zonos2, 10 или 40+ языков. Ответы до 4 096 символов. См. синтез речи.
Редактирование через GPT Image 2 и 2.5 с максимум 16 референсными изображениями, $0.04 за изображение, обычно от 40 секунд до 2 минут на каждое. Быстрые размещённые модели изображений отвечают за несколько секунд после прогрева, но только генерируют, без референсных изображений. См. изображения.
У каждого ключа может быть пожизненный лимит трат, лимит запросов в минуту, лимит параллельных запросов, список разрешённых моделей и дата истечения. Заводите по ключу на каждую часть приложения и окружение, и отдельный ключ для всего, что работает без присмотра. См. ключи API.
Лимиты для ваших пользователей
Ключи создаются в панели, поэтому они для частей вашего приложения, а не для каждого конечного пользователя. Выдайте обработчикам чата, голоса и картинок собственные ключи с подходящими лимитами и держите ключ с потолком для проб и демо. Ключ, упёршийся в лимит, получает отказ 402 (траты) или 429 (частота или параллельность) в формате того API, который вы вызвали, и за отклонённые запросы не списывают. Квоты на пользователя — например, сообщений в день или картинок в неделю — живут в вашем бэкенде, который считает расход до вызова API. Никогда не кладите ключ в само приложение: держите его на сервере.
Взрослые компаньоны
Взрослые разговоры и изображения разрешены для взрослых (18+). Если ваше приложение их предлагает, проверка возраста пользователей — ваша ответственность, и действует Политика допустимого использования: ничего с несовершеннолетними, никогда, и никаких эротических изображений реальных людей без их согласия.
Сколько вы платите
Чат тарифицируется за токен по цене каждой модели, она показана выше в реальном времени и на странице цен. Речь — $0.036 за минуту аудио с оплатой по секундам: голосовой ответ на 15 секунд стоит $0.009. Картинки — $0.04 за штуку на моделях GPT Image. Всё списывается с одного предоплатного баланса, и каждый вызов виден в ваших логах вместе с ключом и списанием.
Частые вопросы
Помнит ли компаньон прошлые разговоры?+
Модель помнит то, что вы ей отправили. Ваш бэкенд хранит переписку и отправляет с каждым запросом последние реплики плюс резюме более старых. Размещённые модели принимают 128K токенов контекста.
Может ли голос стримиться, пока текст ещё приходит?+
Нет. Речь не стримится: аудио приходит, когда ответ озвучен. Многие приложения сначала показывают текст, а голос включают мгновением позже — или озвучивают по предложению, как только каждое готово.
Будет ли персонаж выглядеть одинаково на каждой картинке?+
Отправляйте один и тот же референсный портрет с каждым редактированием и описывайте только сцену. Модели GPT Image сохраняют с него лицо и облик.
Можно ли использовать безцензурные модели для ролевых игр?+
Да. Они следуют системному промпту и не выходят из роли, не отказываясь, а Lovely Router не добавляет своего контент-фильтра. За то, что генерирует ваше приложение, отвечаете вы.
Разрешён ли NSFW-контент?+
Только для взрослых. Проверяйте возраст пользователей, если приложение его предлагает; контент с несовершеннолетними не разрешён никогда.
Можно ли выдать каждому пользователю свой ключ API?+
Ключи делаются в панели, поэтому они подходят для частей приложения и окружений. Считайте расход по пользователям в своём бэкенде и применяйте квоты там.
Может ли AI-агент собрать приложение?+
Да. Скопируйте промпт с этой страницы в Claude Code, Cursor или Codex: он прочитает Markdown-документацию и подключит вызовы чата, речи и изображений с вашим ключом.
Для длинных историй с ветвлением выбора см. интерактивную прозу; чтобы начать, зарегистрируйтесь и попробуйте персонажа в песочнице.
Один предоплаченный ключ для моделей, данных и агентов
Без подписки. Пополняйте баланс, используйте сколько нужно и смотрите каждое списание в логах.