Meta Muse API: что разработчик на самом деле получает и какие модели Muse обслуживает

Нет продукта, буквально называющегося Muse API. API, обслуживающий модели Muse от Meta, — это Meta Model API, он отвечает по адресу https://api.meta.ai/v1, а модели Muse, которые разработчик может на нём вызывать, — это Muse Spark 1.3 (та, которую Meta сейчас рекомендует), Muse Spark 1.2 и Muse Spark 1.1 — последние две из них этот сайт маршрутизирует как meta/muse-spark-1.1 и meta/muse-spark-1.2. Если вы искали "muse api" в надежде получить ответ в одну строку, вот он. Остальная часть этой страницы — подробности, стоящие за этим: сколько стоит каждая модель за миллион токенов по опубликованному тарифному листу Meta, что нужно иметь под рукой перед первым вызовом, к чему на самом деле привязан лимит частоты запросов, и почему цифры на карточке подписки Muse Code не переносятся на счёт за API.

Читайте это как справочную страницу, а не как новость. Meta Model API работает, и модели Muse на нём можно вызывать уже сегодня; здесь нет никакого анонса, и ни одна страница этого блога ранее не отвечала на вопрос о программном доступе для этой линейки моделей. Там, где показатель взят из собственной документации Meta, эта страница об этом сообщает, а там, где Meta ничего не публикует, страница говорит именно это вместо того, чтобы заполнять пустоту.

Что на самом деле представляет собой «Meta Muse API»

Собственное определение Meta состоит из одного предложения: Model API — это «платформа инференса для новейших моделей от Meta, включая Muse Wonder и Muse Spark». Линейка Muse размещена на этой платформе, а не на собственном API, поэтому поиск эндпоинта, специфичного для Muse, ни к чему не приводит — эндпоинт принадлежит Meta, и Muse — это одно семейство моделей на ней.

Поверхность намеренно сделана обычной. В рамках того, что Meta называет поверхностями Model API, документированы три формата запросов: Responses API, Chat Completions API и Messages API. Главное заявление об интеграции состоит в том, что Model API «совместим без доработок с O​penAI SDK, A​nthropic SDK и O​penAI-совместимыми CLI для агентов», а сопровождающая его фраза гласит: «не нужно изучать специализированный клиент». На практике это означает смену базового URL и ключ, а не переписывание.

Платформа обслуживает не только линейку Spark. Наряду с muse-spark-* она предоставляет muse-wonder-1.0, muse-image-1.0, muse-voice-transcribe-1.0 и sam-3.1, поэтому читатель, собирающий смешанный конвейер, может получить доступ к генерации изображений, транскрипции и сегментации с одними и теми же учётными данными. Один представитель семейства Muse вообще недоступен для вызова: Muse Glimmer — это модель с открытыми весами, «созданная для запуска на вашем собственном оборудовании», распространяемая в виде весов, а не обслуживаемая через API, и Meta исключает её из эндпоинта списка моделей. Если ваш вопрос — «можно ли вызвать Glimmer», ответ — нет: вы её скачиваете.

Две вещи, которые люди обычно включают в «Muse API», — это отдельные продукты, и им место на других страницах. Muse Code — это агент Meta для написания кода, предназначенный для терминала и CI: инструмент-обвязка (harness), продающаяся по подписке, выпущенная в статусе беты 5 августа 2026 года и выведенная из беты 31 августа 2026 года, — и это не API, не модель и не что-то обязательное для вызова API. Страница muse-code в этом блоге посвящена обвязке, а meta-muse-code-terminal-coding-agent подробно описывает самого агента. Далее здесь речь пойдёт только о программном интерфейсе.

Модели, которые вы можете вызвать, и опубликованные тарифы Meta

Для генерации текста важны шесть идентификаторов, а приведённые ниже тарифы — это собственные расценки Meta, опубликованные на её странице цен и ограничений скорости в долларах за миллион токенов. Это списочные цены поставщика, а не независимо проверенные показатели.

• muse-spark-1.3 — Meta называет её «последней версией, оптимизированной для агентных рабочих процессов» и помечает как «Рекомендуется для новых проектов». Контекст — 1 048 576 токенов. Стандартный режим: $1,25 за вход, $4,25 за выход, $0,15 за кэшированный вход.

