Get started с muse-spark-1.2-contributor

1 Три названия, которые путают

2 Цены и rate limits

Официальные цифры с dev.meta.ai/docs/pricing-rate-limits, за 1M tokens:

3 Доступ и API key

Waitlist'а нет, вручную никто не отсматривает. Нужны: возраст 18+, поддерживаемая страна и привязанный способ оплаты — без него запросы не пойдут, и добавить его может только team admin.

1. Регистрация на dev.meta.ai — login через auth.meta.com. Аккаунт и team создаются сразу.
2. Платёжный метод в разделе /billing. Списание — по нарастающему порогу либо 1-го числа месяца.
3. Вкладка API keys → Create API key → имя → Create.
4. Скопировать сразу: «You only see it once». Формат ключа — LLM|607358788850350|nx9.....LJY.

Base URL: https://api.meta.ai/v1. Клиенты на Anthropic-протоколе (Claude Code) берут https://api.meta.ai без /v1. Поддерживаются три протокола: Responses, Chat Completions, Anthropic Messages.

4 Путь A — Muse Code CLI

4.1 Install

Единственный документированный способ. macOS и Linux, из зависимостей только curl и mktemp — binary статический, ни Node, ни Python не нужны:

curl -fsSL https://dev.meta.ai/install.sh | sh
muse --version

Ставится в ~/.local/bin/muse, PATH дописывается в ~/.zshrc, ~/.bashrc, ~/.profile и ~/.config/fish/conf.d/muse.fish. Если не хочешь, чтобы скрипт трогал dotfiles:

curl -fsSL https://dev.meta.ai/install.sh -o install.sh
less install.sh                                   # сначала прочитать
MUSE_NO_MODIFY_PATH=1 MUSE_INSTALL_DIR="$HOME/bin" sh install.sh

npm-пакета, Homebrew formula и публичного репозитория нет. Всё, что лежит на GitHub под именем muse-spark, — сторонние обёртки, не Meta. Docs дают | sh, marketing-страница | bash; сам скрипт имеет shebang #!/usr/bin/env bash, работают оба варианта.

4.2 Первый запуск и auth

Запусти muse внутри репозитория. Он спросит trust на workspace, затем предложит browser sign-in или вставку API key:

cd ~/projects/my-app
muse

4.3 Headless-режим для CI

export META_API_KEY="LLM|...."
muse exec --json "Run the test suite and summarize failures."

Exit codes: 0 — готово, 1 — упало или отменено, 2 — ошибка в аргументах, 130/143 — SIGINT/SIGTERM.

4.4 Как включить contributor tier в CLI

По умолчанию Muse Code берёт muse-spark-1.2, то есть Standard. Дешёвый tier сам не включится.

muse --model muse-spark-1.2-contributor      # на один запуск
# либо /models прямо в session

4.5 Что есть внутри session

5 Путь B — OpenCode

5.1 Короткий путь

export META_MODEL_API_KEY="LLM|...."
opencode models | grep '^meta/'

$ META_MODEL_API_KEY=… opencode models | grep '^meta/'
meta/muse-spark-1.1
meta/muse-spark-1.2
meta/muse-spark-1.2-contributor

Дальше /models в TUI и выбрать meta/muse-spark-1.2-contributor. Либо opencode auth login → Meta: ключ ляжет в ~/.local/share/opencode/auth.json, переменная тогда не нужна. Путь «Other» из /connect для Muse Spark не нужен — provider встроенный.

5.2 Если нужен явный config

Файл ~/.config/opencode/opencode.json (глобально) или ./opencode.json (в проекте, приоритет выше). Переопределяем встроенный id meta, а не заводим новый — иначе потеряешь metadata и цены из models.dev:

{
  "$schema": "https://opencode.ai/config.json",
  "model": "meta/muse-spark-1.2-contributor",
  "provider": {
    "meta": {
      "name": "Meta Model API",
      "npm": "@ai-sdk/openai",
      "options": {
        "baseURL": "https://api.meta.ai/v1",
        "apiKey": "{env:META_MODEL_API_KEY}"
      },
      "models": {
        "muse-spark-1.2-contributor": {
          "name": "Muse Spark 1.2 Contributor",
          "reasoning": true,
          "limit": { "context": 1048576, "output": 131072 },
          "options": {
            "reasoningEffort": "high",
            "reasoningSummary": "auto",
            "include": ["reasoning.encrypted_content"]
          }
        }
      }
    }
  }
}

Почему @ai-sdk/openai, а не @ai-sdk/openai-compatible: первый ходит в Responses API, второй — в Chat Completions. Meta прямо называет первый «the recommended adapter», и это же значение стоит в models.dev. Строка include: ["reasoning.encrypted_content"] выглядит как магия, но именно она переносит reasoning модели между turns — без неё смысл Responses API теряется. Число 131072 для output — из собственного примера Meta; официального максимума output-токенов Meta не публикует.

Meta советует хранить ключ через /connect, а не строкой apiKey в конфиге — тогда поле можно просто убрать.

5.3 Грабли

6 Условия сделки — прочитай до того, как включишь

В юридических документах Meta contributor называется Discounted Services. Формулировки жёстче, чем маркетинговое «в обмен на разрешение»:

«You must not submit sensitive, confidential, or personal information to the Discounted Services. If you intend, or are required (including by contract), to keep information such as software code confidential, you must not submit that information to the Discounted Services. … the Discounted Services do not offer a mechanism to exclude specific traffic from training.»
— Terms of Service §6.2

7 Через gateway и что по бенчмаркам

8 Ссылки

# A. Muse Code
curl -fsSL https://dev.meta.ai/install.sh | sh
cd ~/projects/my-app && muse                 # trust + sign-in
muse --model muse-spark-1.2-contributor      # сверь с /models

# B. OpenCode
export META_MODEL_API_KEY="LLM|...."
opencode                                     # /models → meta/muse-spark-1.2-contributor