Как встроить Heli API в SaaS: один серверный ключ, прокси-эндпоинт для клиентов, лимиты по пользователям и рублёвый биллинг за токены. Base URL getheli.ru/v1, ключ только на backend.
Архитектура
Клиенты вашего SaaS не должны видеть sk-heli-…. Схема:
- Heli-ключ хранится в env сервера (не во фронтенде).
- Клиент вызывает ваш API: POST /api/chat с JWT или session cookie.
- Backend проверяет лимиты пользователя и проксирует запрос в Heli.
- Списание идёт с вашего рублёвого баланса Heli — вы монетизируете через свою подписку.
Пример backend (Node.js)
import OpenAI from "openai";
const heli = new OpenAI({
baseURL: "https://getheli.ru/v1",
apiKey: process.env.HELI_API_KEY,
});
export async function chatForUser(userId: string, messages: Message[]) {
await assertUserQuota(userId); // ваш лимит запросов/токенов
const response = await heli.chat.completions.create({
model: "google/gemini-2.5-flash", // дёшево для SaaS
messages,
max_tokens: 1024,
});
await logUsage(userId, response.usage);
return response.choices[0].message.content;
}Для премиум-тарифа переключайте модель на openai/gpt-4.1 или anthropic/claude-sonnet-4.
Экономика SaaS
- Gemini Flash или GPT-4.1 mini — для базового тарифа (см. /models/gemini).
- Закладывайте маржу 2–5× к себестоимости токенов Heli в цену подписки.
- Лимитируйте
max_tokensи длину history — это главный рычаг расходов. - Отдельные ключи Heli на staging/prod — см. безопасность ключа.
Юридически для ИП и ООО
Heli продаёт предоплаченный доступ к API — подходит для учёта расходов на LLM в рублях. Подробнее — в статье «API для ИП и бизнеса».
Попробуйте Heli за 30 секунд
Ключ sk-heli- и кабинет создаются сразу. После подтверждения почты — 50 ₽ на баланс.