Документация Heli API
Heli — собственный OpenAI-совместимый шлюз к моделям с оплатой в рублях. Один ключ sk-heli-… и базовый URL https://getheli.ru/v1.
Быстрый старт
- 1Зарегистрируйтесь по почте и паролю.
- 2Подтвердите почту по ссылке из письма (или войдите через Google или Яндекс ID, тогда подтверждать не нужно). Откроется кабинет, ключ уже там.
- 3Пополните баланс картой, через СБП, по счёту для ИП и юрлиц или в USDT — способы оплаты.
- 4Укажите base URL и ключ в своём клиенте (Cursor, Python, Node.js и т.д.).
Base URL
https://getheli.ru/v1Совместимо с OpenAI SDK и любыми клиентами, где можно задать baseURL / OPENAI_BASE_URL. Слаги моделей — как в каталоге, например deepseek/deepseek-v4-flash.
Авторизация
Authorization: Bearer sk-heli-ВАШ_КЛЮЧКлюч лежит в кабинете после регистрации и подтверждения почты. Формат — sk-heli-…
Chat Completions
POST /v1/chat/completions — основной endpoint. Поддерживается streaming (stream: true). Любой слаг модели каталога Heli.
curl https://getheli.ru/v1/chat/completions \
-H "Authorization: Bearer sk-heli-…" \
-H "Content-Type: application/json" \
-d '{
"model": "deepseek/deepseek-v4-flash",
"messages": [{ "role": "user", "content": "Привет" }]
}'Anthropic Messages (Claude Code)
POST /v1/messages — тот же API в формате Anthropic: стрим, инструменты, count_tokens, ошибки в формате Anthropic. Ключ — в x-api-key или Authorization: Bearer, модель — любой слаг каталога. Для Claude Code и Anthropic SDK base URL — https://getheli.ru (без /v1, SDK добавляет его сам). Настройка — в гайде по Claude Code.
Embeddings и аудио
POST /v1/embeddings, /v1/audio/transcriptions и /v1/audio/speech — те же ключ и кошелёк. Каталог и кабинет выделяют раздел «Эмбеддинги и аудио». Слаги text-embedding-3-large, text-embedding-3-small и whisper-1 принимаются как алиасы канонических id. Цены в рублях: эмбеддинги — за 1 млн токенов, расшифровка — обычно за минуту, озвучка — обычно за 1 тыс. символов.
Аудио списывается по фактической стоимости запроса в рублях: в зависимости от модели — за символы текста, минуты аудио или токены. tts-1 и tts-1-hd принимаются как алиасы модели озвучки по умолчанию. Параметры, голоса, лимиты и примеры — на странице про озвучку и расшифровку.
OCR
POST /v1/ocr — совместим с Mistral OCR: модели mistral-ocr-4 и mistral-ocr-latest. Вход: document_url / image_url или base64. Выход: страницы markdown. Не больше 8 картинок на запрос. Списание за страницу в рублях по тарифу Heli.
curl https://getheli.ru/v1/ocr \
-H "Authorization: Bearer sk-heli-…" \
-H "Content-Type: application/json" \
-d '{
"model": "mistral-ocr-latest",
"document_url": "https://example.com/scan.pdf"
}'Models
GET /v1/models — список моделей в формате OpenAI (требует Bearer). Актуальные цены в рублях за 1 млн токенов — на публичной странице Модели и цены.
Выгрузка расхода
GET /v1/usage/export — CSV или JSON за период (Bearer-ключ). Поля: разработчик модели, токены включая кэш, задержки, статус, стоимость в рублях. Тексты запросов не хранятся. Подробности — в разделе для команд.
Коды ошибок
| Код | Что значит | Что делать |
|---|---|---|
| 401 | Неверный или отозванный ключ | Проверьте ключ в кабинете |
| 402 | Недостаточно средств на балансе | Пополните кошелёк в кабинете |
| 429 | Слишком много неуспешных попыток авторизации с одного IP | Подождите и повторите с верным ключом |
| 502 | Временная ошибка сервиса или оценки стоимости | Повторите запрос |
Тарификация
Предоплаченный рублёвый баланс. Списание за каждый запрос в рублях по ценам каталога Heli. Подробности — в разделе Услуги и оплата.
Reasoning-модели (GPT-5, o-серия, Gemini Pro, DeepSeek R1 и т.п.) сначала рассуждают, и рассуждение входит в max_tokens. Если лимит кончился до ответа, модель вернёт пустой content с finish_reason: "length". Такой пустой ответ Heli не списывает (заголовок X-Heli-Not-Charged: empty_answer). Чтобы ответ успел появиться, увеличьте max_tokens или задайте reasoning: { effort: "low" }.