Python openai SDK + Heli

Установка

pip install openai

Получите ключ на getheli.ru и сохраните в переменной окружения — не хардкодьте в коде.

Базовый пример

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["HELI_API_KEY"],  # sk-heli-…
    base_url="https://getheli.ru/v1",
)

completion = client.chat.completions.create(
    model="openai/gpt-4.1-mini",
    messages=[
        {"role": "system", "content": "Ты полезный ассистент."},
        {"role": "user", "content": "Что такое Heli?"},
    ],
)

print(completion.choices[0].message.content)

Слаг модели — любой из каталога /models, например anthropic/claude-sonnet-4 или deepseek/deepseek-chat.

Streaming

Добавьте stream=True — см. полный пример в статье «Streaming API в Heli». Формат чанков идентичен OpenAI.

Embeddings

response = client.embeddings.create(
    model="openai/text-embedding-3-small",
    input="Текст для векторизации",
)

vector = response.data[0].embedding
print(len(vector))  # размерность embedding

Используйте для RAG, семантического поиска и кластеризации. С LangChain — в статье «LangChain с Heli».

Обработка ошибок и биллинг

При нулевом балансе API вернёт ошибку 402 — пополните кошелёк в личном кабинете. При неверном ключе — 401. Храните ключ в .env, не коммитьте в git — см. «Безопасность API-ключа». Полная документация — /docs.