Частые вопросы (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).
  • Не должно быть лишних пробелов и переносов; ключ скопирован целиком.
Базовые точки доступа сведены в справочнике API.
Какой 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, повторить попытку.
Где смотреть журнал вызовов и детали списаний?
В личном кабинете и в модалке «Настройки» внутри Студии: история запросов, израсходованные токены и суммы списаний по каждой операции.

Задать вопрос в Telegram → Модели и цены Быстрый старт