"""
Mirabella Cloud — LLM API Gateway

OpenAI-совместимый API к моделям на базе Qwen, развёрнутым на собственных GPU в России.
Оплата в рублях. Данные не покидают РФ (152-ФЗ).

Base URL: https://api.mirabella.cloud/v1
Auth:     Authorization: Bearer $YOUR_KEY

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

```bash
curl https://api.mirabella.cloud/v1/chat/completions \
  -H "Authorization: Bearer $YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"mirabella-flash","messages":[{"role":"user","content":"Привет!"}],"max_tokens":200}'
```

## Модели

- **mirabella-flash** — Qwen3.8-Flash-Next, MoE 125B (6B активных параметров)
  - 256k контекст · chat, tools, reasoning, vision
  - День: 20 ₽ / 60 ₽ за 1M токенов (in/out)
  - Ночь (22–06 МСК): ×0.5 — 10 ₽ / 30 ₽
  - Параметры: temperature, top_p, n, seed, presence_penalty, frequency_penalty,
    stop, tools, tool_choice, response_format, logprobs, top_logprobs, user,
    max_tokens (или max_completion_tokens), reasoning_effort
  - reasoning_effort: "none" | "minimal" — выключает размышления (output в 2–3 раза
    дешевле), "low" | "medium" | "high" — с размышлениями (по умолчанию)
  - Токены размышлений тарифицируются как output. С включёнными размышлениями
    max_tokens < 128 может отдать пустой content при finish_reason="length"
  - response_format {"type":"json_object"} отдаёт чистый JSON, без markdown-обёртки
  - Неизвестный параметр → HTTP 400 со списком поддерживаемых, а не тихая потеря

## Оплата

- Баланс в рублях: карта РФ или СБП, зачисление в день обращения
- Пополнение баланса — через менеджера: https://t.me/TheMysteryCat
- Бесплатный тариф: 1 000 000 токенов/сутки (вход + выход), 10 000 000 токенов на ключ

## Тарификация день/ночь

Ночной тариф действует автоматически с 22:00 до 06:00 МСК.
Цена снижается в 2 раза без каких-либо действий со стороны клиента.

## Кэш контекста

Токены входа, отправленные повторно (агент пересылает историю на каждом ходе),
берутся из кэша контекста и тарифицируются по 5% от цены входа — скидка 95%.
Отдельного параметра нет. Чтобы скидка работала, держите системный промпт и
прикреплённые документы неизменными и не переписывайте историю диалога.

## Эндпоинты

- `POST /api/v1/chat/completions` — chat (stream + sync)
- `GET  /api/v1/models` — список моделей
- `GET  /api/public/prices` — машиночитаемый прайс JSON
- `GET  /api/public/models` — публичный список моделей с ценами
- `GET  /health` — статус сервиса

## Совместимость

OpenAI SDK, LangChain, CrewAI, Vercel AI SDK, opencode, Cursor, Cline, Continue —
любой клиент, принимающий OpenAI-compatible API.
Просто измените base_url на https://api.mirabella.cloud/v1

## Лимиты

- Free: 1 000 000 токенов/день, 10 000 000 токенов на ключ (лимит по токенам, не по запросам)
- Ошибки — в OpenAI-формате: `{"error": {"message", "type", "param", "code"}}`
- 429 содержит `Retry-After`; `code=rate_limit_exceeded` — слишком много запросов, `code=free_quota_exceeded` — кончилась суточная квота
- Каждый ответ несёт `x-ratelimit-limit-requests` / `-remaining-` / `-reset-requests`: троттлинг удобней строить на остатке, а не на ретраях
- Pay: зависит от баланса

## Privacy

- 152-ФЗ: данные обрабатываются на территории РФ
- Мы не храним содержимое запросов дольше 30 дней
- API-ключи: только хеш, не plaintext

## Status

- Статус: https://mirabella.cloud/health
- Документация: https://mirabella.cloud/docs

## Помощь с агентом

Подключаем и настраиваем ИИ-агентов под ключ: Cursor, Cline, Roo Code, opencode,
Claude Code, Continue, Zed, aider.

- Подбор параметров под задачу (temperature, max_tokens, режим рассуждений, контекст)
- Настройка параллельности, пауз и ретраев — чтобы не ловить 429
- Перенос с другого провайдера (правка base_url)
- Расчёт стоимости по реальному объёму токенов
- Разбор проблем: тормозит, обрезает ответы, не вызывает инструменты

## Контакты

- Telegram (вопросы, оплата, лимиты): https://t.me/TheMysteryCat