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

> Muse Wonder по API — только muse-wonder-1.0 за $4 и $20 за 1 млн токенов. Россия и Беларусь в списке запретов Meta: доступ оттуда и обход запрещены.

- URL: https://blog.laozhang.ai/ru/posts/muse-wonder-api
- Published: 2026-11-06
- Updated: 2026-11-06
- Author: LaoZhang AI Team (https://blog.laozhang.ai/ru/about)
- Topic: Руководства по API
- Tags: Muse Wonder, Meta Model API, muse-wonder-1.0, OpenRouter, AI API

---
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)](https://dev.meta.ai/legal/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 о доступе из другой страны](https://dev.meta.ai/help/accounts-and-login/travel-access): если вы оказались в неподдерживаемом регионе, войти в аккаунт не получится. Пускает ли OpenRouter к этой модели пользователей из России — вопрос к правилам самого OpenRouter, но запрос в итоге обрабатывает Meta: других поставщиков у `meta/muse-wonder` нет.

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

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

Второй вопрос — данные. Режим нулевого хранения (Zero Data Retention, ZDR) Meta включает по заявке для подходящих аккаунтов, и [справка Meta о ZDR](https://dev.meta.ai/help/policies-and-privacy/zero-data-retention) прямо пишет: он действует только для вызовов напрямую в Meta Model API, а запросы через сторонние платформы подчиняются правилам хранения данных этих платформ. Если в запросах будет код или документы компании, условия хранения посредника нужно читать отдельно — гарантии Meta на них не распространяются.

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

Ключ создаётся в кабинете Meta Model API на dev.meta.ai, а первый запрос отличается от примера из [quickstart Meta Model API](https://dev.meta.ai/docs/quickstart) только именем модели: там используется `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 рекомендован по умолчанию.

```bash
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` сам, поэтому ключ передаётся при создании клиента:

```python
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](https://dev.meta.ai/docs/pricing-rate-limits): $4 за 1 млн входных токенов, $0,20 за 1 млн кэшированных и $20 за 1 млн выходных, причём токены рассуждений входят в выходные. Наценки за длинный контекст нет, кэширование включается само, без настройки, а поиск в интернете (web search grounding) стоит ещё $2,50 за 1 000 поисковых запросов. Формула: (некэшированный ввод × 4 + кэшированный ввод × 0,20 + вывод × 20) / 1 000 000, плюс $0,0025 за каждый поиск.

| Сценарий | Токены | За запрос | За 1 000 запросов |
| --- | --- | --- | --- |
| Короткий ответ в чате | 2 000 на входе, 1 500 на выходе вместе с рассуждениями | $0,038 | $38 |
| Ход агента, кэш пуст | 60 000 на входе, 6 000 на выходе | $0,36 | $360 |
| Тот же ход агента, 50 000 входных из кэша | 10 000 + 50 000 из кэша, 6 000 на выходе | $0,17 | $170 |
| Длинный документ | 800 000 на входе, 4 000 на выходе | $3,28 | $3 280 |
| Ответ с поиском | 20 000 на входе, 3 000 на выходе, 10 поисков | $0,165 | $165 |

Количество токенов в таблице выбрано для примера, это не замер 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 токенов.

![Цена хода агента Muse Wonder: $0,36 без кэша и $0,17, когда 50 000 входных токенов взяты из кэша](https://blog.laozhang.ai/posts/ru/muse-wonder-api/img/muse-wonder-cost-breakdown.webp)

Для дешёвых подзадач и субагентов 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.

| | Meta Model API напрямую | OpenRouter |
| --- | --- | --- |
| Имя модели | `muse-wonder-1.0` | `meta/muse-wonder` |
| Базовый адрес | `https://api.meta.ai/v1` | `https://openrouter.ai/api/v1` |
| Ключ | `LLM_…` из кабинета dev.meta.ai | Ключ OpenRouter; на api.meta.ai он получает 401 |
| Цена токенов | Прайс Meta | Те же ставки, OpenRouter пишет «без наценки» |
| Комиссия | Нет | 5,5 % при пополнении картой (минимум $0,80), 5 % криптовалютой |
| Оплата | Карта, списание по порогу и 1-го числа | Предоплаченные кредиты |
| Нулевое хранение (ZDR) | По заявке для подходящих аккаунтов | ZDR Meta не действует, применяются правила OpenRouter |

Минимальная комиссия OpenRouter заметна на маленьких суммах: при пополнении на $10 сбор $0,80 — это 8 %, и только начиная примерно с $14,55 он выходит на обычные 5,5 % ([страница цен OpenRouter](https://openrouter.ai/pricing)). 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 для внешних ключей их не переносит и не даёт поиска в интернете.

| Формат | Путь | Когда подходит | Рассуждения между ходами | Поиск и tool search |
| --- | --- | --- | --- | --- |
| Responses | `POST /v1/responses` | Новый код, агенты, фоновые задачи, файлы | Да, через зашифрованные элементы или `previous_response_id` | Есть |
| Chat Completions | `POST /v1/chat/completions` | Готовый код на OpenAI `messages` | Не переносятся для внешних ключей | Нет; вызов функций есть |
| Messages | `POST /v1/messages` | Anthropic SDK и Claude Code; базовый адрес `https://api.meta.ai` без `/v1` | Да: клиент передаёт историю вместе с блоками thinking | Есть |

Уровень рассуждений в этих форматах задаётся по-разному: в Responses — `reasoning.effort`, в Chat Completions — `reasoning_effort` на верхнем уровне запроса, в Messages — `output_config.effort`. Параметр `thinking.budget_tokens` адаптер Messages принимает, но в уровень рассуждений не переводит. Подробности — в [описании форматов запросов Meta Model API](https://dev.meta.ai/docs/protocols).

## Какой 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](https://artificialanalysis.ai/models/releases/comparisons/muse-wonder-vs-claude-opus-5-5)). То есть `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 по рассуждениям](https://dev.meta.ai/docs/reasoning) все примеры с `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 для агентов программирования](https://dev.meta.ai/docs/coding-agents) задайте переменные и запустите `claude`:

```bash
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:

```json
{"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 ничего не говорит о правильности адреса.

![Порядок проверки запроса в Meta Model API: без действующего ключа любой запрос получает 401, а 404 возможен только после проверки ключа](https://blog.laozhang.ai/posts/ru/muse-wonder-api/img/muse-wonder-key-before-path.webp)

| Код | Что значит по документации Meta | Что проверить |
| --- | --- | --- |
| 401 `invalid_api_key` | Ключа нет, он не в формате `LLM_…`, отозван или скопирован с ошибкой | Ключ из кабинета Meta, а не OpenRouter; заголовок `Authorization: Bearer` (в Claude Code — `ANTHROPIC_AUTH_TOKEN`) |
| 402 `billing_not_configured` | «Billing account issue»: нет карты, не прошёл платёж или проблема со счётом | Раздел оплаты в кабинете: карта и данные компании |
| 403 | У ключа нет прав на эту модель или функцию | Права ключа и команды |
| 404 «The model … does not exist or is not available» | Неверный ID модели или нет доступа к ней | ID `muse-wonder-1.0` и базовый адрес без слеша на конце |
| 429 `rate_limit_error` | Превышен лимит запросов или токенов команды | Пауза с нарастанием и `Retry-After`; заголовки `x-ratelimit-remaining-tokens` и `x-ratelimit-remaining-requests` |

Полный список, включая 5xx `server_error`, — на [странице обработки ошибок Meta Model API](https://dev.meta.ai/docs/error-handling).

## 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](https://blog.laozhang.ai/ru/posts/muse-wonder-pricing).

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

Публичного API для видео у Meta нет, а Muse Wonder принимает видео на вход, но отвечает только текстом. Как всё же получить ролики Muse Video и сколько стоит ролик длиной до минуты, разобрано в статье [Muse Video API: как подключить без Meta и цена ролика до минуты](https://blog.laozhang.ai/ru/posts/muse-video-api).

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

Нет: приложение Muse — потребительский ассистент Meta, а Muse Wonder API — платный сервис для разработчиков с ключом и потокенной оплатой. О приложении и его доступности в России — в статье [ChatGPT Dots, Meta Muse, Grok Bot и Claude Duet: доступ в России](https://blog.laozhang.ai/ru/posts/chatgpt-dots-vs-meta-muse-vs-grok-bot).

## Источники

Внешние страницы, на которые ссылается это руководство, в порядке упоминания. Последнее обновление: 2026-11-06.

- [политике географического использования Meta Model API (Geographic Use Policy)](https://dev.meta.ai/legal/geographic-use-policy) (dev.meta.ai)
- [отдельная статья справки Meta о доступе из другой страны](https://dev.meta.ai/help/accounts-and-login/travel-access) (dev.meta.ai)
- [справка Meta о ZDR](https://dev.meta.ai/help/policies-and-privacy/zero-data-retention) (dev.meta.ai)
- [quickstart Meta Model API](https://dev.meta.ai/docs/quickstart) (dev.meta.ai)
- [страницы цен и лимитов Meta Model API](https://dev.meta.ai/docs/pricing-rate-limits) (dev.meta.ai)
- [страница цен OpenRouter](https://openrouter.ai/pricing) (openrouter.ai)
- [описании форматов запросов Meta Model API](https://dev.meta.ai/docs/protocols) (dev.meta.ai)
- [сравнение Muse Wonder и Claude Opus 5.5 на Artificial Analysis](https://artificialanalysis.ai/models/releases/comparisons/muse-wonder-vs-claude-opus-5-5) (artificialanalysis.ai)
- [руководстве Meta по рассуждениям](https://dev.meta.ai/docs/reasoning) (dev.meta.ai)
- [руководству Meta для агентов программирования](https://dev.meta.ai/docs/coding-agents) (dev.meta.ai)
- [странице обработки ошибок Meta Model API](https://dev.meta.ai/docs/error-handling) (dev.meta.ai)