Muse Wonder API: цена $4/$20, ключ и запрет Meta для России

Muse Wonder, модель Meta, вышедшая 12 октября 2026 года, доступна по API в одном варианте — muse-wonder-1.0 через Meta Model API: адрес https://api.meta.ai/v1, ключ из кабинета dev.meta.ai, оплата картой по факту использования. По состоянию на 6 ноября 2026 года миллион входных токенов стоит $4, кэшированный ввод — $0,20, выходные токены — $20, и рассуждения модели оплачиваются как вывод. Muse Wonder Full в API нет. На OpenRouter модель есть под именем meta/muse-wonder по тем же ценам, но и там единственный поставщик — сама Meta.

Из России и Беларуси пользоваться этим API нельзя. Обе страны входят в список запрещённых территорий (Restricted Territories) в политике географического использования Meta Model API, обновлённой 12 октября 2026 года. Оттуда нельзя обращаться к сервису, нельзя открывать продукт на моделях Meta пользователям, которые там находятся, а обходить географические ограничения техническими средствами политика запрещает отдельной строкой. Если вы работаете из страны, где Meta Model API доступен, ниже — ключ, первый запрос, стоимость по сценариям, выбор формата запроса и уровня рассуждений.

Цифры ниже не подкреплены успешным вызовом генерации: 6 ноября 2026 года к api.meta.ai отправлялись только запросы без действующего ключа, и их ответы приведены как есть, вместе с записью эндпоинта OpenRouter и пересчётом стоимости. Цены, параметры и примеры кода взяты из документации Meta и OpenRouter по состоянию на ту же дату.

Muse Wonder API из России: что запрещает политика Meta

Пользоваться Muse Wonder API из России нельзя по условиям самой Meta, а не из-за технического сбоя. В политике географического использования Meta Model API (Geographic Use Policy), обновлённой 12 октября 2026 года, Россия и Беларусь входят в список Restricted Territories вместе с Ираном, Кубой, КНДР, Сирией, Китаем, Пакистаном, Крымом, Донецкой и Луганской областями и ещё рядом стран и территорий. Политика запрещает три вещи: обращаться к сервису с этих территорий, делать продукт на моделях Meta доступным пользователям, которые там находятся, и обходить ограничения — «You may not use technical measures to circumvent, bypass, or otherwise evade geographic access controls».

Запрет касается не только людей в России, но и тех, кто строит продукт. Разработчик из разрешённой страны может подключить muse-wonder-1.0 к своему сервису, но по той же политике не должен открывать его конечным пользователям (End Users), находящимся в России или Беларуси. Отдельный раздел политики о торговом праве добавляет к этому обязанность соблюдать санкционные и экспортные правила США, ЕС, Великобритании и ООН — независимо от списка территорий.

Справка Meta формулирует доступность коротко: Model API работает «в большинстве стран и территорий, где доступен Meta AI и поддерживается оплата», а решающим источником называет ту же политику. Для поездок есть отдельная статья справки Meta о доступе из другой страны: если вы оказались в неподдерживаемом регионе, войти в аккаунт не получится. Пускает ли OpenRouter к этой модели пользователей из России — вопрос к правилам самого OpenRouter, но запрос в итоге обрабатывает Meta: других поставщиков у meta/muse-wonder нет.

Перепродавцы с оплатой в рублях: что важно в условиях Meta

Российские сервисы, которые продают доступ к Muse Wonder за рубли, к Meta напрямую вас не подключают: между вами и моделью стоит чужой аккаунт или агрегатор, и отвечать перед Meta за то, кто пользуется доступом, должен он. Условия Meta для такого клиента те же, что описаны выше: продукт на её моделях нельзя открывать конечным пользователям в Restricted Territories, а значит, и пользователям в России. Решать, подходит ли вам такой вариант с учётом этого условия, придётся вам.

Второй вопрос — данные. Режим нулевого хранения (Zero Data Retention, ZDR) Meta включает по заявке для подходящих аккаунтов, и справка Meta о ZDR прямо пишет: он действует только для вызовов напрямую в Meta Model API, а запросы через сторонние платформы подчиняются правилам хранения данных этих платформ. Если в запросах будет код или документы компании, условия хранения посредника нужно читать отдельно — гарантии Meta на них не распространяются.

