Moneo

API Moneo

OpenAI-compatible API для доступа к моделям ИИ через Moneo.

Base URL

https://api.moneo.one/v1

Авторизация

Передавай API-ключ Moneo как Bearer-токен. API-ключи начинаются с sk-moneo-.

Authorization: Bearer $MONEO_API_KEY

Храни API-ключ в переменной окружения или защищённом хранилище программы. Не добавляй его в код проекта и Git.

Endpoint

Получить список моделей

curl https://api.moneo.one/v1/models

Публичный endpoint возвращает доступные ID моделей, размер контекста, возможности, цены входных и выходных токенов и статус availability. Для запросов к моделям используй записи со значением available.

Отправить запрос к модели

curl https://api.moneo.one/v1/chat/completions \
  -H "Authorization: Bearer $MONEO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"deepseek-v4-flash:web","messages":[{"role":"user","content":"Reply with OK"}]}'

Endpoint принимает запросы в формате OpenAI Chat Completions. Для обычного JSON-ответа используй запрос без stream или со значением false. Для streaming через server-sent events передай "stream": true.

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

curl https://api.moneo.one/v1/balance \
  -H "Authorization: Bearer $MONEO_API_KEY"

Endpoint возвращает доступный баланс, расходы и лимит этого API-ключа, процент использования и признак предупреждения. Ответ не кэшируется.

Совместимость с Chat Completions

Moneo принимает стандартные роли сообщений, streaming, tools, tool_choice, параллельные вызовы инструментов, JSON response formats, ограничения токенов, параметры генерации и поля reasoning.

Поддержка отдельных возможностей зависит от выбранной модели. Проверяй поля capabilities, has_web, has_vision, has_tools и has_reasoning в ответе GET /v1/models.

Перегрузка модели

Если модель временно не отвечает, API возвращает ошибку в формате OpenAI с HTTP-статусом 429, кодом model_overloaded и заголовком Retry-After. Повтори запрос через указанное количество секунд. Некоторые OpenAI-compatible клиенты делают это автоматически.

Списание при ошибке

Перед обращением к модели Moneo резервирует стоимость запроса. Если ответ не получен, зарезервированная сумма возвращается автоматически. Если после ошибки баланс всё же уменьшился, не повторяй запрос несколько раз подряд - обратись в поддержку и укажи время запроса, модель и X-Request-Id, если ты его передавал. API-ключ отправлять не нужно.

Подключить OpenCode

Через встроенный provider

  1. Подключить Moneo

    Выполни /connect, выбери Moneo и вставь API-ключ.

  2. Выбрать модель

    Выполни /models и выбери доступную модель Moneo.

API-ключ также можно передать через переменную окружения MONEO_API_KEY перед запуском OpenCode. Способ подключения одинаков для Windows, macOS и Linux.

Если Moneo нет в списке provider твоей версии OpenCode, используй ручную настройку на странице подключения.

Поддержка

Если API возвращает ошибку или баланс изменился после запроса без ответа, напиши в Telegram-бот Moneo.

Укажи время запроса, модель, HTTP-статус и X-Request-Id, если передавал его. Не отправляй API-ключ, Bearer-токен и содержимое приватных запросов.