• muse-spark-1.2 — На странице моделей Meta она прямо описывается как «предыдущая версия». Тот же контекст на 1,048,576 токенов, те же тарифы Standard.

• muse-spark-1.1 — «оригинальная версия», и только в режиме Standard. То же контекстное окно, снова те же тарифы Standard.

• muse-spark-1.3-contributor и muse-spark-1.2-contributor — тариф со скидкой: $0.10 за ввод, $0.20 за вывод, $0.002 за кэшированный ввод. Варианта Contributor для версии 1.1 не существует.

• muse-wonder-1.0 — самая мощная модель Muse от Meta, ориентированная на длительную агентную работу: $4,00 за ввод, $20,00 за вывод, $0,20 за кэшированный ввод, только в режиме Standard, и Meta прямо заявляет, что «режим Contributor недоступен для Muse Wonder в Model API».

• Нетекстовые модели Muse тарифицируются за единицу, а не за токен: Muse Image — $0,01 за изображение, Muse Voice Transcribe — $0,18 за час, SAM 3.1 — $2,50 за 1 000 изображений и $0,20 за 1 000 кадров. Функция опоры на веб-поиск, если её включить, стоит $2,50 за 1 000 поисковых запросов.

Под этой таблицей приведены два общих утверждения, и о них стоит знать, прежде чем подбирать размер рабочей нагрузки. Первое: «Кэшированный ввод стоит меньше» — кэшированные чтения обходятся примерно в одну десятую стоимости ввода в Standard Spark и в одну пятидесятую в Contributor. Второе: «Нет надбавки за длинный контекст», и здесь это важнее, чем на большинстве платформ, потому что окно линейки Spark составляет 1,048,576 токенов; длинный документ не переводит вас на другую цену.

По вопросу, по которому бриф для этой страницы предполагал контраст: между meta/muse-spark-1.1 и meta/muse-spark-1.2 не из чего выбирать ни по окну, ни по тарифу. Meta публикует один показатель контекста для линейки и одну строку тарифа, охватывающую «muse-spark-1.3 / 1.2 / 1.1». Что их отличает — это чекпоинт (1.2 — более поздний), а на платформе Meta — наличие варианта Contributor для 1.2, но не для 1.1. Тот, кто говорит вам, что эти две различаются длиной контекста или ценой, читает не те же карточки.

Что вам понадобится под рукой, чтобы совершить первый звонок

Всё в этом разделе взято из собственной документации Meta. Там, где обычно должно было бы находиться то, о чём Meta не говорит, эта страница оставляет пробел видимым, а не изобретает правдоподобную форму запроса.

Получение доступа

Доступ — это учётная запись Model API плюс ключ. Краткое руководство Meta направляет вас в панель управления: «Получите ключ в панели управления Model API → Ключи API → Создать ключ API». Страница аутентификации добавляет то, что многие упускают: «Скопируйте ключ сразу же. Вы увидите его только один раз». Ключ отображается в формате LLM|607358788350350|nx9.....LJY, и Meta никогда не объясняет, что означают эти сегменты. Вы можете отозвать ключ из той же панели управления — «Удаление одного ключа не затрагивает другие ключи команды» — и это аргумент Meta в пользу выпуска отдельного ключа для каждого приложения, а не совместного использования одного.

Схема аутентификации

Bearer-токен в заголовке Authorization:

• Заголовок — Authorization: Bearer $MODEL_API_KEY

• Базовый URL — https://api.meta.ai/v1, при этом https://api.meta.ai задокументирован для харнессов в формате A​nthropic

• Переменная окружения — MODEL_API_KEY, которую Meta советует задавать, а не прописывать жёстко, вместе с обычным советом «никогда не коммитить ключи в систему контроля версий»

• Оговорка для клиента — Meta прямо заявляет, что «SDK OpenAI не считывает MODEL_API_KEY автоматически», поэтому вам нужно либо явно передать api_key, либо экспортировать OPENAI_API_KEY с вашим ключом Meta

