Частые вопросы (FAQ)
Короткие ответы на типовые вопросы по работе с MegaAPI.ru. Не нашли своё — напишите в @megaapibot или на support@megaapi.ru.
Баланс и оплата
Как пополнить баланс?
Оплата только в USDT (сети TON / TRC-20 / ERC-20) через Telegram-бота
@megaapibot (CryptoBot). Никаких
зарубежных карт, SWIFT и риска блокировки. Баланс зачисляется сразу после оплаты, срока
годности у него нет. Бонусы за объём пополнения — на странице
Бонусы за пополнение.
Есть баланс, но запрос падает с ошибкой нехватки средств — почему?
Действует механизм предсписания: в момент отправки запроса резервируется
оценочная стоимость. Если текущего баланса не хватает на эту оценку — запрос отклоняется,
даже когда деньги на счёте ещё есть. Особенно заметно на длинном контексте и больших
max_tokens (оценка выше). Решение: пополнить баланс или уменьшить
max_tokens / объём контекста. Фактическое списание после ответа — по реальным токенам.
Как отслеживать расход и не уйти в ноль?
Текущий баланс, история операций и журнал запросов видны в личном кабинете
и в модалке «Настройки» внутри Студии. Уведомления (в т.ч. дублируются
в Telegram) приходят на колокольчик. Программно баланс можно проверить через API — см.
Проверка баланса.
Почему цена отличается от «официальной» цены провайдера?
Все цены в каталоге указаны финальные — уже с нашей
наценкой и в долларах. Никаких скрытых «коэффициентов»: смотрите колонку с ценой за 1M токенов
(или за изображение/секунду видео) — это ровно то, что спишется. Биллинг прозрачный:
списываем по факту использования после каждого запроса.
Ключи и доступ
Где взять API-ключ?
Ключ вида
sk-nexus-... выдаёт Telegram-бот
@megaapibot, управлять ключами можно в
личном кабинете. Подробнее — на странице API-ключи.
Ошибка «API Key invalid» — что проверить?
Чаще всего дело в
base_url или ключе:
- Base URL должен быть
https://megaapi.ru/v1(для OpenAI-совместимого режима). - Ключ передаётся как
Authorization: Bearer sk-nexus-...(для нативного Claude —x-api-key, для Gemini —x-goog-api-key). - Не должно быть лишних пробелов и переносов; ключ скопирован целиком.
Какой Base URL указывать?
- OpenAI-совместимый (большинство SDK/клиентов):
https://megaapi.ru/v1 - Claude нативный (anthropic SDK):
https://megaapi.ru(SDK сам добавит/v1/messages) - Gemini нативный (google-genai):
https://megaapi.ru, эндпоинт/v1beta/...
Модели и лимиты
Сколько одновременных запросов (конкурентность) можно слать?
Лимит зависит от типа модели: у текстовых моделей конкурентность самая высокая, у генерации
изображений/видео — умереннее (тяжёлые задачи). Для обычной интеграции встроенных лимитов
с запасом хватает. Если планируете высокий поток — напишите в поддержку, обсудим расширение.
Что такое max_tokens и что будет, если его не задать?
max_tokens ограничивает длину ответа модели. Мы не накладываем на него
дополнительных ограничений — параметр передаётся модели как есть. Не задали — используется
дефолт модели. Если ответ обрывается, проверьте finish_reason: значение
length означает упор в max_tokens — увеличьте лимит.
Как выбрать подходящую модель?
Ориентир по задачам — в Текстовой генерации
(диалог/код/креатив/перевод) и в Генерации изображений.
Полный каталог с ценами и тегами — Модели и цены. Универсальный
совет: начните с дешёвой/быстрой модели, переходите на флагман только там, где не хватает качества.
Почему какая-то модель недоступна (ошибка 503 / no channel)?
Это значит, что конкретная модель временно недоступна на стороне апстрима, а не проблема
вашего ключа. В каталоге отображаются реально подключённые модели. Если нужная модель отдаёт
503 — попробуйте позже или выберите аналог того же класса. О стабильно мёртвых
моделях мы своевременно убираем из каталога.
Поддерживается ли кэширование (cache billing)?
Да. Параметры кэша передаются апстриму как есть, поля попадания возвращаются в ответе, в счёте
кэш-чтение идёт по сниженному тарифу. Стабильнее всего кэш у Claude и
OpenAI; у Gemini кэш неявный и попадает не всегда — бюджет считайте по цене
без кэша. Подробности — на странице Кэширование промпта.
Почему модель неверно называет свою версию?
Это нормально и не влияет на качество. Модель не «знает» своего имени — оно присваивается уже
после обучения. На официальных веб-версиях правильный ответ обеспечивает скрытый системный
промпт; при вызове через API его по умолчанию нет, поэтому модель может «угадать» версию неверно.
Ориентируйтесь на параметр
model, который вы отправили, а не на самоописание модели.
Безопасность и данные
Что с безопасностью данных? Сохраняете ли вы мои запросы?
Трафик идёт по HTTPS. Мы работаем в режиме прозрачной передачи к апстриму и не торгуем вашими
данными. История диалогов и файлы в Студии хранятся в вашем аккаунте и автоматически удаляются
по ретеншну (файлы — 30 дней). Доступ к данным аккаунта — только у вас по ключу/сессии.
Нужен ли VPN для доступа к зарубежным моделям?
Нет. Все запросы идут через наши серверы, поэтому модели OpenAI, Anthropic, Google, xAI и др.
доступны из России и других стран без VPN и зарубежных карт. Оплата — в USDT через Telegram.
Технические вопросы
Есть ли асинхронный API для картинок (задача по ID)?
Для изображений вызов синхронный: запрос держит соединение, ждёт генерацию и
возвращает результат. Отдельного «получить картинку по task ID позже» нет. Ставьте разумный
timeout и держите соединение; результат сохраняйте у себя. (Для видео — наоборот,
используется асинхронный submit→poll→download, см. Генерация видео.)
Ссылка на сгенерированную картинку/видео перестала открываться
Прямые ссылки на результаты у провайдеров временные (у части моделей — минуты). Мы сразу
пересохраняем результат у себя и кладём в историю Студии (30 дней) — пользуйтесь стабильным URL
из истории, а не исходной ссылкой провайдера.
Скачивание результата идёт медленно
Медиа раздаются через глобальный CDN. Низкая скорость почти всегда — это особенности сетевого
маршрута от вашего сервера до ближайшего узла CDN (трансграничный канал, маршрут оператора,
локальный DNS), а не сам CDN. Помогает: качать с сервера в подходящем регионе, проверить DNS,
повторить попытку.
Где смотреть журнал вызовов и детали списаний?
В личном кабинете и в модалке «Настройки» внутри
Студии: история запросов, израсходованные токены и суммы списаний по каждой операции.