API-ключ Muse Code: как получить, подключить в CI и сколько стоит
В Muse Code можно войти через браузер или по API-ключу, и тот же ключ открывает доступ к Meta Model API. Как создать ключ, какую переменную окружения ждёт каждый инструмент (META_API_KEY или MODEL_API_KEY), базовые URL, цены за токен, лимиты запросов и ошибки, из-за которых приходят неожиданные счета.
Один ключ — два применения
Ключ Meta Model API решает две задачи. Во-первых, с ним можно войти в Muse Code, терминальный агент Meta для программирования, без входа через браузер — это обычный вариант для CI, серверов и скриптов. Во-вторых, через него можно напрямую обращаться к Meta Model API, то есть к тем же моделям, на которых работает Muse Code, — из своего кода или из других агентов.
Только вот читают ключ в этих двух случаях из разных переменных окружения, и на этом многие спотыкаются:
| Что вы используете | Переменная | Примечание |
|---|---|---|
CLI Muse Code (muse, muse exec) |
META_API_KEY |
Или сохраните ключ один раз командой muse auth set |
| Model API из своего кода, OpenCode или Codex | MODEL_API_KEY |
Это имя используется в примерах Meta; SDK сами его не читают, так что передавайте ключ явно |
| Claude Code на моделях Meta | ANTHROPIC_AUTH_TOKEN |
Укажите здесь свой ключ Model API |
Как создать ключ
- Войдите в панель Meta Model API на dev.meta.ai под своим аккаунтом разработчика Meta.
- Откройте вкладку API keys и нажмите Create API key.
- Дайте ключу имя, по которому понятно, где он будет жить, —
ci-github-actionsкуда лучше, чемkey1, — и нажмите Create. - Сразу скопируйте его: Meta показывает ключ только один раз.
Ключи начинаются с LLM_, за которым идут числовой идентификатор и секрет. Если ваш аккаунт создан через регистрацию Business & Enterprise, вход через браузер вам недоступен вовсе и API-ключ — единственный способ пользоваться Muse Code. Попросите администратора команды его создать.
Ключ в Muse Code
На своей машине ключ достаточно сохранить один раз:
muse auth setВо всех остальных местах, особенно в CI, подставляйте его из хранилища секретов как META_API_KEY:
META_API_KEY="$MUSE_KEY" muse exec --json "fix the failing test in tests/date.test.ts"Muse Code ищет учётные данные в строгом порядке: сначала META_API_KEY, затем сохранённый ключ, затем сохранённая браузерная сессия. Если ключ из окружения перекрывает браузерную сессию, которой вы собирались воспользоваться, Muse Code об этом предупредит. /login заново открывает варианты входа прямо в сессии, а muse logout удаляет сохранённую сессию и сохранённый ключ — но не META_API_KEY, экспортированный в оболочке: его придётся сбросить самостоятельно.
Про CI стоит знать две вещи. muse exec завершается с кодом 0, когда ход закончен, а это вовсе не значит, что работа сделана правильно, — пускайте изменения в основную ветку только после своих тестов. А на Linux-раннерах песочнице нужны bubblewrap и сборка не на musl, так что в образах на базе Alpine shell-команды выполняться не будут. Остальные флаги muse exec — в нашей шпаргалке по командам CLI.
Сколько стоит API-ключ в Muse Code
Ключ работает по модели pay-as-you-go: каждый токен тарифицируется по ставкам Model API, отдельно от месячной подписки. В документации Meta по подпискам прямо сказано, что использование через дополнительные API-ключи оплачивается именно так, даже если у вас есть подписка, — значит, ключ в CI не будет расходовать лимит тарифа. Списания происходят, когда баланс доходит до порога оплаты, а остаток — первого числа каждого месяца. Панель Usage показывает, куда ушли токены, а кнопка Pay now на странице Billing позволяет рассчитаться досрочно.
Двух вещей ключ не даёт: доступа к Muse Wonder Full, который есть только в тарифах Power и Maximum, и лимита в запросах, который входит в подписку.
Цены по моделям
За 1M токенов, по странице цен Meta на 25 октября 2026 года:
| Модель | Вход | Кэшированный вход | Выход |
|---|---|---|---|
muse-wonder-1.0 |
$4,00 | $0,20 | $20,00 |
muse-spark-1.3 |
$1,25 | $0,15 | $4,25 |
muse-spark-1.3-contributor |
$0,10 | $0,002 | $0,20 |
Модель Contributor — это тот же Muse Spark 1.3 за малую долю цены, потому что Meta может использовать данные для обучения будущих моделей. Версии Contributor для Muse Wonder нет. Muse Image стоит $0,01 за изображение, а привязка к веб-поиску (grounding) добавляет $2,50 за 1000 запросов. Наш калькулятор переведёт объёмы токенов в месячный счёт, а статья Contributor или Standard разбирает этот выбор с точки зрения приватности.
Лимиты запросов
Лимиты действуют на всю команду, а не на отдельный ключ, так что новые ключи пропускной способности не добавят:
| Модель | Запросов в минуту | Токенов в минуту |
|---|---|---|
muse-wonder-1.0 |
3000 | 4 000 000 |
muse-spark-1.3 |
3000 | 4 000 000 |
muse-spark-1.3-contributor |
150 | 3 000 000 |
Именно за 150 запросами в минуту у модели Contributor стоит следить, если вы запускаете на ней много параллельных агентов.
Прямые запросы к Model API
API понимает форматы, с которыми уже работают другие инструменты. Для клиентов в стиле OpenAI базовый URL — https://api.meta.ai/v1, для клиентов в стиле Anthropic — https://api.meta.ai, без /v1. Первый запрос:
curl https://api.meta.ai/v1/chat/completions \
-H "Authorization: Bearer $MODEL_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model": "muse-spark-1.3", "messages": [{"role": "user", "content": "Hello"}]}'Тот же ключ подойдёт для OpenCode, Codex и Claude Code с конфигурациями из нашей документации. Если запросы начали падать, https://api.meta.ai/v1/status покажет состояние API и доступность каждой модели — ключ для этого не нужен.
Как уберечь ключ
- Храните его в хранилище секретов CI или в менеджере паролей — ни в коем случае не в репозитории и не в
AGENTS.md. - Заводите отдельный ключ для каждого места, где он используется, чтобы отозвать утёкший ключ из CI, не сломав работу на ноутбуке.
- Передавайте ключ как переменную окружения только той команде, которой он нужен, — как в примере с
muse execвыше, — а не экспортируйте его в общем профиле оболочки. - Если ключ утёк, удалите его в панели и создайте новый: с его помощью на вашем аккаунте могут накрутить счёт.