Ключ Meta Model API и первый запрос к muse-wonder-1.0

Ключ создаётся в кабинете Meta Model API на dev.meta.ai, а первый запрос отличается от примера из quickstart Meta Model API только именем модели: там используется muse-spark-1.3, а Meta пишет, что перенос нагрузки между Spark и Wonder — это замена ID модели. Порядок такой:

1. Убедитесь, что работаете из страны, где Meta Model API доступен (см. раздел о политике выше).
2. В кабинете на dev.meta.ai откройте API keys и нажмите Create API key. Ключ показывается один раз и выглядит как LLM_<число>_<секрет>; все ключи одной команды делят общие лимиты.
3. Настройте оплату: администратор добавляет карту и данные компании (юридическое название и адрес; если компании нет — ваше полное имя и почтовый адрес). Списание идёт по факту: карту списывают, когда долг доходит до порога, и остаток — 1-го числа каждого месяца.
4. Сохраните ключ в переменную окружения: export MODEL_API_KEY="..." в macOS и Linux или $env:MODEL_API_KEY = "..." в PowerShell.
5. Отправьте запрос в формате Responses — он у Meta рекомендован по умолчанию.

curl -X POST "https://api.meta.ai/v1/responses" \
  -H "Authorization: Bearer $MODEL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "muse-wonder-1.0",
    "reasoning": {"effort": "high"},
    "input": "Объясни разницу между TCP и UDP в трёх предложениях."
  }'

То же через OpenAI SDK для Python. Ни один SDK — ни OpenAI, ни Anthropic — не читает MODEL_API_KEY сам, поэтому ключ передаётся при создании клиента:

import os
from openai import OpenAI

client = OpenAI(
    base_url="https://api.meta.ai/v1",
    api_key=os.environ["MODEL_API_KEY"],
)

response = client.responses.create(
    model="muse-wonder-1.0",
    reasoning={"effort": "high"},
    input="Объясни разницу между TCP и UDP в трёх предложениях.",
)

print(response.output_text)
print(response.usage)  # reasoning_tokens входят в output_tokens

Оба примера собраны по документации и с действующим ключом не запускались. Бесплатных кредитов или пробного лимита на страницах цен, quickstart и оплаты Meta не указано, а страница цен отдельно пишет, что минимального платежа и предоплаты нет. Модель находится в статусе preview, поэтому поведение и лимиты ещё могут меняться.

Сколько стоит запрос к Muse Wonder: от $0,038 до $3,28

Цена запроса считается по трём ставкам из страницы цен и лимитов Meta Model API: $4 за 1 млн входных токенов, $0,20 за 1 млн кэшированных и $20 за 1 млн выходных, причём токены рассуждений входят в выходные. Наценки за длинный контекст нет, кэширование включается само, без настройки, а поиск в интернете (web search grounding) стоит ещё $2,50 за 1 000 поисковых запросов. Формула: (некэшированный ввод × 4 + кэшированный ввод × 0,20 + вывод × 20) / 1 000 000, плюс $0,0025 за каждый поиск.

Количество токенов в таблице выбрано для примера, это не замер Muse Wonder: сколько модель потратит на рассуждения, зависит от задачи и уровня reasoning effort. Пересчёт выполнен 6 ноября 2026 года по ценам Meta на ту же дату. Из него видны две вещи. Во-первых, в ходе агента выход составляет только треть цены ($0,12 из $0,36), остальное — входной контекст, поэтому кэш снижает цену того же хода на 52,8 %: $0,04 за некэшированный ввод, $0,01 за кэш и $0,12 за вывод дают $0,17. Во-вторых, даже документ на 800 000 токенов стоит дороже из-за объёма, а не из-за надбавки: ставка за токен не меняется до самого конца окна в 1 048 576 токенов.

Для дешёвых подзадач и субагентов Meta предлагает muse-spark-1.3 на том же адресе: $1,25 за ввод, $0,15 за кэш и $4,25 за вывод, а переход — это только замена ID модели. При тех же количествах токенов ход агента без кэша стоил бы около $0,10, но у разных моделей рассуждения разной длины, так что сравнивайте по счёту за реальную работу.

