# AITUNNEL

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

- Base URL: https://api.aitunnel.ru/v1
- Зеркало, если провайдер блокирует основной хост: https://ru-api.aitunnel.ru/v1
- Формат ключа: sk-aitunnel-…
- Формат запросов: OpenAI Chat Completions API

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

- [Введение](https://aitunnel.ru/docs.md): base URL api.aitunnel.ru/v1, зеркало ru-api.aitunnel.ru/v1 при блокировке у провайдера (таймаут, Connection reset, Failed to fetch), авторизация, первый запрос, примеры на cURL/Python/JavaScript/Go/PHP, обзор возможностей и модель auto.
- [Баланс и оплата](https://aitunnel.ru/docs/payments.md): pay-as-you-go, способы оплаты, Invoicebox от 5 000 ₽, закрывающие документы, авто-пополнение, проверка баланса, тарифы, возврат, договор от 300 000 ₽ первого пополнения.
- [API-ключи](https://aitunnel.ru/docs/keys.md): создание ключа, лимит по балансу, бюджет, автосброс бюджета в 00:00 МСК (daily/weekly/monthly), срок, белый список моделей и IP, защита данных.
- [Список моделей](https://aitunnel.ru/docs/models.md): публичный GET /public/aitunnel/models без ключа, цены в рублях, группы chat/images/videos, OpenAI-совместимый /v1/models, deepseek-v4.1-flash.
- [Последняя версия семейства](https://aitunnel.ru/docs/latest-models.md): ~author/family-latest, ~anthropic/claude-opus-latest, ~anthropic/claude-sonnet-latest, ~anthropic/claude-haiku-latest, ~anthropic/claude-fable-latest, ~openai/gpt-latest, ~openai/gpt-mini-latest, ~google/gemini-flash-latest, ~google/gemini-pro-latest, ~deepseek/deepseek-v4-flash-latest, ~moonshotai/kimi-latest, ~x-ai/grok-latest, ~z-ai/glm-latest, ~z-ai/glm-flash-latest, поле model в ответе, usage.cost_rub, пресеты, models[], allowed_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, чекбокс «Перезаписывать параметры клиента» (override) и почему промпт пресета не применяется.
- [Batch запросы](https://aitunnel.ru/docs/batch.md): POST /v1/batches, поле batch в каталоге (discount/window), gpt-6-astra, gemini-3.8-flash, скидка на токены, опрос статуса, результаты в том же ответе, список пакетов и возврат резерва без вашего опроса.
- [Оптимизация сообщений](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.effort/context/mode, verbosity; отсутствующее поле не подменяется дефолтом AITUNNEL.
- [Ошибки и отладка](https://aitunnel.ru/docs/errors.md): JSON error.code/message, 402 из-за max_tokens, 429 провайдера, 504 таймаут провайдера, модерация, пустой ответ, ошибки в стриме, соединение не устанавливается (Connection reset, Failed to fetch) — зеркало ru-api.aitunnel.ru.
- [Эмбеддинги](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, gpt-image-2.5-flare / gpt-image-2.5-sunburst, quality xhigh и max, mai-image-2.6 / mai-image-2.6-flash, web_grounding, 504 таймаут и обрывы соединения (Failed to fetch) из-за веса референсов.
- [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, опрос статуса, статусы и возврат резерва, список задач GET /v1/jobs, image-to-video, video-to-video, несколько референсов в input_references без ограничения по количеству, hailuo-3-max, hailuo-3, flux-video-edit, flux-video-upscale, upscale_factor, creativity, prompt_optional, ₽/мегапиксель-сек, обязательные size и duration при апскейле, billing_only_parameters (провайдеру не передаются), max_output_megapixels.
- [Аудио](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, клонирование, supports_voice_cloning, input_references.
- [Распознавание речи](https://aitunnel.ru/docs/speech-to-text.md): POST /audio/transcriptions, multipart, Whisper / GPT Transcribe, mai-transcribe-2 (diarization, 0,33 ₽/мин), 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, max_results, фильтры доменов, цитаты, цена за фактические вызовы поиска и usage.cost_rub. Работает и с model: auto, и со слагами provider/model.
- [Структурированный вывод](https://aitunnel.ru/docs/structured-outputs.md): response_format json_schema, strict-режим, стриминг.
- [Токены рассуждений](https://aitunnel.ru/docs/reasoning.md): reasoning.effort и max_tokens, thinking.display summarized/omitted, Gemini thinkingLevel, GPT-5.6/GPT-6 reasoning.context и reasoning.mode, gpt-6-astra-pro, скрыть цепочку, сохранить 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, слоты Fable/Opus/Sonnet/Haiku, ANTHROPIC_DEFAULT_FABLE_MODEL=claude-fable-5.1, /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-6-astra.
- [Cursor IDE](https://aitunnel.ru/docs/cursor.md): AI-редактор через AITUNNEL — Override OpenAI Base URL со значением api.aitunnel.ru/v1/cursor (именно с /cursor, иначе Agent Mode падает на tool calling), Cursor шлёт свой формат на каждое семейство моделей: Responses API с input вместо messages для gpt-*; id моделей только в формате provider/model (moonshotai/kimi-k2.6, openai/gpt-5.5, anthropic/claude-sonnet-4.6), кнопки Verify в Cursor нет; Composer, Cmd+K, usage.cost_rub; Tab autocomplete и Apply не подключаются.
- [VS Code](https://aitunnel.ru/docs/vscode.md): Cline в VS Code через AITUNNEL — провайдер OpenAI Compatible, Base URL api.aitunnel.ru/v1 (без /cursor), ключ sk-aitunnel-, Model ID как в каталоге (claude-sonnet-4.6, claude-opus-5, kimi-k2.6); Model Configuration нужно заполнить руками, иначе контекст остаётся 128K, а цена показывается Free; настроек cline.* в settings.json не существует; Plan/Act, правки файлов, терминал, MCP, usage.cost_rub; Azure-чекбоксы выключены.
- [OpenCode](https://aitunnel.ru/docs/opencode.md): open-source терминальный агент через AITUNNEL — custom provider на npm @openrouter/ai-sdk-provider, ~/.config/opencode/opencode.jsonc, /connect, reasoning: true и reasoning.effort для рассуждений, modalities.input для картинок и PDF.
- [Qwen Code](https://aitunnel.ru/docs/qwen-code.md): агентный CLI QwenLM через AITUNNEL — Custom Provider, settings.json, .qwen/.env, qwen3-coder-next.
- [Hermes Agent](https://aitunnel.ru/docs/hermes-agent.md): автономный агент Nous через AITUNNEL — custom endpoint, providers.aitunnel, chat_completions.
- [OpenClaw](https://aitunnel.ru/docs/openclaw.md): шлюз агентов OpenClaw через AITUNNEL — custom provider openai-completions, openclaw.json, claude-sonnet-4.6.
- [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 — имя, бюджет, reset_at и reset_in_seconds до сброса бюджета, срок, белый список, 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