# Muse Wonder APIの使い方と料金：用途別に1回$0.038〜$3.28

> APIで使えるのはmuse-wonder-1.0だけで、Fullは対象外です。単価は100万トークンあたり入力$4・出力$20、短い回答なら1回約$0.038です。

- URL: https://blog.laozhang.ai/ja/posts/muse-wonder-api
- Published: 2026-11-06
- Updated: 2026-11-06
- Author: LaoZhang AI Team (https://blog.laozhang.ai/ja/about)
- Topic: API ガイド
- Tags: Muse Wonder, Meta Model API, muse-wonder-1.0, API料金, OpenRouter

---
Muse Wonder APIで呼び出せるのは、モデルID `muse-wonder-1.0`の1種類です。上位版のMuse Wonder FullはAPIでは提供されておらず、使えるのはサブスクリプション型のCLI「Muse Code」の上位プランだけです。自分のコードやコーディングエージェントから使うには、Metaの[Model APIダッシュボード](https://dev.meta.ai/)でアカウントを作り、カードと請求先情報を登録してAPIキーを発行し、ベースURL `https://api.meta.ai/v1`にリクエストを送ります。OpenRouterを使う場合はモデルID `meta/muse-wonder`で、トークン単価はMeta公式と同じです。

料金は100万トークンあたり入力$4.00、キャッシュ入力$0.20、出力$20.00で、推論トークンも出力として課金されます。2026年11月6日時点の公表単価で計算すると、2,000トークン入力・1,500トークン出力の短い回答は1回約$0.038、80万トークンの長文書を読ませると1回約$3.28です。推論レベル（reasoning_effort）はまず`high`から始め、さらに深い推論が必要なときだけ`max`をResponses APIで指定します。

日本はMetaの利用制限地域に入っていないため、日本からアカウントを作って利用できます。2026年11月6日にキーを付けずに各エンドポイントを呼び出すと、ステータス確認だけが応答し、生成系はすべて401で止まりました。有効なキーでの生成結果はこの確認に含まれていないため、以下のリクエスト例はMetaの公式ドキュメントに沿って書いています。

## Muse Wonder APIで使えるモデル：muse-wonder-1.0のみ、Fullは対象外

Muse Wonderは2026年10月12日に公開されたMetaの上位モデルで、Model APIで使えるのは`muse-wonder-1.0`（Standardモード）だけです。Metaの[モデル一覧ページ](https://dev.meta.ai/docs/models)では、Muse Wonder Fullは「Model APIでは利用不可」とされ、Muse CodeのPower Usage（月$50）とMaximum Usage（月$200）でのみ使えます。推論レベルを`max`にしてもFullに切り替わるわけではありません。

`muse-wonder-1.0`は、テキスト、画像、動画、音声、PDFを入力でき、出力はテキストのみです。コンテキストは1,048,576トークンで、Metaはプレビュー版（preview）と位置づけているため、仕様や上限は変わる可能性があります。最大出力トークン数はMetaのドキュメントに数字がなく、OpenRouterのエンドポイント情報には943,718と載っています。いずれにしても、入力と出力（推論を含む）の合計がコンテキストに収まる必要があり、モデルの上限を超える出力を要求すると400エラーになります。

## Meta公式とOpenRouter、どちらで呼び出すか

どちらから呼んでも実際に推論するのはMetaで、トークン単価も同じです。違いが出るのは、支払い方法、データ保持の扱い、キーの管理です。2026年11月6日にOpenRouterの公開APIで`meta/muse-wonder`のエンドポイント情報を取得すると、提供元は「Meta」の1件だけで、トークン単価と検索の料金はMeta公式の料金表と同じ値でした。

| 項目 | Meta公式Model API | OpenRouter |
| --- | --- | --- |
| ベースURLとモデルID | `https://api.meta.ai/v1`、`muse-wonder-1.0` | `https://openrouter.ai/api/v1`、`meta/muse-wonder` |
| APIキー | dev.meta.aiで発行（`LLM_`で始まる） | OpenRouterで発行（`sk-or-v1-`で始まる）。Metaのエンドポイントには使えない |
| 支払い | カードで後払い。最低利用額なし | クレジットを前払いで購入。カード購入は5.5%（最低$0.80）の手数料 |
| データの扱い | Standardモードの内容はMetaのモデル学習に使われない。ゼロデータ保持（ZDR）は申請制 | OpenRouter側の保持ポリシーに従い、MetaのZDRは適用されない |
| リクエスト形式 | Responses・Chat Completions・Messagesの3形式 | OpenAI互換の形式。reasoning_effort、tools、structured_outputs、response_formatなどに対応 |
| Muse Wonder Full | なし | なし |

![Meta公式Model APIとOpenRouterの2つの経路。どちらもMetaが推論し、ベースURL・モデルID・キー・支払い・ZDRの扱いが異なる](https://blog.laozhang.ai/posts/ja/muse-wonder-api/img/meta-vs-openrouter-routes.webp)

ZDRが必要な場合や、Metaと直接の契約で請求を管理したい社内導入なら、Meta公式に直接つなぐほうが条件をそろえやすくなります。Metaの[ゼロデータ保持のヘルプ](https://dev.meta.ai/help/policies-and-privacy/zero-data-retention)は、ZDRがModel APIへの直接の呼び出しにだけ適用され、第三者プラットフォーム経由ではそのプラットフォームのポリシーに従うと明記しています。すでにOpenRouterで複数のモデルを使い分けていて、キーと支払いを1か所にまとめたい場合はOpenRouterが手早い選択です。ただし[OpenRouterの料金ページ](https://openrouter.ai/pricing)のとおり、カードでクレジットを買うたびに手数料がかかり、$10の購入では最低額$0.80が適用されて実質8.0%、$14.55以上の購入で5.5%になります。

## APIキーの発行から最初のリクエストまで

Meta公式のModel APIで最初の1回を通すまでの手順は次のとおりです。必要なのはModel APIのアカウントと、curl、Python 3.9以上、Node.js 18以上のいずれかです。

1. [dev.meta.ai](https://dev.meta.ai/)でModel APIのアカウントを作成します。
2. 管理者が請求設定でカードと事業者情報（正式な事業者名と住所）を登録します。法人でなければ、本人の氏名と郵送先住所で登録します。
3. ダッシュボードの**API keys** → **Create API key**でキーを作成します。キーは`LLM_数字ID_シークレット`の形式で、表示されるのは作成時の1回だけなので、その場で保管します。
4. キーを環境変数`MODEL_API_KEY`に設定します（macOS・Linuxなら`export MODEL_API_KEY="..."`）。
5. ベースURL `https://api.meta.ai/v1`（末尾にスラッシュを付けない）に、モデルID `muse-wonder-1.0`でリクエストを送ります。

curlでResponses APIを呼ぶ場合のリクエストは次の形です。推論レベルはResponses APIでは`reasoning.effort`として入れ子で指定します。

```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": "このPythonの関数でキューのメッセージが二重に処理される原因を挙げてください。"
  }'
```

OpenAI SDKやAnthropic SDK、LangChain、LiteLLMも使えますが、どれも`MODEL_API_KEY`を自動では読みません。クライアントを作るときに、ベースURLとキーを明示的に渡してください。PythonのOpenAI SDKなら次のようになります。

```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="このPythonの関数でキューのメッセージが二重に処理される原因を挙げてください。",
)
print(response.output_text)
```

同じチームのキーはレート制限を共有するので、用途ごとにキーを分けても上限は増えません。キーの失効や作り直しはダッシュボードの同じ画面で行います。

## Responses・Chat Completions・Messagesの違い：迷ったらResponses

Model APIには3つのリクエスト形式があり、どれも同じモデル、同じ認証、同じトークン単価です。Metaは[形式の選び方のページ](https://dev.meta.ai/docs/protocols)でResponses APIを標準の選択肢としていて、新しく書くコードならResponsesで始めるのが無難です。既存のコードがどの形式で書かれているかで選ぶと、書き換えが最小で済みます。

| 形式 | エンドポイント | 向いているコード | ターン間の推論の引き継ぎ | 検索グラウンディング・ツール検索 |
| --- | --- | --- | --- | --- |
| Responses | `POST /v1/responses` | 新規のコード、エージェント | あり（暗号化された推論アイテムか`previous_response_id`） | 使える |
| Chat Completions | `POST /v1/chat/completions` | OpenAIのmessages形式で書いた既存コード | 外部キーでは引き継がない | 使えない（関数ツールは使える） |
| Messages | `POST /v1/messages` | Anthropic SDK、Claude Code | 引き継ぐ（thinkingブロックを含む履歴をクライアントから再送） | 使える（組み込みツールの`web_search`・`tool_search`） |

Messages形式だけはベースURLの指定が異なり、Anthropic SDKには`/v1`を付けない`https://api.meta.ai`を渡します。Messages APIはサーバー側に会話を保持しないため、推論を次のターンに引き継ぐには、thinkingブロックを含む履歴を毎回クライアントから送り直します。Chat Completionsでは外部キーの場合に推論が引き継がれず、検索グラウンディングも使えないので、複数ターンのツール呼び出しで推論の流れを保ちたいなら、ResponsesかMessagesを選んでください。

## 推論レベル（reasoning_effort）の選び方：まずhigh、maxはResponsesで

迷ったら`high`から始めてください。Metaは[コーディングエージェント向けの設定ガイド](https://dev.meta.ai/docs/coding-agents)で`high`を「strong default」とし、`xhigh`と`max`をより深い推論が必要なときの選択肢としています。指定できる値は`minimal`、`low`、`medium`、`high`、`xhigh`、`max`で、`none`を送るとMuse Wonderは400を返します。パラメータを省略してもモデルが決めたレベルで推論しますが、その既定値は公開されていません。

コストと待ち時間の差は、第三者のArtificial Analysisが公開している[Muse WonderとClaude Opus 5.5の比較ページ](https://artificialanalysis.ai/models/releases/comparisons/muse-wonder-vs-claude-opus-5-5)（Intelligence Index v5.0.1、2026年11月6日時点）で確認できます。同じ評価タスクで、`high`は41点、1タスクあたり$4.56、最初の回答トークンまで9.83秒でした。`max`は44点、$6.95、21.19秒です。つまり`high`は`max`より1タスクあたり34.4%安く、最初の回答が2.16倍早く返り、その差は3点です。`high`より下のレベルについては同サイトにデータがありません。

推論トークンは出力トークンとして課金され、出力上限（Responsesの`max_output_tokens`、Chat Completionsの`max_completion_tokens`）にも含まれます。推論レベルを上げると、単価は同じでも出力が増えて1回の料金が上がる仕組みです。`max`を使うときはResponses APIで`reasoning: {"effort": "max"}`と指定してください。Metaの推論ガイドにある`max`の例はすべてResponses形式で、Chat Completionsのパラメータ表には`xhigh`までしか記載がありません。

## Muse Wonder APIの料金：用途別に1回いくらか

Muse Wonderの料金は、Metaの[料金とレート制限のページ](https://dev.meta.ai/docs/pricing-rate-limits)によると100万トークンあたり入力$4.00、キャッシュ入力$0.20、出力$20.00です。長いコンテキストでの割増はありません。Web検索によるグラウンディングを使うと、トークン代とは別に検索1,000回あたり$2.50がかかります。システムプロンプトなどMetaが内部で付け加える文脈は課金されず、`usage`にも含まれません。

下の表は、2026年11月6日に公表単価で再計算した1回あたりと1,000回あたりの料金です。トークン数は試算用に置いた値で、実際の推論トークンの量は推論レベルや内容によって変わります。

| 使い方 | トークン数 | 1回 | 1,000回 |
| --- | --- | --- | --- |
| 短い質問への回答 | 入力2,000・出力1,500 | $0.0380 | $38 |
| エージェントの1ターン（キャッシュなし） | 入力60,000・出力6,000 | $0.3600 | $360 |
| 同じ1ターンで入力のうち50,000がキャッシュ | 入力60,000（うち50,000キャッシュ）・出力6,000 | $0.1700 | $170 |
| 長い文書の読み込み | 入力800,000・出力4,000 | $3.2800 | $3,280 |
| Web検索つきの調べもの | 入力20,000・出力3,000・検索10回 | $0.1650 | $165 |

計算式は「入力トークン×$4 ＋ キャッシュ入力×$0.20 ＋ 出力×$20」を100万で割ったものです。エージェントの1ターンでは、60,000×$4÷100万＝$0.24と6,000×$20÷100万＝$0.12を足して$0.36になります。入力のうち50,000トークンがキャッシュに当たると、未キャッシュ10,000の$0.04、キャッシュ50,000の$0.01、出力$0.12の合計$0.17になり、52.8%下がります。キャッシュは設定不要で自動的に効くので、同じシステムプロンプトや長い前置きを毎回先頭に置くだけで効果が出ます。

![エージェントの1ターンの料金内訳。キャッシュなし$0.36がキャッシュありで$0.17になり、短い質問・Web検索つき・長い文書の1回あたり料金も並べた図](https://blog.laozhang.ai/posts/ja/muse-wonder-api/img/cost-per-request-cache.webp)

Metaの料金と請求のページには、無料枠や無料クレジットの記載はありません。最低利用額や前払いの義務もなく、使った分だけ課金されます。軽い処理まで全部Muse Wonderで回すと割高になるため、要約やサブエージェントのような大量・低遅延の処理は`muse-spark-1.3`（入力$1.25・キャッシュ入力$0.15・出力$4.25）に回すのが次の一手です。同じエンドポイントで、モデルIDを差し替えるだけで移せます。

レート制限はキーごとではなくチーム単位で、`muse-wonder-1.0`は毎分3,000リクエスト、毎分400万トークン（TPM）です。入力と出力の両方がTPMに数えられると仮定すると、上の表のエージェントの1ターンなら毎分約60回、80万トークンの文書読み込みなら毎分約4回で、リクエスト数より先にトークン数の上限に当たります。Playgroundでの試行もチームの上限に含まれます。

## 日本での提供条件と請求：制限地域外、カードで後払い

日本からはModel APIを利用できます。Metaの[地理的利用ポリシー](https://dev.meta.ai/legal/geographic-use-policy)（2026年10月12日更新）の利用制限地域に日本は含まれていません。ヘルプセンターは、Meta AIが提供され、請求に対応している国と地域の大半で使えると説明しています。制限地域からのアクセスや、技術的な手段でアクセス制御を回避することはポリシーで禁止されています。なお、Metaのモデル一覧ページは韓国ではMuse Wonderを利用できないとしていますが、ポリシーの名簿には韓国の記載がありません。

請求は後払いです。Metaの[請求設定のヘルプ](https://dev.meta.ai/help/billing/set-up-billing)によると、利用額は使った分だけ積み上がり、残高が支払いしきい値に達した時点でカードに請求されます。しきい値に達しなかった残りは、毎月1日に請求されます。支払いが続けて成功するとしきい値が上がることがあり、期限前に支払うこともできます。社内で予算を管理する場合は、月初の請求だけでなく、利用が多い月には月の途中でも請求が発生する点を経理と共有しておくと混乱しません。

## エラー401・402・403・404・429の意味と対処

Model APIのエラーは、OpenAI形式と同じ構造の`{"error": {"message", "type", "param", "code"}}`の形で返ります（Messages形式だけはAnthropicの形）。コードごとの意味は[エラー処理のドキュメント](https://dev.meta.ai/docs/error-handling)に沿うと次のとおりです。

| コード | 意味 | 対処 |
| --- | --- | --- |
| 401 `authentication_error` | キーがない、形式が違う（`LLM_`で始まらない）、失効した、打ち間違えた | `Authorization: Bearer`ヘッダーとキーを確認する |
| 402 `billing_error` | 残高不足、支払い方法の期限切れ、請求設定の不備 | ダッシュボードで請求設定とカードを確認する |
| 403 | キーにそのモデルや機能の権限がない | キーの権限を管理者に確認する |
| 404 | モデルIDの誤り、アクセス権がない、ベースURL末尾のスラッシュ | `muse-wonder-1.0`と`https://api.meta.ai/v1`（末尾スラッシュなし）にそろえる |
| 429 `rate_limit_error` | チームのRPMかTPMを超えた | 約500msから始める指数バックオフとジッターで再試行し、`Retry-After`があれば従う |

2026年11月6日（UTC 00:37）に、APIキーを付けずにcurlで各エンドポイントを呼び出した結果は次のとおりです。`GET /v1/status`だけはキーなしでHTTP 200を返し、`"service_status":"operational"`でしたが、モデルごとの状態を示す`model_statuses`は空でした。`/v1/models`、`/v1/chat/completions`、`/v1/responses`はすべて401で、本文は次の1行でした。

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

OpenRouter形式のキー（`sk-or-v1-…`）や、`LLM_`形式に似せた偽のキーを送っても同じ本文で、401の中身からはキーがないのか形式が違うのかを区別できません。`/v1/messages`はAnthropic形式の`{"error":{"message":"Unauthorized","type":"authentication_error"},"type":"error"}`を返しました。パスを`/v1/chat/completion`と打ち間違えた場合も404ではなく401が返ったので、認証はパスの判定より先に行われています。ドキュメントにある空本文の404は、有効なキーを付けて初めて見えるものと考えられます。障害を疑うときは、キーなしで呼べる`/v1/status`を先に確認すると切り分けが早くなります。

## Claude CodeとCodexでMuse Wonderを使う設定

Claude CodeはAnthropicのMessages形式で通信するため、Model APIのMessages APIにつなぎます。Metaのコーディングエージェント向けガイドに沿って、次の環境変数を設定してから`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"
```

キーは`ANTHROPIC_API_KEY`ではなく`ANTHROPIC_AUTH_TOKEN`に入れます。前者は`x-api-key`ヘッダーで送られ、Model APIが求める`Authorization: Bearer`にならないためです。opus・sonnet・haikuの各枠をMetaのモデルに割り当てておかないと、プランモードやサブエージェント、コミットメッセージ生成などがModel APIにないClaudeのモデルを呼ぼうとします。上の設定では、計画と複数ファイルの変更をMuse Wonderに、サブエージェントと軽い処理を安い`muse-spark-1.3`に振り分けています。

Codexは`~/.codex/config.toml`で、`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"`を書きます。OpenAIアカウントでサインイン済みの場合は、先に`/logout`しないとMetaのキーが使われません。どちらのエージェントでも、独自プロバイダーには単価情報がないため、画面上のコスト表示が$0のままになることがありますが、これは課金されていないという意味ではありません。

## Muse Wonder APIのよくある質問

### MetaのAPIで動画は作れますか？

作れません。2026年11月6日時点で、`muse-wonder-1.0`の出力はテキストのみで、Muse Videoの公式APIもありません。動画を作る方法は[Muse Video APIの使い方：公式APIなしの経路と60秒までの料金](https://blog.laozhang.ai/ja/posts/muse-video-api)で扱っています。

### MetaのMuseアプリとMuse Wonder APIは別物ですか？

別物です。一般向けのMuseは、スマートフォンアプリやmuse.aiで使う常駐型のAIエージェントです。Model APIは、開発者が自分のプログラムからモデルを従量課金で呼び出すサービスで、契約もキーも別になります。アプリ側の機能と日本での利用可否は[ChatGPT dots・Meta Muse・Grok Bot・Claude Duet比較：日本での可否](https://blog.laozhang.ai/ja/posts/chatgpt-dots-vs-meta-muse-vs-grok-bot)にまとめています。

### Muse Codeのサブスクリプションでコードから呼べますか？

呼べません。Muse Codeは月額制のターミナル用コーディングエージェントで、APIプランではありません。月額プラン（月$5〜$200）の認証情報はMuse Code CLIの中だけで使えるもので、2026年11月6日時点のMetaの[Muse Codeのサブスクリプションページ](https://dev.meta.ai/docs/muse-code/subscriptions)では、追加で発行したAPIキーは従量課金になると説明されています。サブスクリプションは初期設定でContributorモード（入力内容がMetaのモデル学習に使われるモード、オフにできる）になっている点も、API利用との違いです。アプリ・Muse Code・APIの各プランの料金は[Muse Wonder料金：アプリ$20・Muse Code$5〜・API従量の3択](https://blog.laozhang.ai/ja/posts/muse-wonder-pricing)で比較できます。

## 参考資料

本文で参照している外部ページを、登場順に並べています。最終更新日：2026-11-06。

- [Model APIダッシュボード](https://dev.meta.ai/) (dev.meta.ai)
- [モデル一覧ページ](https://dev.meta.ai/docs/models) (dev.meta.ai)
- [ゼロデータ保持のヘルプ](https://dev.meta.ai/help/policies-and-privacy/zero-data-retention) (dev.meta.ai)
- [OpenRouterの料金ページ](https://openrouter.ai/pricing) (openrouter.ai)
- [形式の選び方のページ](https://dev.meta.ai/docs/protocols) (dev.meta.ai)
- [コーディングエージェント向けの設定ガイド](https://dev.meta.ai/docs/coding-agents) (dev.meta.ai)
- [Muse WonderとClaude Opus 5.5の比較ページ](https://artificialanalysis.ai/models/releases/comparisons/muse-wonder-vs-claude-opus-5-5) (artificialanalysis.ai)
- [料金とレート制限のページ](https://dev.meta.ai/docs/pricing-rate-limits) (dev.meta.ai)
- [地理的利用ポリシー](https://dev.meta.ai/legal/geographic-use-policy) (dev.meta.ai)
- [請求設定のヘルプ](https://dev.meta.ai/help/billing/set-up-billing) (dev.meta.ai)
- [エラー処理のドキュメント](https://dev.meta.ai/docs/error-handling) (dev.meta.ai)
- [Muse Codeのサブスクリプションページ](https://dev.meta.ai/docs/muse-code/subscriptions) (dev.meta.ai)