Metadata-Version: 2.4
Name: klyuchora
Version: 0.2.0
Summary: SDK Ключоры для Python: все модели, стриминг, лимиты ключей, баланс кабинета. Сайт: https://klyuchora.ru
Home-page: https://klyuchora.ru
Author: Klyuchora
License: MIT
Project-URL: Homepage, https://klyuchora.ru
Project-URL: Documentation, https://klyuchora.ru/sdk
Keywords: klyuchora,ключора,llm,api,sdk,ai
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Typing :: Typed
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Dynamic: license-file

# klyuchora

Официальный SDK сервиса [Ключора](https://klyuchora.ru) для Python. Без зависимостей, Python 3.8+.
Чат и стриминг, все типы моделей, список доступных моделей, лимиты ключа, баланс кабинета, оценка стоимости запроса, async и командная строка.

Сайт: https://klyuchora.ru · Документация: https://klyuchora.ru/sdk

## Установка

    pip install klyuchora

## Быстрый старт

Ключ создаётся в кабинете на https://klyuchora.ru (раздел «Ключи API»). Положите его в переменную окружения `KLYUCHORA_API_KEY`.

```python
from klyuchora import Klyuchora

client = Klyuchora()  # ключ берётся из KLYUCHORA_API_KEY
reply = client.chat.completions.create(
    model="gpt-4o-mini",
    messages=[{"role": "user", "content": "Привет!"}],
)
print(reply.choices[0].message.content)

# стриминг
with client.chat.completions.create(model="gpt-4o-mini", messages=[{"role": "user", "content": "Расскажи шутку"}], stream=True) as stream:
    for text in stream.text_deltas():
        print(text, end="", flush=True)

print(client.models.ids())        # модели, доступные вашему ключу
print(client.key.usage())         # лимиты и расход ключа
print(client.account.balance())   # баланс кабинета (нужен KLYUCHORA_ACCESS_TOKEN)
print(client.estimate_cost("gpt-4o-mini", input_tokens=1000, output_tokens=500))
```

Асинхронный клиент: `AsyncKlyuchora`. Командная строка:
`klyuchora models | price МОДЕЛЬ | usage | balance | keys | rate | chat МОДЕЛЬ "текст"`.

Полная документация с примерами для всех методов: https://klyuchora.ru/sdk

## Лицензия

MIT