Лимиты считаются на команду, а не на ключ: 3 000 запросов и 4 000 000 токенов в минуту для muse-wonder-1.0. Токенный лимит наступает раньше: если в него входят и ввод, и вывод, то ходов агента по 66 000 токенов помещается около 60 в минуту, коротких ответов по 3 500 токенов — около 1 142, а запросов с документом на 804 000 токенов — 4. Входят ли кэшированные токены в этот лимит, Meta не пишет. При ответе 429 Meta советует экспоненциальную паузу со случайным разбросом, начиная примерно с 500 мс, и соблюдение заголовка Retry-After.

Meta напрямую или OpenRouter: ключ, комиссия и хранение данных

Цена токенов на обоих маршрутах одинаковая, разница в оплате, ключах и хранении данных. 6 ноября 2026 года публичный API OpenRouter (/api/v1/models/meta/muse-wonder/endpoints) вернул ровно один эндпоинт — Meta | meta/muse-wonder-20261012 с поставщиком Meta и теми же ставками за токены и поиск, что в прайсе Meta.

Минимальная комиссия OpenRouter заметна на маленьких суммах: при пополнении на $10 сбор $0,80 — это 8 %, и только начиная примерно с $14,55 он выходит на обычные 5,5 % (страница цен OpenRouter). OpenRouter удобен, если у вас уже есть там баланс и вы переключаетесь между моделями разных компаний. Прямой Meta Model API нужен, если важен ZDR или вы хотите один счёт и один кабинет у самой Meta. В записи OpenRouter среди поддерживаемых параметров есть reasoning_effort, tools, response_format и structured_outputs, а потолок вывода указан как 943 718 токенов — это цифра OpenRouter, Meta для Wonder такого числа не публикует.

Responses, Chat Completions или Messages: какой формат выбрать

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

Уровень рассуждений в этих форматах задаётся по-разному: в Responses — reasoning.effort, в Chat Completions — reasoning_effort на верхнем уровне запроса, в Messages — output_config.effort. Параметр thinking.budget_tokens адаптер Messages принимает, но в уровень рассуждений не переводит. Подробности — в описании форматов запросов Meta Model API.

Какой reasoning effort ставить: high или max

Для большинства задач начинайте с high: Meta называет его «strong default» в руководстве для агентов, а сторонние замеры показывают, что max даёт немного больше качества заметно дороже и медленнее. В индексе Artificial Analysis Intelligence Index v5.0.1 (по состоянию на 6 ноября 2026 года) Muse Wonder на high набирает 41 балл, тратит $4,56 на задачу индекса и выдаёт первый токен ответа через 9,83 с; на max — 44 балла, $6,95 и 21,19 с (сравнение Muse Wonder и Claude Opus 5.5 на Artificial Analysis). То есть high на 34,4 % дешевле за задачу и начинает отвечать в 2,16 раза быстрее ценой трёх пунктов индекса.

Допустимые значения reasoning_effort у Wonder — minimal, low, medium, high, xhigh и max; none возвращает HTTP 400, а если параметр не передать, модель всё равно рассуждает на уровне, который выбирает сама. Для уровней ниже high Artificial Analysis цифр не публикует, поэтому, если хотите экономить на простых задачах, сравните на своих запросах поле reasoning_tokens в usage: эти токены оплачиваются как вывод и расходуют лимит вывода (max_output_tokens в Responses, max_completion_tokens в Chat Completions).

Для max используйте формат Responses ("reasoning": {"effort": "max"}). В руководстве Meta по рассуждениям все примеры с max написаны на Responses, а таблица параметров Chat Completions перечисляет значения только до xhigh. Отклоняет ли Chat Completions значение max, документация прямо не говорит.

Muse Wonder в Claude Code и Codex: какие переменные задать

Claude Code подключается к Meta через формат Messages, поэтому ему нужен базовый адрес без /v1 и ключ в ANTHROPIC_AUTH_TOKEN, а не в ANTHROPIC_API_KEY: первый отправляет заголовок Authorization: Bearer, которого ждёт Meta, второй — x-api-key. По руководству Meta для агентов программирования задайте переменные и запустите claude:

export ANTHROPIC_BASE_URL="https://api.meta.ai"
export ANTHROPIC_AUTH_TOKEN="$MODEL_API_KEY"
export ANTHROPIC_MODEL="muse-wonder-1.0"
export ANTHROPIC_DEFAULT_OPUS_MODEL="muse-wonder-1.0"
export ANTHROPIC_DEFAULT_SONNET_MODEL="muse-spark-1.3"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="muse-spark-1.3"
export CLAUDE_CODE_SUBAGENT_MODEL="muse-spark-1.3"
export ENABLE_TOOL_SEARCH="true"
claude

Все три псевдонима (opus, sonnet, haiku) и модель субагентов нужно направить на модели Meta: иначе режим планирования, субагенты и фоновые задачи вроде сообщений коммитов попытаются обратиться к модели Claude, которой у Meta нет. ENABLE_TOOL_SEARCH возвращает поиск MCP-инструментов, который Claude Code отключает для сторонних адресов.

Codex работает через Responses. В ~/.codex/config.toml Meta предлагает model = "muse-wonder-1.0", model_provider = "meta" и model_reasoning_effort = "high", а в блоке [model_providers.meta] — base_url = "https://api.meta.ai/v1" без слеша на конце, env_key = "MODEL_API_KEY" и wire_api = "responses". Если Codex уже вошёл в аккаунт OpenAI, сначала выполните /logout. Эти настройки, как и примеры выше, с действующим ключом не запускались. Учтите и то, что агенты часто показывают стоимость $0 для сторонних моделей — это отсутствие тарифа в настройках агента, а не бесплатные запросы.

Ошибки 401, 402, 403, 404 и 429 у Muse Wonder API

Ошибки Meta Model API приходят в конверте в стиле OpenAI: {"error": {"message", "type", "param", "code"}}; на /v1/messages тело ответа устроено как у Anthropic. 6 ноября 2026 года в 00:37 UTC с одного компьютера к api.meta.ai были отправлены запросы без действующего ключа. GET /v1/status ответил без ключа кодом 200 и "service_status":"operational", но список статусов по моделям (model_statuses) оказался пустым, так что о состоянии именно Wonder он ничего не говорит. Запросы к /v1/models, /v1/chat/completions и /v1/responses — без ключа, с ключом формата OpenRouter (sk-or-v1-…) и с выдуманным ключом формата LLM_… — получили одинаковый ответ 401:

{"error":{"code":"invalid_api_key","message":"Unauthorized","param":null,"type":"authentication_error"}}

/v1/messages ответил тем же 401, но в формате Anthropic: {"error":{"message":"Unauthorized","type":"authentication_error"},"type":"error"}. Запрос на путь с опечаткой (/v1/chat/completion) тоже вернул 401, а не 404: сначала проверяется ключ, поэтому описанный в документации пустой ответ 404 на неизвестный путь появится только с действующим ключом. Значит, пока ключ не принят, 401 ничего не говорит о правильности адреса.

Полный список, включая 5xx server_error, — на странице обработки ошибок Meta Model API.

Muse Wonder API: другие вопросы

Есть ли Muse Wonder Full в API?

Нет. По состоянию на 6 ноября 2026 года страница моделей Meta отмечает Muse Wonder Full как недоступную в Model API, в каталоге OpenRouter её тоже нет, а reasoning_effort: "max" её не включает. Full есть только в Muse Code на подписках Power Usage ($50 в месяц) и Maximum Usage ($200 в месяц). Подписка Muse Code работает только в CLI Muse Code, а любые дополнительные API-ключи оплачиваются потокенно. Сравнение тарифов приложения, Muse Code и API — в статье Muse Wonder цена: API $4/$20, подписка от $5, Full — от $50.

Есть ли у Meta API для генерации видео?

Публичного API для видео у Meta нет, а Muse Wonder принимает видео на вход, но отвечает только текстом. Как всё же получить ролики Muse Video и сколько стоит ролик длиной до минуты, разобрано в статье Muse Video API: как подключить без Meta и цена ролика до минуты.

Приложение Muse и Muse Wonder API — одно и то же?

Нет: приложение Muse — потребительский ассистент Meta, а Muse Wonder API — платный сервис для разработчиков с ключом и потокенной оплатой. О приложении и его доступности в России — в статье ChatGPT Dots, Meta Muse, Grok Bot и Claude Duet: доступ в России.