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

Один ключ для Claude, GPT, Gemini, Grok, DeepSeek и других моделей. Подходят SDK и клиенты Anthropic и OpenAI.

Ваш ключ подставится в примеры ниже. Он остаётся в вашем браузере и никуда не отправляется.

Модель для примеров

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

Адрес API: https://mewl.ru. Ключ передаётся в заголовке x-api-key: КЛЮЧ или Authorization: Bearer КЛЮЧ, подойдёт любой. Ключи начинаются с sk-mwl-.

Проверка ключа и списка моделей

Первый запрос (формат Anthropic)

Эндпоинты

Метод	Путь	Что делает
POST	`/v1/messages`	Формат Anthropic Messages. Работает со всеми моделями, в том числе с GPT, Gemini и другими. Поддерживает стриминг (`"stream": true`), инструменты, картинки.
POST	`/v1/messages/count_tokens`	Подсчёт токенов запроса (формат Anthropic) без выполнения.
POST	`/v1/chat/completions`	Формат OpenAI Chat Completions. Стриминг, `tools` и `stream_options.include_usage` поддерживаются.
GET	`/v1/models`	Список моделей, доступных вашему ключу.
GET	`/api/models`	Публичный список моделей с коэффициентами и доступностью. Без ключа.
GET	`/api/status`	Статус маршрутов и провайдеров (то же, что на странице Статус).

Формат Responses API (/v1/responses), который использует Codex CLI, не поддерживается. Используйте клиенты с Chat Completions или Messages.

Пример запроса и ответа

Стриминг

Добавьте "stream": true. Ответ приходит потоком SSE в формате выбранного эндпоинта. Если соединение оборвать, генерация останавливается, а токены списываются за уже полученную часть.

Ошибки

Код	Сообщение	Что делать
`401`	`Invalid API key`	Ключ неверный, отключён или удалён. Проверьте, что он скопирован целиком.
`404`	`Model not allowed`	Такого названия модели нет. Точные имена в `/v1/models` и в таблице ниже.
`429`	`Quota exceeded`	Токены на ключе закончились. Пополните ключ в личном кабинете.
`429`	`Insufficient quota for this request`	Остатка не хватает на этот запрос. Подробнее в вопросах ниже.
`429`	`Sub-key limit exceeded`	Исчерпан лимит дополнительного ключа. Его можно поднять в кабинете.
`503`	`Model is temporarily unavailable`	Модель временно отключена. Выберите другую или повторите позже.

Подключение клиентов

Выберите программу. Команды и настройки уже содержат ваш адрес, ключ и выбранную модель.

Как считаются токены и коэффициент

С баланса ключа списывается не «сырое» количество токенов модели, а оно же, умноженное на коэффициент модели:

(вход + вход (кэш) + выход) × коэффициент = списано

Вход: всё, что вы отправили модели в этом запросе: системный промпт, описания инструментов, вся история чата и ваше сообщение.
Вход (кэш): часть входа, которую провайдер взял из кэша (повторяющийся контекст). Кэш ускоряет ответ, но у нас считается наравне с обычным входом, скидки на него нет.
Выход: то, что написала модель, включая «рассуждения» (thinking), если они включены.
Коэффициент зависит от модели: у дешёвых он меньше единицы, у мощных больше. Он указан у каждой модели в таблице ниже и в личном кабинете.

Пример: запрос на модель с коэффициентом ×2, вход 10.000, кэш 30.000, выход 1.500. Итого (10.000 + 30.000 + 1.500) × 2 = 83.000 токенов с баланса.

Расход по каждому запросу разобран в кабинете: «История списаний».

Калькулятор

Модель

Вход, токенов

Вход (кэш), токенов

Выход, токенов

Остаток на ключе (необязательно)

Модели и коэффициенты

Модель	Провайдер	Коэфф.
Загрузка…

Коэффициенты могут меняться, актуальные значения всегда здесь.

Частые вопросы

Почему мои токены сгорели так быстро?

Почти всегда дело не в одном большом сообщении, а в том, как устроены нейросети и агенты. Главные причины:

Контекст отправляется заново с каждым запросом. Модель ничего не «помнит»: клиент присылает всю историю чата целиком. Чем длиннее сессия, тем дороже каждое следующее сообщение. 30 сообщений по 20.000 токенов контекста — это уже 600.000 токенов входа.
Агенты делают много запросов подряд. Claude Code, OpenCode, Cline и подобные на одну вашу просьбу могут сделать 10–40 запросов (прочитать файл, запустить команду, поправить, проверить), и каждый раз уходит весь контекст.
Системный промпт и инструменты. У Claude Code это около 30.000 токенов в каждом запросе, у OpenCode около 5.000. Каждый подключённый MCP-сервер добавляет свои описания.
Большие файлы и вывод команд. Прочитанный файл или длинный лог остаются в контексте до конца сессии и пересылаются снова и снова.
Кэш не бесплатный. «Вход (кэш)» ускоряет ответ, но списывается так же, как обычный вход.
Мышление и коэффициент. Высокий уровень мышления даёт много выходных токенов, а мощные модели умножают расход на большой коэффициент.

Как экономить: начинайте новую сессию под каждую задачу, просите точечные правки вместо переписывания файлов, отключайте лишние инструменты и MCP, держите уровень мышления на medium, а для простых задач берите модель с маленьким коэффициентом. Точную картину по каждому запросу показывает «История списаний» в личном кабинете.

Что такое «вход (кэш)»?

Это часть входных токенов, которую провайдер прочитал или записал в кэш: обычно повторяющийся контекст (системный промпт, начало чата). Он обрабатывается быстрее. На нашем сервисе такие токены считаются как обычный вход, то есть без скидки. В кабинете вы видите их отдельным числом: «вход + вход (кэш) + выход».

Почему «Insufficient quota for this request», хотя токены ещё остались?

Перед отправкой мы грубо оцениваем стоимость запроса: размер текста плюс запас на ответ, умноженное на коэффициент. Если остаток меньше этой оценки, запрос отклоняется заранее, чтобы не уйти в минус. Это бывает при большом контексте и дорогой модели.

Что сделать: пополнить ключ, начать новую сессию с коротким контекстом или выбрать модель с меньшим коэффициентом.

Какие форматы и возможности поддерживаются?

Anthropic Messages (/v1/messages) и OpenAI Chat Completions (/v1/chat/completions), стриминг, вызов инструментов, картинки на моделях, которые их понимают. Формат Responses API не поддерживается.

Сколько стоят картинки?

Картинка превращается во входные токены (обычно одна-две тысячи) и, как и текст, пересылается с каждым следующим сообщением чата, пока остаётся в истории. Чем больше картинок в сессии, тем больше расход.

Списываются ли токены, если я оборвал запрос?

Да, за ту часть, которую модель успела обработать и отправить. Дальнейшая генерация останавливается.

Как посмотреть остаток и расход?

В личном кабинете: баланс, график расхода по часам и дням, расход по моделям, история каждого списания и отчёт с советами. Там же есть «Нейростудия» для проверки моделей прямо на сайте.

Можно ли дать ключ другу или приложению?

Лучше создать дополнительный ключ в личном кабинете: у него свой лимит токенов, расход идёт с вашего баланса, а выключить или удалить его можно одним нажатием. Основной ключ при этом остаётся только у вас.

Ключ утёк. Что делать?

Если утёк дополнительный ключ, удалите его в кабинете. Если основной, напишите продавцу на FunPay: ключ заменят. Чтобы такого не случалось, используйте в приложениях и расширениях дополнительные ключи с небольшим лимитом.

Нужен ли VPN?

Нет. Сервис работает на сервере в России, подключаться можно напрямую, без VPN.

Как пополнить ключ и получить бонус?

Кнопка «Пополнить ключ» в кабинете ведёт на FunPay (ожидание обычно 2–6 часов). Бонусные токены дают промокоды и реферальный код: введите код друга в поле «Промокод», и оба получите бонус.

Не нашли ответ? Напишите продавцу на FunPay.