Частые вопросы

Ответы на вопросы, которые чаще всего возникают при подключении к Mixen API. Если ответа здесь нет — посмотрите Ошибки, лимиты, биллинг или справочник API.

Начало работы

Чем Mixen отличается от OpenAI API?

На уровне протокола — ничем: формат запросов и ответов, включая конверт ошибок, повторяет OpenAI, официальные SDK работают после замены base_url и ключа. Отличия вокруг: один ключ на текст, изображения, видео, музыку, речь и эмбеддинги и оплата в рублях с единого баланса. Смотрите Быстрый старт.

Нужен ли отдельный ключ для каждого приложения?

Отдельный аккаунт не нужен: все ключи принадлежат одному аккаунту и списывают с одного баланса. Практичнее выпустить свой ключ на каждое приложение и окружение, ограничив его области доступа, — тогда отзыв или утечка одного ключа не задевает остальные. Лимит запросов считается на ключ, так что несколько ключей дают больше параллелизма. Подробнее — Ключи и аутентификация.

Работает ли API без VPN и зарубежных аккаунтов?

Да. Доступ из России прямой, аккаунты OpenAI, Google или Anthropic не нужны: ключ выпускается в кабинете Mixen, оплата идёт в рублях.

Через что идут запросы и не отвалится ли ключ?

Только через официальные API — по тарифам и правилам вендоров. Пулы потребительских подписок ChatGPT и Claude мы не используем: OpenAI и Anthropic запрещают их в сторонних сервисах (Anthropic с апреля 2026 блокирует технически) и отключают волнами — вместе с ключами всех, кто на них построен. Ключ Mixen работает, пока на балансе есть средства; при сбое провайдера запрос уходит на резервный апстрим, см. Маршрутизация провайдеров.

Модели и запросы

Как правильно указывать модель?

Любой из трёх способов: полный идентификатор из каталога (openai/gpt-5.6-luna), короткий суффикс (gpt-5.6-luna) или привычный псевдоним чужого вендора (gpt-4o, claude-opus, dall-e-3, sora-2, whisper-1, tts-1). Псевдоним ведёт на сопоставимую по классу модель Mixen. Подробнее — Модели и цены.

Почему запрос возвращает 404 model_not_found?

Модели с таким именем нет: опечатка либо модель убрана из каталога. Псевдонимы резолвятся против живого каталога — если модель-цель неактивна, псевдоним тоже не сработает. Источник истины — GET /v1/models.

Сколько запросов в минуту можно делать?

60 на ключ, фиксированное окно в 60 секунд: счётчик сбрасывается раз в минуту. При превышении приходит 429 с заголовками retry-after и x-ratelimit-limit-requests; официальные SDK делают backoff сами. Лимит считается на ключ, а не на аккаунт. Подробнее — Ошибки, лимиты, биллинг.

Почему ответ оборвался на середине?

Это finish_reason: "length": генерация упёрлась в потолок max_tokens (синоним — max_completion_tokens). Частая причина заниженного потолка — включённое рассуждение, которое ест тот же бюджет. Поднимите лимит или отключите рассуждение, если модель это умеет. Подробнее — Чат и стриминг.

Контекст и кэш

Можно ли прислать в запрос картинку или файл?

Да. Модели с vision принимают картинку как data:-URL в последнем сообщении пользователя, модели с file — до 5 файлов на запрос (PDF, DOCX, TXT, CSV, XLSX, PPTX), из каждого извлекается до 150 000 символов. Модели без нужной возможности вернут 400 — проверяйте флаги в каталоге заранее. Подробнее — Чат и стриминг.

Как экономить на повторяющемся контексте?

Кэшируйте повторяющийся префикс. В /v1/chat/completions и /v1/responses кэш срабатывает автоматически, в /v1/messages брейкпоинты cache_control расставляет клиент — Claude Code и Anthropic SDK делают это сами. Кэш живёт 5 минут со скользящим продлением, повторный контекст стоит около 10% цены входа. Подробнее — Кэширование контекста.

Стриминг и инструменты

Работает ли стриминг?

Да, во всех трёх чат-протоколах: /v1/chat/completions, /v1/messages и /v1/responses. Ответ идёт по SSE и завершается строкой data: [DONE]; с stream_options: {"include_usage": true} перед ней придёт чанк с расходом токенов.

Поддерживается ли function calling?

Да. tools и tool_choice в формате OpenAI передаются модели как есть, а на вход принимаются сообщения role: "tool" с результатами вызовов — агентный цикл собирается без переписывания клиента.

Как управлять рассуждениями модели?

В /chat/completions и /responses — параметром reasoning_effort (от off до max), в /v1/messages — через thinking.budget_tokens. Допустимые значения приходят в capabilities.reasoning_efforts, возможность отключения — в can_disable_reasoning; бюджет рассуждения ест max_tokens. Подробнее — Чат и стриминг.

Биллинг

Когда списываются деньги?

По факту выполнения: списание считается по токенам из usage ответа. Неудачная генерация не оплачивается, а если стрим оборвался и финальный чанк с usage не пришёл, списание пропускается. Подробнее — Токены и списания и Ошибки, лимиты, биллинг.

Что показывает cached_tokens?

Сколько входных токенов пришло из кэша контекста. Скидка уже учтена в списании, а prompt_tokens по семантике OpenAI включает кэшированную часть — поле нужно, чтобы видеть экономию, а не пересчитывать цену. Подробнее — Кэширование контекста.

Где смотреть историю запросов и расходы?

В кабинете, в разделе «История» — mixen.ai/account/history: модель, статус, токены и списание в рублях и долларах по каждому запросу, отдельной вкладкой — история платежей.