В справочнике Meta упоминаются такие конечные точки, как POST /v1/chat/completions и POST /v1/responses для текста, /v1/images/generations и /v1/images/edits для Muse Image, POST /v1/asr/transcribe, а также websocket в реальном времени по адресу wss://api.meta.ai/v1/asr/realtime для транскрипции, и POST /v1/files для загрузки файлов. Опубликованного SDK от Meta нет: на странице SDK перечислены клиенты OpenAI и Anthropic, и позиция Meta — совместимость, а не библиотека от самой компании. Если вы ждали пакет от Meta, который можно установить, такого пакета нет.

Ограничения частоты запросов и то, относительно чего они измеряются

Вот вопрос, который тот, кто ищет «muse code api key», обычно на самом деле задаёт, и Meta отвечает на него точнее, чем большинство поставщиков. Опубликованные лимиты указаны на команду, а не на ключ: «Ключи в одной команде используют общие лимиты скорости». Два инженера, создающие два ключа, не удваивают потолок — они делят его.

• muse-spark-1.3, muse-spark-1.2, muse-spark-1.1 — 3 000 запросов в минуту и 4 000 000 токенов в минуту

• Варианты Contributor — 150 запросов в минуту и 3 000 000 токенов в минуту

• muse-wonder-1.0 — 3 000 запросов в минуту и 4 000 000 токенов в минуту; muse-image-1.0 — 150 запросов в минуту без ограничения по токенам

• Фоновые ответы — отдельный лимит: 600 отправок в минуту на команду.

• При нарушении — HTTP 429 с заголовком Retry-After и ответы, содержащие x-ratelimit-limit-tokens, x-ratelimit-remaining-tokens, x-ratelimit-limit-requests и x-ratelimit-remaining-requests

API-ключ Muse Code и API-ключ Model — это один и тот же тип учётных данных. При первом запуске Muse Code предлагает выбрать вход через браузер или вставить API-ключ — «Для скриптов и CI используйте API-ключ» — а задокументированный порядок поиска таков: сначала META_API_KEY, затем сохранённый ключ, затем сохранённая сессия браузера, при этом API-ключ всегда имеет приоритет над входом через браузер.

Схема оплаты: тарифицируемые токены, а не место

Это тот раздел, в котором читатели чаще всего ошибаются, поэтому стоит сказать прямо. Подписка Muse Code — это фиксированная месячная плата за место с тарифной сеткой; Model API — это оплата по потреблению на аккаунте. На странице авторизации Meta модель описана напрямую — «Оплата Meta Model API основана на использовании: с вас взимают плату за токены, которые потребляют ваши запросы» — при этом входные и выходные токены считаются отдельно, выходные обычно стоят дороже, а тарифы различаются в зависимости от модели. Списание средств происходит, когда ваш баланс достигает порога оплаты, а оставшаяся сумма автоматически списывается первого числа месяца. Meta добавляет, что здесь «нет минимальных сумм и предварительных обязательств».

На одной асимметрии между этими двумя продуктами легко споткнуться. Meta утверждает, что в Muse Code «подписки по умолчанию используют режим Contributor, и вы можете включать или отключать его в настройках». В API по умолчанию всё наоборот: вы получаете Стандартные цены и Стандартные условия, если только намеренно не обратитесь к идентификатору модели -contributor. Так что читатель, который всё это время запускал Muse Code на условиях Contributor, а затем подставит ключ для muse-spark-1.2, окажется на Стандартной тарифной сетке с ценой за входные данные примерно в двенадцать раз выше — и при этом не изменит ничего, кроме клиента.

Meta не сообщает, даёт ли подписка право на какое-либо использование API. Ни на странице аутентификации, ни на странице цен, ни на странице продукта не сказано, что план включает токены или кредиты Model API; на странице API ключ рассматривается исключительно как способ аутентификации, а страницы подписки посвящены собственной теме. Не считайте, что эти две вещи взаимозаменяемы, и не переносите месячную сумму подписки на бюджет токенов — они отвечают на разные вопросы.

О бесплатном: для Model API не задокументирован бесплатный тариф, нет пробного кредита и нет бесплатной квоты. На странице продукта для агента-программиста тоже не указан бесплатный план. Режим контрибьютора доступен со скидкой, а не бесплатно — Meta подаёт это как цену со скидкой «в обмен на разрешение использовать ваш контент для обучения будущих моделей Meta», включая промпты, код, файлы и контекст, которые вы отправляете, а также полученные вами ответы. Это обмен, а не подарок. Если какая-то страница утверждает, что у Meta Muse API есть бесплатный тариф, значит, она не читает страницу с ценами Meta.

