# AITUNNEL

> Единый OpenAI-совместимый API к ведущим ИИ-моделям (GPT, Claude, Gemini, DeepSeek, Qwen, Kimi и другим) для пользователей из России. Один ключ, один формат запросов, оплата в рублях, VPN не требуется.

- Base URL: https://api.aitunnel.ru/v1
- Формат ключа: sk-aitunnel-…
- Формат запросов: OpenAI Chat Completions API

## Документация

- [Введение](https://aitunnel.ru/docs.md): base URL, авторизация, первый запрос, примеры на cURL/Python/JavaScript/Go/PHP, обзор возможностей и модель auto.
- [Баланс и оплата](https://aitunnel.ru/docs/payments.md): pay-as-you-go, способы оплаты, авто-пополнение, проверка баланса, тарифы, возврат.
- [API-ключи](https://aitunnel.ru/docs/keys.md): создание ключа, лимит по балансу, бюджет, срок, белый список моделей и IP, защита данных.
- [Список моделей](https://aitunnel.ru/docs/models.md): публичный GET /public/aitunnel/models без ключа, цены в рублях, группы chat/images/videos, OpenAI-совместимый /v1/models.
- [Запасные модели (fallback)](https://aitunnel.ru/docs/fallback.md): массив models в запросе, переключение на следующую модель при сбое, fallbacks в Messages API, списание.
- [Выбор провайдера](https://aitunnel.ru/docs/provider.md): provider.sort — price, throughput, latency. Минимальная цена или скорость вместо балансировки по нагрузке.
- [OpenRouter](https://aitunnel.ru/docs/openrouter.md): слаг провайдер/модель, доступ ко всему каталогу OpenRouter через ключ AITUNNEL, оплата в рублях.
- [Защита данных (PII)](https://aitunnel.ru/docs/pii.md): маскировка и блокировка персональных данных в запросах, типы детекторов, словарь, заголовки.
- [Пресеты](https://aitunnel.ru/docs/presets.md): имя вместо модели, системный промпт, параметры, failover до 5 моделей, provider.sort.
- [Batch запросы](https://aitunnel.ru/docs/batch.md): POST /v1/batches, скидка на токены, опрос статуса, результаты в том же ответе.
- [Оптимизация сообщений](https://aitunnel.ru/docs/transforms.md): сжатие середины промпта, если он длиннее контекста. Включено по умолчанию, выключается через plugins.
- [Уровни обслуживания](https://aitunnel.ru/docs/service-tiers.md): service_tier flex или priority — дешевле или быстрее. Списание по уровню, который реально обработал запрос.
- [Кеширование промпта](https://aitunnel.ru/docs/caching.md): скидка на повторяющийся префикс, cache_control для Claude и Qwen, sticky-маршрутизация, session_id, usage.cached_tokens.
- [Справочник API](https://aitunnel.ru/docs/api-reference.md): схема chat/completions, запрос и ответ, стриминг, tools, plugins, usage.cost_rub.
- [Стриминг](https://aitunnel.ru/docs/streaming.md): stream true, SSE-чанки, usage в последнем событии, ошибки до потока и в середине генерации.
- [Лимиты](https://aitunnel.ru/docs/limits.md): нет RPM со стороны AITUNNEL, 429 — лимит провайдера, контекст модели, файлы до 25 МБ.
- [Параметры](https://aitunnel.ru/docs/parameters.md): temperature, top_p, max_tokens, tools, reasoning, verbosity; отсутствующее поле не подменяется дефолтом AITUNNEL.
- [Ошибки и отладка](https://aitunnel.ru/docs/errors.md): JSON error.code/message, 402 из-за max_tokens, 429 провайдера, модерация, пустой ответ, ошибки в стриме.
- [Эмбеддинги](https://aitunnel.ru/docs/embeddings.md): POST /embeddings, пакет строк, картинки, usage.cost_rub, семантический поиск.
- [Модерация](https://aitunnel.ru/docs/moderation.md): бесплатный POST /moderations, категории политики, пакет текстов и картинки.
- [Ранжирование](https://aitunnel.ru/docs/rerank.md): POST /rerank, query и documents, top_n, RAG после эмбеддингов, usage.cost_rub.
- [Картинки](https://aitunnel.ru/docs/images.md): понимание через /chat/completions (URL и base64), генерация POST /images/generations, input_references, /images/edits.
- [PDF](https://aitunnel.ru/docs/pdf.md): type file в /chat/completions, URL и base64, file-parser, mistral-ocr / cloudflare-ai / native, annotations.
- [Видео](https://aitunnel.ru/docs/videos.md): понимание через /chat/completions (video_url, URL и base64), генерация POST /videos, опрос статуса, image-to-video, video-to-video.
- [Аудио](https://aitunnel.ru/docs/audio.md): аудио в чате — input_audio (base64) и голосовой ответ через modalities / audio.
- [Озвучка текста](https://aitunnel.ru/docs/text-to-speech.md): POST /audio/speech, JSON, сырой аудиопоток, голоса, mp3/pcm, instructions, клонирование.
- [Распознавание речи](https://aitunnel.ru/docs/speech-to-text.md): POST /audio/transcriptions, multipart, Whisper / GPT Transcribe, usage.cost_rub, лимит 25 МБ.
- [Вызов инструментов](https://aitunnel.ru/docs/tool-calling.md): массив tools, tool_calls, возврат результатов, tool_choice, агентский цикл.
- [Серверные инструменты](https://aitunnel.ru/docs/server-tools.md): модель вызывает, AITUNNEL исполняет. Сейчас aitunnel:web_search.
- [Веб-поиск](https://aitunnel.ru/docs/web-search.md): aitunnel:web_search, движки auto/native/exa/parallel/perplexity, фильтры доменов, цитаты, цена за фактические вызовы.
- [Структурированный вывод](https://aitunnel.ru/docs/structured-outputs.md): response_format json_schema, strict-режим, стриминг.
- [Токены рассуждений](https://aitunnel.ru/docs/reasoning.md): reasoning.effort и max_tokens, скрыть цепочку, сохранить reasoning_details между вызовами инструментов.
- [RAG](https://aitunnel.ru/docs/rag.md): пайплайн retrieval-augmented generation — эмбеддинги, rerank и ответ чата по найденному контексту.
- [Claude Code](https://aitunnel.ru/docs/claude-code.md): терминальный агент Anthropic через AITUNNEL — ANTHROPIC_BASE_URL, слоты моделей, /fast, GitHub Action, statusline.
- [Claude Desktop](https://aitunnel.ru/docs/claude-desktop.md): приложение Anthropic через Gateway AITUNNEL — base URL без /v1, bearer-ключ, без аккаунта Anthropic.
- [Codex CLI](https://aitunnel.ru/docs/codex-cli.md): терминальный агент OpenAI через AITUNNEL — config.toml, командный auth, gpt-5.6-sol.
- [Xcode](https://aitunnel.ru/docs/xcode.md): Apple Intelligence в Xcode 26 через AITUNNEL — URL без /v1, Bearer-ключ.
- [LangChain](https://aitunnel.ru/docs/langchain.md): ChatOpenAI и OpenAIEmbeddings через base_url AITUNNEL, чат, эмбеддинги, RAG.
- [AITUNNEL API](https://aitunnel.ru/docs/api.md): методы /v1/aitunnel — аккаунт, баланс, ключ, статистика.
- [Аккаунт](https://aitunnel.ru/docs/api/me.md): GET /aitunnel/me — почта и id по ключу.
- [Баланс API](https://aitunnel.ru/docs/api/balance.md): GET /aitunnel/balance — баланс в рублях и бюджет ключа.
- [Ключ API](https://aitunnel.ru/docs/api/key.md): GET /aitunnel/key — имя, бюджет, срок, белый список, PII.
- [Статистика](https://aitunnel.ru/docs/api/stats.md): GET /aitunnel/stats/summary — расход и запросы по ключу.

## Ресурсы

- [Каталог моделей и цены](https://aitunnel.ru/models): актуальный список моделей с ценами за токены.
- [API-ключи](https://aitunnel.ru/panel/keys): создание и ограничение ключей.
- [Пополнение баланса](https://aitunnel.ru/panel/purchase): оплата в рублях, счёт для юридических лиц.

## Поддержка

- Почта: support@aitunnel.ru
- Телеграм: https://t.me/aitunnelru