Модели и цены
Каталог отдаётся эндпоинтом GET /v1/models. Ключ для него не нужен — можно дёргать из фронтенда, чтобы показать пользователю актуальный список.
curl https://api.mixen.ai/v1/modelsВ каталоге около сотни моделей всех модальностей. Состав и цены меняются — читайте их из API, а не из этой страницы.
Формат ответа
Заголовок раздела «Формат ответа»{ "object": "list", "data": [ { "id": "anthropic/claude-opus-4.8", "object": "model", "owned_by": "mixen", "type": "text", "display_name": "Claude Opus 4.8", "pricing": { "prompt_rub": 527.6, "completion_rub": 2637.8, "prompt_usd": 6.0, "completion_usd": 30.0, "currency_note": "per 1M tokens" }, "capabilities": { "vision": true, "file": true, "reasoning": true, "reasoning_efforts": ["low", "medium", "high", "xhigh", "max"], "can_disable_reasoning": true } } ]}Поле type определяет, какой эндпоинт принимает эту модель:
type |
Эндпоинт | Единица цены |
|---|---|---|
text |
/chat/completions |
за 1 млн токенов |
search |
/chat/completions |
за 1 млн токенов |
image |
/images/generations, /images/edits |
за изображение |
video |
/videos |
за секунду видео |
music |
/audio/music |
за запрос |
tts |
/audio/speech |
за 1000 символов входа |
stt |
/audio/transcriptions |
за минуту аудио |
embeddings |
/embeddings |
за 1 млн входных токенов |
Единица всегда подписана в pricing.currency_note, так что клиенту не нужно её угадывать по типу модели.
У картиночных и видеомоделей приходят дополнительные поля с допустимыми значениями: aspect_ratios, resolutions, sizes, seconds, references (сколько картинок-образцов принимает модель). Не угадывайте их — читайте из каталога, иначе получите 400. У моделей синтеза речи есть поле voices со списком голосов.
Как называть модель в запросе
Заголовок раздела «Как называть модель в запросе»В поле model принимается:
- полный идентификатор из каталога —
openai/gpt-5.6-luna; - короткий суффикс —
gpt-5.6-luna; - привычный псевдоним чужого вендора —
gpt-4o,claude-opus,dall-e-3,gpt-image-1,whisper-1,tts-1,text-embedding-3-small,sora-2.
Псевдонимы существуют ради drop-in замены: код, написанный под OpenAI, работает без правок и попадает на сопоставимую по классу модель Mixen. Если модель не найдена, ответ — 404 с перечислением похожих идентификаторов.
Как считается цена
Заголовок раздела «Как считается цена»Рублёвая цена не статична, она пересчитывается от закупочной цены апстрима:
цена ₽ = закупка $ × курс USD/RUB × (1 + маржа)Курс берётся из живой котировки и обновляется автоматически, поэтому prompt_rub сегодня и через неделю могут отличаться при неизменной prompt_usd. Списывается ровно то, что показано в каталоге на момент запроса, — никаких скрытых коэффициентов.
Списание идёт с баланса Mixen, единого для бота, кабинета и API.
Витрина
Заголовок раздела «Витрина»Человекочитаемый каталог с фильтрами, описаниями и примерами работ — api.mixen.ai/models. Там же указано, какие модели видят изображения, принимают файлы и поддерживают режимы рассуждения.