Aitunnel docs

AITunnel Docs — локальная база знаний

Этот скилл — обёртка над зеркалом docs.aitunnel.ru (45 страниц markdown в references/), плюс скрипты для регенерации этого зеркала. Цель — отвечать на вопросы об Aitunnel из актуальной официальной документации, а не из догадок.

Workflow

Шаг 1. Классифицировать вопрос

Определи тему вопроса пользователя по routing-таблице ниже. Если тема явно одна — переходи к шагу 2. Если их несколько (например, «как кешировать в Python через aitunnel» = prompt-caching + python-sdk) — выбери все релевантные файлы.

Шаг 2. Найти файл по routing-таблице

Все пути ниже — относительно references/ внутри этого скилла.

Тема вопроса	Файл
Аутентификация, заголовок Authorization, формат sk-aitunnel-…	api/authentication.md
Создание/удаление API-ключей, лимиты на ключ, бюджеты	guide/api-keys.md
Оплата, баланс, тарифы, пополнение, юр.лицо	guide/payments.md
Список моделей и цены за 1M токенов	external/aitunnel-ru-models.md
Какие endpoints вообще есть, общая карта /v1/*	api/reference.md
Специфичные методы AITUNNEL (не из OpenAI/Claude API)	api/aitunnel-methods.md
Параметры запроса (temperature, max_tokens, top_p, seed…)	api/parameters.md
Стриминг (SSE), формат чанков	api/streaming.md
Лимиты RPS / RPM / TPM	api/limits.md
HTTP-ошибки, коды, обработка	api/errors.md
Claude Messages API через Aitunnel (/v1/messages)	api/messages.md
Использование OpenRouter из России	api/openrouter.md
Embeddings (/v1/embeddings)	api/embeddings.md
Rerank (/v1/rerank)	api/rerank.md
Reasoning tokens (extended thinking, o-series)	api/reasoning.md
Moderation API	api/moderation.md
Responses API — обзор (что это, чем отличается от chat.completions)	api/responses/overview.md
Responses API — базовое использование	api/responses/basic-usage.md
Responses API — reasoning	api/responses/reasoning.md
Responses API — tool calling	api/responses/tool-calling.md
Responses API — встроенный web search	api/responses/web-search.md
Prompt caching, sticky routing, cache_read/write tokens	features/prompt-caching.md
Structured outputs / JSON schema / response_format	features/structured-outputs.md
Tool calling / function calling (для chat.completions)	features/tool-calling.md
Картинки и PDF на вход (vision-модели, multimodal input)	features/images-and-pdfs.md
Видео на вход модели	features/videos.md
Генерация изображений (DALL-E, Imagen, Flux и т.п.)	features/image-generation.md
Редактирование изображений (image-to-image)	features/image-editing.md
Генерация видео (text-to-video, image-to-video)	features/video-generation.md
TTS (text-to-speech, генерация речи)	features/text-to-speech.md
Аудио — STT, транскрипция, прочее аудио	features/audio.md
Встроенный веб-поиск как фича	features/web-search.md
Сжатие/трансформация истории сообщений	features/message-transforms.md
PII-редактирование	features/pii-redaction.md
Подключить Cursor	guides/cursor-integration.md
Подключить Claude Code	guides/claude-code-integration.md
Подключить Codex CLI	guides/codex-cli-integration.md
Подключить Qwen Code	guides/qwen-code-integration.md
Подключить OpenCode	guides/opencode-integration.md
Подключить OpenClaw	guides/openclaw-integration.md
Использовать через LangChain	guides/langchain-integration.md
Подключить Xcode	guides/xcode-integration.md
Использовать через Python + OpenAI SDK	guides/python-openai-sdk.md
Быстрый старт, hello world, base_url + первый запрос	index.md
Общие вопросы, поддержка, бытовые	faq.md

Если вопрос на стыке тем или не уверен — открой references/_index.md (полное оглавление со ссылками на исходные URL docs.aitunnel.ru).

Шаг 3. Загрузить только нужный файл

НЕ загружай всё подряд. Прочитай через Read только найденный файл (или 2-3, если вопрос составной). Каждый файл уже самодостаточен и содержит примеры на TypeScript / Python / curl где это уместно.

Frontmatter каждого файла содержит source_url — оригинальная страница на docs.aitunnel.ru. Используй её, когда нужна ссылка пользователю.

Шаг 4. Ответить на основе документации

• Цитируй конкретные параметры, лимиты, цены — из файла, а не из общего знания об OpenAI/Claude API. У Aitunnel могут быть свои особенности (например, формат ключа sk-aitunnel-…, base_url=https://api.aitunnel.ru/v1/, специфичные методы).
• Если в документации чего-то нет — честно скажи «в локальной копии docs нет, проверь на <source_url раздела> или в FAQ» вместо угадывания.
• При технических примерах ставь base_url/OPENAI_BASE_URL в https://api.aitunnel.ru/v1/ (для Claude Messages API — https://api.aitunnel.ru/v1; уточняй по api/messages.md).

Когда НЕ срабатывать

Этот скилл — про конкретно сервис Aitunnel. Не загружай его файлы, если вопрос:

• про OpenAI/Anthropic/Google API в общем (без упоминания aitunnel);
• про сравнение моделей в отрыве от Aitunnel;
• про общую разработку с LLM, prompt engineering, RAG и т.п.

В таких случаях отвечай обычным образом, без загрузки references/.

Обновление документации

Триггеры: «обнови документацию aitunnel», «refresh aitunnel docs», «пересобери docs», «обнови docs aitunnel».

Запусти PowerShell-обёртку (она сама ставит PYTHONUTF8=1 — обязательное требование crawl4ai на Windows — и AITUNNEL_DOCS_OUTPUT в references/ скилла):

pwsh -File <путь-к-скиллу>/scripts/update.ps1

Цепочка под капотом:

1. scrape_aitunnel.py — fetch sitemap docs.aitunnel.ru (~48 URL) + aitunnel.ru/models через crawl4ai.
2. postprocess.py — чистит VitePress-мусор (Skip to content, Pager, якоря, навигация).
3. link_rewrite.py — переписывает абсолютные docs.aitunnel.ru-ссылки в относительные и регенерирует references/_index.md.

Зависимости: Python 3.9+, crawl4ai, httpx, Playwright Chromium (см. crawl4ai-setup в одноимённом пакете). На Windows установлено в %APPDATA%\Python\Python310\Scripts.

После апдейта — кратко рапортуй пользователю: сколько страниц обновлено / появилось / исчезло (можно сравнить число файлов до и после).

Если скрипт упал на скрейпе — посмотри references/_failed.txt (создаётся только при провалах) и предложи retry: python scripts/scrape_aitunnel.py уже сделает второй проход с увеличенным таймаутом автоматически.

Структура скилла

aitunnel-docs/
├── SKILL.md                    (этот файл)
├── references/                 (45 .md — копия docs.aitunnel.ru)
│   ├── _index.md               (оглавление)
│   ├── index.md, faq.md
│   ├── api/ (13) + api/responses/ (5)
│   ├── features/ (13)
│   ├── guide/ (2), guides/ (9)
│   └── external/ (1 — список моделей с ценами)
└── scripts/
    ├── scrape_aitunnel.py      (crawler)
    ├── scrape_clean.py         (опц.: PruningContentFilter pass)
    ├── postprocess.py          (чистка)
    ├── link_rewrite.py         (ссылки + _index.md)
    └── update.ps1              (обёртка для одной команды)