FAQ
Ниже собраны ответы на вопросы, которые чаще всего возникают при подключении OdiRouter и работе с моделями. Если вы не нашли ответ здесь, обратитесь в поддержку.
Начало работы
Заголовок раздела «Начало работы»OdiRouter предоставляет единый API, который помогает разработчикам подключать разные возможности ИИ-моделей, включая мультимодальные модели для текста, изображений, видео и аудио, а также передовые LLM. С одним API-ключом, единым базовым URL и единым способом вызова можно управлять разными моделями и сократить затраты на интеграцию. Кроме того, OdiRouter объединяет вызовы моделей, выполнение задач, биллинг и управление использованием на одной платформе. Вы можете в одном месте смотреть цены моделей, способы вызова и статистику использования, а затем выбирать подходящую модель для конкретного сценария без отдельной интеграции с несколькими провайдерами.
Сначала зарегистрируйтесь и войдите в OdiRouter, затем создайте API-ключ и пополните баланс аккаунта. Баланс используется для оплаты последующих вызовов моделей. Чтобы начать вызовы, настройте OdiRouter API-ключ, базовый URL и эндпоинт модели. Для LLM можно использовать совместимый с OpenAI способ вызова. Для мультимодальных моделей создайте задачу через соответствующую API-задачу, проверяйте статус и получите результат. Способ тарификации и требования к параметрам каждой модели доступны на странице цен моделей и в API-документации.
Модели и провайдеры
Заголовок раздела «Модели и провайдеры»OdiRouter постоянно обновляет список моделей и подключает новые LLM и мультимодальные модели. Частота добавления зависит от доступности моделей, стабильности, стоимости, потребностей пользователей и обновлений апстрим-возможностей. Текущие поддерживаемые модели можно посмотреть в списке моделей. Если вам нужна модель, которой пока нет на платформе, обратитесь в поддержку и сообщите о потребности.
free в каталоге моделей. При вызове таких моделей используйте эндпоинт с префиксом free. Для бесплатных моделей действует лимит до 100 запросов в день.Если для одной и той же модели в текущем способе вызова настроено несколько доступных каналов провайдеров, при сбое одного канала OdiRouter попытается выбрать другой доступный канал и продолжить запрос. Сейчас платформа поддерживает только умную маршрутизацию. Пользователь не может вручную переключать провайдера, а пользовательские ошибки, такие как недостаточный баланс или неверные параметры, не запускают переключение провайдера.
Цены и кредиты
Заголовок раздела «Цены и кредиты»Расход кредитов можно посмотреть на странице деталей использования. Она показывает количество запросов, использование токенов и расход кредитов за выбранный период, а в деталях перечисляет продукт, количество, единицу тарификации и стоимость каждого вызова.
OdiRouter использует схему тарификации «предварительное списание перед запросом, затем доплата или возврат после завершения по фактической стоимости». Для изображений, видео, аудио и моделей с фиксированной ценой, если сумма предварительного списания уже превышает текущий баланс, запрос блокируется на этапе предварительного списания. Для LLM-запросов, если предварительная оценка стоимости уже превышает баланс, запрос также блокируется. Важно учитывать, что итоговое количество выходных токенов в LLM-запросе нельзя полностью определить заранее. Если фактическая стоимость окажется выше баланса, баланс кошелька может стать отрицательным и текущий запрос все равно может успешно завершиться, но следующий запрос будет отклонен из-за недостаточного баланса.
В большинстве случаев, если запрос не завершился успешно, предварительно списанная сумма возвращается и стандартная плата за вызов модели не взимается. Для обычных синхронных вызовов итоговая ошибка обычно приводит к возврату предсписания. Для асинхронных мультимодальных задач сумма задачи также возвращается, если задача в итоге завершилась ошибкой. Для потоковых вызовов, если модель уже начала возвращать содержимое, возможна частичная оплата на основе уже сгенерированного контента или использования от апстрима, даже если клиент отключился в середине. Кроме того, если включена отдельная политика списаний за нарушения безопасности контента, некоторые нарушающие запросы могут привести к отдельной плате.
Обычно баланс обновляется сразу после подтверждения платежа. Если баланс не обновился в течение 10 минут, обратитесь в поддержку и укажите номер заказа.
Поддерживаются банковские карты MIR, Т-Банк, Сбербанк и система быстрых платежей (СБП). Фактически доступные способы зависят от того, что отображается на странице оплаты.
Итоговая сумма платежа и возможные комиссии отображаются на внешней странице оплаты. Внимательно проверьте их перед подтверждением платежа.
Платежные данные вводятся и обрабатываются на защищенной странице платежного провайдера. OdiRouter не запрашивает и не хранит данные вашей банковской карты.
Вызовы и лимиты
Заголовок раздела «Вызовы и лимиты»После завершения мультимодальной задачи OdiRouter сохраняет сгенерированные изображения, видео, аудио или файлы в хранилище платформы и возвращает доступные ссылки на результат в ответе API. При запросе статуса и результата задачи нужно использовать API-ключ. Система проверяет принадлежность задачи, чтобы другие пользователи не могли прочитать ваши результаты через API-задачу. Обратите внимание: возвращаемые ссылки сейчас по умолчанию действуют 7 дней. Любой, у кого есть ссылка, может получить доступ к медиафайлу в течение срока действия ссылки, поэтому не публикуйте такие ссылки для недоверенных получателей.
Мультимодальные API OdiRouter обычно поддерживают два способа передачи файлов: File URL: разместите изображение, видео, аудио или другой файл по публично доступному HTTP/HTTPS URL, затем передайте этот URL в параметре запроса. Base64-энкодинг: некоторые модели поддерживают прямую передачу Base64-энкодинга контента. Требуемый формат зависит от модели: одним нужен чистый энкодинг Base64, другие поддерживают формат Data URL. Поддерживаемые способы загрузки, форматы файлов, ограничения размера и названия параметров отличаются от модели к модели. Перед вызовом сверяйтесь с API Reference соответствующей модели.
POST /v1/chat/completionsPOST /v1/messagesPOST /v1/responsesАсинхронные мультимодальные задачи используют очередь API:POST /model/v1/queue/:endpointGET /model/v1/queue/:endpoint/requests/:request_id/statusGET /model/v1/queue/:endpoint/requests/:request_id/responseКакой эндпоинт нужен конкретной модели, смотрите на странице соответствующей модели.Да, это зависит от модели и типа API. Для текстовых API, таких как Chat Completions, Messages и Responses, стриминг обычно можно включить, установив stream в true. После включения стриминга вывод модели возвращается постепенно через SSE, что подходит для чатов, генерации в реальном времени и снижения времени до первого ответа. Асинхронные мультимодальные очереди не используют SSE для статуса задач. Для мультимодальных задач сначала отправьте задачу, затем запрашивайте статус и после завершения получите ответ. Важно: после начала стриминг-ответа нельзя бесшовно переключиться на другого провайдера и продолжить тот же вывод. Повторные попытки по провайдерам обычно происходят до установки стриминг-соединения.
Для пользователей без пополнения баланса:
- Бесплатные модели: суммарно до 50 вызовов в день (лимит сбрасывается в 00:00 UTC), RPM для LLM — 5, лимит параллельных мультимодальных запросов — 2.
- Платные модели: без ограничения по количеству вызовов, RPM для LLM — 5, лимит параллельных мультимодальных запросов — 2.
Для пользователей, пополнивших баланс:
- Бесплатные модели: суммарно до 100 вызовов в день (лимит сбрасывается в 00:00 UTC), RPM для LLM — 100, лимит параллельных мультимодальных запросов — 10.
- Платные модели: без ограничения по количеству вызовов, RPM для LLM — 100, лимит параллельных мультимодальных запросов — 10.
Интеграции
Заголовок раздела «Интеграции»OdiRouter поддерживает совместимую с OpenAI интеграцию. Обычно любой SDK, который позволяет задать собственные API-ключ и базовый URL, можно использовать с OdiRouter.