Оплата и основы
21 статья
- Ошибка 401 с ключом sk-heli-: что проверитьHTTP 401 Incorrect API key при запросах к getheli.ru/v1: как выглядит ответ Heli, почему запрос мог уйти не туда, проверка ключа через curl, ротация и временная блокировка 429.Читать
- Ошибка 429 в Heli API: rate limit, лимиты ключа и бюджетЧто означает HTTP 429 в Heli: частота запросов аккаунта, RPM ключа, лимит расходов (code budget), лимит модели и попытки авторизации. Как различить по code и правильно повторять запросы.Читать
- Ошибка invalid model / model not found в Heli API: правильный slug моделиПочему Heli отвечает ошибкой о неверной модели: формат vendor/model, короткие имена вроде gpt-4, устаревшие слаги, алиасы без префикса, список моделей через GET /v1/models и политика allowlist ключа.Читать
- Ошибка 402 insufficient balance в Heli: что делатьПочему Heli отвечает 402 Insufficient balance (insufficient_quota): предоплаченный рублёвый баланс, оценка стоимости до запроса, пополнение, отличие от лимита бюджета 429 и мониторинг расхода.Читать
- Timeout при chat completions в Heli API: причины и настройкиПочему запросы к Heli обрываются по таймауту: таймаут SDK и его повторы, 504 от Heli, reverse proxy с лимитом 60 секунд, долгие reasoning-модели. Как настроить timeout в Python и Node.js и когда переходить на streaming.Читать
- Как сменить модель в Cursor с HeliКак добавить модели Heli в Cursor и переключаться между ними: OpenAI API Key, Override OpenAI Base URL getheli.ru/v1, custom model, ограничения Cursor и частые ошибки.Читать
- Tool calling (function calling) в Heli API: пример на PythonКак работает tool calling через Heli: параметр tools, ответ tool_calls, сообщение role tool с tool_call_id, полный цикл на Python, выбор моделей и частые ошибки.Читать
- JSON mode и Structured Outputs в Heli APIКак получать от моделей валидный JSON через Heli: response_format json_object и json_schema со strict, пример на Python, какие модели поддерживают схему и частые ошибки.Читать
- Ошибки 500, 502 и 504 в Heli API: причины и что делатьЧто означают серверные ошибки Heli API: 500 — внутренняя ошибка шлюза, 502 — ошибка или недоступность модели, 504 — модель не ответила вовремя. Когда повторять запрос, как настроить backoff, запасную модель и что прислать в поддержку.Читать
- max_tokens и обрезанный ответ в Heli API: finish_reason lengthПочему ответ модели обрывается на полуслове: finish_reason length, лимит max_tokens и окно контекста, reasoning-токены, обрезанный JSON. Как выбрать max_tokens, продолжить ответ и как Heli учитывает max_tokens при резерве баланса.Читать
- Переменные окружения для Heli: OPENAI_BASE_URL и OPENAI_API_KEYКакие переменные окружения читают OpenAI SDK для Python, Node.js, Go и Rust, как направить их на Heli через OPENAI_BASE_URL, когда лучше свой HELI_API_KEY, настройка в Linux, Windows и Docker и частые ошибки с .env.Читать
- Отладка Heli API через curl: ключ, модель, ошибки и стримингМинимальные curl-запросы к getheli.ru/v1 для диагностики: проверка ключа через /v1/models, тестовый chat completion, заголовки и статус с -i, стриминг с -N, время ответа, особенности curl в Windows и расшифровка 401, 402, 429, 502, 504.Читать
- Heli API для маркетинговых агентств: модели, ключи по клиентам, отчётыLLM API для агентств: процесс черновик → фактчекинг → редактура на разных моделях, отдельные проекты и ключи по клиентам, выгрузка расходов для отчётов и оплата по счёту в рублях.Читать
- Учёт расходов на LLM API: документы, выгрузки и разбивка по проектамКак вести учёт расходов на Heli API: пополнения и акты, выгрузка журнала запросов в CSV или JSON, разбивка по проектам и ключам, сверка баланса и роль «Финансы» для бухгалтера.Читать
- Несколько API-ключей для команды: проекты, лимиты и ротацияКак организовать ключи Heli для команды: ключ на окружение, сервис или клиента, проекты как центры затрат, лимиты на ключ, ротация с периодом перекрытия, роли и журнал действий.Читать
- ROI LLM API для бизнеса: как считать окупаемостьКак посчитать окупаемость внедрения LLM API: формула ROI и срока окупаемости, какие затраты учитывать кроме токенов, как измерить эффект и где взять фактический расход в кабинете Heli.Читать
- Лимиты и контроль расходов Heli API: бюджеты, алерты, политикиКак контролировать расход на LLM API в Heli: предоплаченный рублёвый баланс, бюджеты на день, неделю и месяц для аккаунта, проекта или ключа, письма при 50/80/90/100%, резервная модель, allowlist моделей, потолок max_tokens и RPM на ключ.Читать
- Оплата в Heli: кошелёк, Robokassa, возвратКак пополнить баланс Heli в рублях: предоплаченный кошелёк, Robokassa, счёт для ИП и возврат неизрасходованного остатка.Читать
- Безопасность sk-heli-: что можно и нельзяКак безопасно хранить API-ключ sk-heli-: не светить во фронтенде, отзыв ключей, лимиты и best practices для команд.Читать
- API нейросетей для ИП и малого бизнесаHeli для команд в РФ: оплата по счёту, оферта, рублёвый учёт расходов на LLM.Читать
- API нейросетей по счёту для юрлиц и ИПОплата Heli API по счёту в рублях: реквизиты, оферта, учёт расходов на LLM для компаний.Читать