Что маршрутизирует это свойство

Мы предоставляем две модели из этой линейки, и утверждение о доступности на этой странице намеренно узкое. Обе уже сегодня доступны в каталоге: meta/muse-spark-1.1 и meta/muse-spark-1.2. У обеих одинаковое контекстное окно на 1 048 576 токенов, которое публикует Meta, а 1.2 — более поздний чекпойнт. Наши опубликованные тарифы на них — это прайс-лист Meta, переданный без наценки, 0 % — $1,25 за миллион входных токенов, $4,25 за миллион выходных токенов и $0,15 за миллион чтений из кэша, — в этом и заключается весь смысл схемы сквозной передачи: изменение тарифа поставщиком вступает в силу здесь в тот же день, без пересмотра цен с нашей стороны.

Что это даёт разработчику — это не скидка; это на одну интеграцию меньше. Muse Spark находится за одним эндпоинтом, охватывающим 200+ моделей, поэтому добавление его в пайплайн — это не второй контракт, не второй ключ и не вторые отношения по оплате, а запрос, который не проходит у одного провайдера, автоматически переключается на другого вместо того чтобы показывать вашим пользователям ошибку 429. Это имеет большее значение, чем обычно, при замене модели на непроверенную: это способ опробовать meta/muse-spark-1.2 на реальной рабочей нагрузке, прежде чем окончательно перейти на этот путь.

Две вещи здесь не подлежат маршрутизации, и эта страница не станет это смягчать. meta/muse-spark-1.3 отсутствует в нашем каталоге — если вам нужна именно 1.3, обратитесь напрямую в Meta. А meta/muse-code вообще не является идентификатором модели — ни на платформе Meta, ни на нашей, потому что Muse Code — это обвязка, а не модель; он не может быть целью маршрутизации. Чекпоинты уровня Contributor здесь тоже не маршрутизируются.

Что Meta не документирует

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

• Организации и проекты — на странице аутентификации нет ни понятия организации или проекта, ни иерархии, ни возможности ограничить ключ рамками одного из них. Единственная группировка, которую описывает Meta, — это команда.

• Области действия ключей — без наборов разрешений, без ограничений на уровне отдельных ресурсов, без ключей только для чтения. Каждый ключ является полным ключом, и именно поэтому сам Meta советует использовать один ключ на одно приложение.

• Срок жизни ключа и ротация — отзыв документирован (удалить его в панели управления); ротация — лишь рекомендация («отозвать и немедленно ротировать»), при этом нигде нет ни срока действия, ни TTL, ни процедуры перевыпуска.

• SDK первой стороны — ни одного опубликованного; заявление о совместимости — это и есть история интеграции, а Meta не говорит, что он появится.

• Бесплатное использование — без бесплатного тарифа, без кредитов, без пробного периода, как указано выше.

• API id для Muse Glimmer — на странице моделей id не указан, и Meta исключает её из эндпоинта моделей, поскольку она поставляется в виде весов.

Если вы искали это из-за одного из таких пробелов, ответ таков: эта информация не опубликована, а страница похуже угадала бы схему разграничения ключей или эндпоинт ротации, и вам пришлось бы обнаружить эту догадку в два часа ночи. По опубликованным данным картина достаточно полна, чтобы на неё можно было опираться при разработке: обычный базовый URL по адресу https://api.meta.ai/v1, Bearer-ключ, который вы создаёте сами, drop-in-совместимость с клиентами OpenAI и Anthropic, документированные лимиты частоты запросов для каждой команды и тарифная сетка, в которой два чекпойнта Muse Spark, обслуживаемых этим сайтом, идентичны как по окну, так и по цене.

Страница muse-code в этом блоге описывает обвязку в деталях; эта страница — лишь программная поверхность.

Именно в таких пробелах проявляются и режимы отказов: документированные инциденты с ИИ и сбои агентов, связанные с моделями этого класса, собраны в OrcaRouter AI Incident Archive , где каждая запись содержит собственные источники, степень серьёзности, оценку достоверности и отметку об оспаривании.