OneMux/Документация/Часто задаваемые вопросы

Часто задаваемые вопросы

Возникла ошибка при вызове API? Быстро найдите причину по коду состояния. На этой странице перечислены наиболее распространённые коды ошибок и способы их устранения; большинство проблем можно решить самостоятельно менее чем за 1 минуту.

Быстрая диагностика

При возникновении ошибки сначала найдите HTTP-код состояния (например, 401 или 429), а затем выполните соответствующие действия:

Код состоянияПричинаРешение
401Недействительный API KeyПроверьте формат ключа (sk-xxx) и его действительность
402Недостаточно средствПополните баланс в консоли
404Неверный ID моделиСкопируйте правильный ID со страницы модели
429Слишком частые запросыСнизьте частоту и повторите попытку через 10 секунд
500Сбой вышестоящего сервисаПовторите попытку позже или переключитесь на другую модель

401 - Недействительный API Key

Наиболее распространённые причины:

  • При копировании добавились пробелы
  • Неверный формат (не начинается с sk-)
  • Ключ был удалён

Быстрое решение:

# ✅ 正确格式
api_key = "sk-1234567890abcdef"

# ❌ 常见错误
api_key = " sk-1234567890abcdef "  # 前后有空格
api_key = "1234567890abcdef"       # 缺少 sk- 前缀

Перейдите в консоль, чтобы повторно скопировать ключ или создать новый.

402 - Недостаточно средств

На балансе аккаунта недостаточно средств для оплаты этого запроса.

Пополните баланс в центре расходов.

Примечание: для запросов с большим контекстом (например, при обработке Gemini 1 миллиона tokens) предварительно резервируется максимально возможная сумма. Убедитесь, что на балансе достаточно средств.

404 - Модель не существует

Распространённые причины:

  • Ошибка в написании ID модели
  • Используется устаревшее название модели (например, gpt-4o заменено на gpt-6.1-sol)
  • Неверный путь Base URL

Решение:

Получение правильного ID модели

  1. 1

    Откройте страницу моделей

    Откройте https://onemux.net/models

  2. 2

    Найдите нужную модель

    Найдите нужную модель с помощью поиска или просмотра списка

  3. 3

    Скопируйте ID модели

    Нажмите кнопку копирования или вручную скопируйте полный ID

Убедитесь, что Base URL имеет значение https://api.onemux.net/v1 (обратите внимание на /v1 в конце)

429 - Слишком частые запросы

За короткий промежуток времени отправлено слишком много запросов, сработало ограничение частоты.

Решение:

  • Снизьте частоту запросов
  • Подождите 10-30 секунд и повторите попытку
  • Добавьте логику автоматического повтора (см. документацию по обработке ошибок)
  • Уменьшите количество параллельных задач

500/502/503 - Сбой сервиса

Вышестоящий сервис модели временно недоступен.

Решение:

  • Подождите 10-30 секунд и повторите попытку
  • Переключитесь на другую модель
  • Проверьте страницу состояния, чтобы узнать состояние сервиса

Порядок диагностики при неопределённой проблеме

Пошаговая диагностика

  1. 1

    Проверьте баланс

    Войдите в консоль и убедитесь, что на балансе достаточно средств

  2. 2

    Проверьте API Key

    Повторно скопируйте полный ключ и убедитесь, что в нём нет пробелов

  3. 3

    Проверьте ID модели

    Повторно скопируйте его со страницы модели

  4. 4

    Проверьте Base URL

    Убедитесь, что указано https://api.onemux.net/v1

  5. 5

    Перезапустите программу

    Сохраните конфигурацию и перезапустите клиент