Meta Muse API：開発者が実際に手にできるもの、そしてそれがどのMuseモデルを提供しているのか

文字通り「Muse API」という名前の製品は存在しません。Meta の Muse モデルを提供している API はMeta Model APIで、https://api.meta.ai/v1 で応答し、開発者がそこで呼び出せる Muse モデルはMuse Spark 1.3（Meta が現在推奨しているもの）、Muse Spark 1.2、Muse Spark 1.1です。後ろの2つは本サイトが meta/muse-spark-1.1 および meta/muse-spark-1.2 としてルーティングしています。「muse api」で検索して一行の答えを求めていたなら、それが答えです。このページの残りはその背後にある詳細です。Meta が公開している料金表で各モデルが100万トークンあたりいくらなのか、最初の呼び出しの前に何を用意しておく必要があるのか、レート制限が実際には何に対して測定されるのか、そして Muse Code のサブスクリプションカードに載っている数字がなぜ API の請求には引き継がれないのか、について説明します。

これはニュースとしてではなく、リファレンスページとして読んでください。Meta Model APIは稼働中で、その上のMuseモデルは今日から呼び出し可能です。ここにあるのは告知ではなく、このブログのどのページも、これまでこのモデルラインのプログラムによるアクセスの問いに答えたことはありません。数値がMeta自身のドキュメントに由来する場合は、このページはそう明記します。Metaが何も公表していない場合は、空白を埋めるのではなく、その旨をこのページに記します。

「the Meta Muse API」とは実際には何なのか

Meta自身の定義はわずか一文だ。Model APIとは「Muse WonderやMuse Sparkを含む、Metaの最新モデル向けの推論プラットフォーム」である。Museシリーズは独自のAPI上ではなく、このプラットフォーム上でホストされている。だからこそ、Muse専用のエンドポイントを検索しても何も見つからない——エンドポイントはMetaのものであり、Museはその上に載るモデルファミリーの一つにすぎない。

このサーフェスは意図的に従来型である。Meta が Model API surfaces と呼ぶものの下では、3 つのリクエスト形式が文書化されている。Responses API、Chat Completions API、Messages API である。目玉となる統合の主張は、Model API が「OpenAI SDK、Anthropic SDK、および OpenAI 互換のエージェント CLI とドロップイン互換」であり、「学習すべきカスタムクライアントはない」という一文が添えられているというものだ。実際には、それは書き換えではなく、ベース URL の変更とキーを意味する。

このプラットフォームが提供するのは、Sparkラインだけではありません。muse-spark-* に加えて、muse-wonder-1.0、muse-image-1.0、muse-voice-transcribe-1.0、sam-3.1 も公開しているため、混在パイプラインを構築する読者は、同じ認証情報で画像生成、文字起こし、セグメンテーションにアクセスできます。Museファミリーの1つは、まったく呼び出せません。Muse Glimmerは「自分のハードウェアで実行するために作られた」オープンウェイトモデルで、APIで提供されるのではなくウェイトとして配布されており、Metaはmodels listエンドポイントからこれを除外しています。「Glimmerを呼び出せるか」という質問なら、答えはノーです。ダウンロードするものです。

人々がよく「Muse API」に一括りにする2つのものは、別々の製品であり、別のページに属します。Muse Codeは、ターミナルとCI向けのMetaのコーディングエージェントです — サブスクリプションとして販売されるハーネスで、2026-08-05にベータ版としてリリースされ、2026-08-31にベータ版から外れました — また、それはAPIでもモデルでもなく、APIを呼び出すために必須でもありません。このブログのmuse-codeページではハーネスを、meta-muse-code-terminal-coding-agentではエージェントを詳しく扱っています。以下で扱うのは、プログラムから利用できる部分だけです。

呼び出せるモデルと、Metaが公開している料金

テキスト生成では6つのIDが重要であり、以下のレートはMeta自身が料金・レート制限ページで公表している、100万トークンあたりのドル建ての料金です。これらはベンダーによる定価であり、第三者による監査を受けた数値ではありません。

• muse-spark-1.3 — Metaはこれを「エージェント型ワークフロー向けに調整された最新バージョン」と呼び、「新しい作業に推奨」と位置づけています。1,048,576トークンのコンテキスト。標準モード: 入力$1.25、出力$4.25、キャッシュ入力$0.15。

• muse-spark-1.2 — Metaのモデルページでは、これを率直に「前のバージョン」と説明している。1,048,576トークンのコンテキストも、Standard料金も同じだ。

• muse-spark-1.1 — 「オリジナル版」であり、Standardモードのみ。コンテキストウィンドウも同じ、Standard料金も同じです。

• muse-spark-1.3-contributor と muse-spark-1.2-contributor — 割引ティア：入力 $0.10、出力 $0.20、キャッシュ入力 $0.002。1.1 には Contributor バリアントはありません。

• muse-wonder-1.0 — Meta で最も高性能な Muse モデル。長期間にわたるエージェント型作業向けに位置づけられており、入力 $4.00、出力 $20.00、キャッシュ入力 $0.20、Standard モードのみです。また Meta は「Contributor モードは Model API の Muse Wonder では利用できません」と明確に述べています。

• テキスト以外のMuseモデルは、トークン単位ではなくユニット単位で課金されます。Muse Imageは画像1枚あたり$0.01、Muse Voice Transcribeは1時間あたり$0.18、SAM 3.1は画像1,000枚あたり$2.50、フレーム1,000あたり$0.20です。ウェブ検索グラウンディングは、有効にした場合、検索クエリ1,000件あたり$2.50です。

その表の下には 2 つの一般的な記述があり、ワークロードのサイズを見積もる前に知っておく価値があります。1 つ目は「キャッシュされた入力のコストはより低い」です。Standard Spark ではキャッシュ読み取りは入力のおよそ 10 分の 1、Contributor では 50 分の 1 です。2 つ目は「長いコンテキストに対する追加料金はない」です。これはほとんどのプラットフォームよりもここで重要です。なぜなら、Spark ラインのウィンドウは 1,048,576 トークンであり、長いドキュメントでも別の価格帯に移行することはないからです。

このページのブリーフが対比を想定していた点について言えば、meta/muse-spark-1.1 と meta/muse-spark-1.2 の間には、ウィンドウでもレートでも、選ぶべき違いは何もない。Meta はこのラインについてコンテキストの数値を1つだけ公表しており、レート行も「muse-spark-1.3 / 1.2 / 1.1」を対象とする1行だけだ。両者を分けるのはチェックポイント——1.2 のほうが新しい——であり、Meta のプラットフォーム上では、1.2 には Contributor バリアントがあり、1.1 にはないという点だ。この2つがコンテキスト長や価格で異なると言う人は、同じカードを読んでいない。

最初の電話をかけるために手元に用意するもの

このセクションの内容はすべてMeta自身のドキュメントに基づいています。Metaが言及していない事柄が通常なら置かれるはずの箇所では、このページは、もっともらしいリクエストの形をでっち上げるのではなく、その空白を目に見える形で残します。

アクセスの取得

アクセスに必要なのは、Model APIアカウントとキーです。Metaのクイックスタートでは、ダッシュボードへ誘導されています。「Model APIダッシュボードからキーを取得 → APIキー → APIキーを作成」。認証ページは、多くの人が見落とす点を補足しています。「キーはすぐにコピーしてください。一度しか表示されません」。キーは LLM|607358788350350|nx9.....LJY という形式で表示され、Metaは各セグメントが何を意味するのか決して説明していません。同じダッシュボードからキーを無効化できます —「1つのキーを削除しても、他のチームキーには影響しません」— これは、1つのキーを共有するのではなく、アプリケーションごとに1つのキーを発行すべきだというMetaの主張です。

認証スキーム

Bearer token、Authorizationヘッダー内:

• ヘッダー — Authorization: Bearer $MODEL_API_KEY

• ベースURL — https://api.meta.ai/v1、https://api.meta.ai は A​nthropic 形式のハーネス向けに文書化されています

• 環境変数 — MODEL_API_KEY。Meta はハードコードするのではなく設定するよう指示しており、併せて「キーをバージョン管理にコミットしない」という定番の注意喚起もある

• クライアント側の注意点 — Meta は「OpenAI SDK は MODEL_API_KEY を自動では読み取らない」と明確に述べているため、api_key を明示的に渡すか、Meta キーとともに OPENAI_API_KEY をエクスポートする必要があります

Meta のリファレンスに記載されているエンドポイントには、テキスト用の POST /v1/chat/completions と POST /v1/responses、Muse Image 用の /v1/images/generations と /v1/images/edits、文字起こし用の POST /v1/asr/transcribe と wss://api.meta.ai/v1/asr/realtime のリアルタイム WebSocket、アップロード用の POST /v1/files が含まれます。Meta が公開している SDK はありません。SDK ページには OpenAI クライアントと Anthropic クライアントが掲載されており、Meta の姿勢はファーストパーティのライブラリを提供することではなく互換性にあります。インストールできる Meta のパッケージを待っていたとしても、そんなものはありません。

レート制限と、それが何を基準に測定されるか

これは「muse code api key」を検索する人がたいてい本当に尋ねている質問であり、Metaはほとんどのベンダーよりも正確に答えています。公開されている制限はチーム単位であり、キー単位ではありません。「同じチームのキーはレート制限を共有します。」2人のエンジニアが2つのキーを発行しても、上限は2倍にはならず、分割されるだけです。

• muse-spark-1.3、muse-spark-1.2、muse-spark-1.1 — 毎分3,000リクエストおよび毎分4,000,000トークン

• Contributorバリエーション — 1分あたり150リクエスト、1分あたり3,000,000トークン

• muse-wonder-1.0 — 3,000 RPM および 4,000,000 TPM；muse-image-1.0 — トークン上限なしの150 RPM

• バックグラウンド応答 — チームごとに毎分600件の送信という別枠の上限

• 違反時 — Retry-Afterヘッダー付きのHTTP 429、およびx-ratelimit-limit-tokens、x-ratelimit-remaining-tokens、x-ratelimit-limit-requests、x-ratelimit-remaining-requestsを含むレスポンス

Muse Code API キーとモデル API キーは同じ種類の認証情報です。Muse Code の初回実行時には、ブラウザーでのサインインを選ぶか、API キーを貼り付けるかを求められます —「スクリプトや CI では API キーを使用してください」— また、その文書化された検索順序は META_API_KEY が最初で、次に保存されたキー、次に保存されたブラウザーセッションであり、API キーは常にブラウザーサインインより優先されます。

課金形態：シート単位ではなく、従量制のトークン

ここが読者の誤解しやすいところなので、率直に言っておく価値がある。Muse Codeのサブスクリプションは、料金表に基づく月額固定のシート制だ。Model APIはアカウント単位の従量課金である。Metaの認証ページはそのモデルを直接こう説明している——「Meta Model APIの請求は使用量ベースです。リクエストが消費するトークンに対して請求され、入力と出力は別々にカウントされ、通常は出力の方が高く、料金はモデルごとに異なります」。残高が支払いしきい値に達すると請求が発生し、残額は毎月1日に自動的に請求される。Metaはさらに「最低額や前払いのコミットメントはありません」と付け加えている。

2つの製品間の非対称性のうち1つは、うっかりつまずきやすい。Metaは、Muse Codeについて「サブスクリプションはデフォルトでContributorモードになり、設定でオンまたはオフにできます」と述べている。APIではデフォルトは逆で、意図的に -contributor モデルIDを指定しない限り、Standard価格とStandard規約が適用される。そのため、これまでずっとContributor規約でMuse Codeを実行してきた読者が、muse-spark-1.2のキーに差し替えると、クライアント以外は何も変更していないのに、入力価格のおよそ12倍のStandard料金表に乗ってしまう。

Metaが明言していないのは、サブスクリプションによって何らかのAPI利用の権利が与えられるかどうかだ。認証ページ、料金ページ、製品ページのいずれにも、プランにModel APIのトークンやクレジットが含まれるとは書かれていない。APIページはキーを純粋に認証手段として扱っており、サブスクリプションページはそれ自体が別の主題である。両者が相互に置き換え可能だと想定してはならず、サブスクリプションの月額の数字をトークン予算に持ち込んではならない — それらは異なる問いに答えているのだ。

無料について：Model API には無料枠の記載も、トライアルクレジットも、無料の利用枠もない。コーディングエージェントの製品ページにも無料プランの記載はない。Contributor mode は割引であって無料ではない。Meta の説明は、「あなたのコンテンツを将来の Meta モデルのトレーニングに使用する許可と引き換え」の割引価格というもので、あなたが送信するプロンプト、コード、ファイル、コンテキスト、そして返ってくる応答が対象になる。それは取引であり、無償提供ではない。もし Meta Muse API に無料枠があると書いているページがあれば、それは Meta の価格ページを読んでいない。

このプロパティがルーティングするもの

このラインから2つのモデルを提供しており、このページの可用性に関する記載は意図的に限定しています。どちらも本日時点でカタログ上で稼働しています：meta/muse-spark-1.1 と meta/muse-spark-1.2。どちらもMetaが公表している同一の1,048,576トークンのコンテキストウィンドウを備えており、1.2がより新しいチェックポイントです。当社が公表しているこれらの料金は、Metaのリスト価格を0%のマークアップでそのまま適用したものです — 入力トークン100万あたり$1.25、出力トークン100万あたり$4.25、キャッシュ読み取り100万あたり$0.15 — これがパススルー契約の狙いそのものです。ベンダーの料金改定は同日にここへ反映され、当社側で再価格設定を行うことはありません。

それが開発者にもたらすのは割引ではなく、統合がひとつ減ることだ。Muse Sparkは200以上のモデルをカバーする単一のエンドポイントの背後にあり、パイプラインに追加しても2つ目の契約、2つ目のキー、2つ目の請求関係は不要で、あるプロバイダーで失敗したリクエストは自動的に別のプロバイダーへフェイルオーバーして、ユーザーに429を返すことはない。これは、実績のないモデルへの差し替えではいつも以上に重要だ。meta/muse-spark-1.2を、その道にコミットする前に実際のワークロードで試す方法になるからだ。

ここでは2つの項目がルーティング不可であり、このページはその事実をやわらげることはしません。meta/muse-spark-1.3 は当社のカタログにありません。1.3 が必要な場合は、Meta に直接お問い合わせください。また、meta/muse-code は、Meta のプラットフォームでも当社のものでも、そもそもモデル ID ではありません。Muse Code はモデルではなくハーネスだからです。ルーティング先にはできません。Contributor-tier のチェックポイントもここではルーティングされません。

Metaが文書化していないこと

開発者が当然期待するであろういくつかのことは、Meta の API ドキュメントには単に存在せず、このページの正直な版は、それらを描き込むのではなく、そのことを述べている。

• 組織とプロジェクト — 認証ページには組織やプロジェクトという概念がなく、階層もなく、キーのスコープをいずれかに限定する方法もありません。Meta が説明する唯一のグループ化はチームです。

• キーのスコープ — 権限セットなし、リソースごとの制限なし、読み取り専用キーなし。すべてのキーは完全なキーであり、だからこそ Meta 自身の助言はアプリケーションごとに 1 つのキーなのです。

• 鍵の有効期間とローテーション — 失効は文書化されている（ダッシュボードで削除する）。ローテーションは助言のみ（「直ちに失効させてローテーションする」）で、有効期限、TTL、ロールオーバー手順はどこにもない。

• ファーストパーティSDK — 未公開。互換性の主張が統合ストーリーのすべてであり、Metaはそれが提供されるとは述べていない。

• 無料利用 — 無料枠もクレジットもトライアルもなし、上記のとおり。

• Muse Glimmer の API ID — モデルページには ID が掲載されておらず、Meta はこれを models エンドポイントから除外している。ウェイトとして配布されるためだ。

これを検索した理由がそうした情報の欠落のひとつだったのなら、答えは「その情報は公開されていない」です。もっと出来の悪いページなら、キースコープの仕組みやローテーションエンドポイントを推測で書き、午前2時にその推測に気づかされる羽目になっていたでしょう。公開されている内容だけでも、それをもとに開発を進められるだけの全体像は十分に揃っています。慣例的なベースURLは https://api.meta.ai/v1、自分で作成するBearerキー、OpenAIおよびAnthropicのクライアントとのドロップイン互換性、文書化されたチームごとのレート制限、そしてこのサイトが提供する2つのMuse Sparkチェックポイントがウィンドウと価格の両方で同一である料金表です。

このブログのmuse-codeページはハーネスを扱っており、詳しい説明はそちらにあります。このページはプログラムから操作できる部分にすぎません。

このようなギャップは、障害モードが表面化する場所でもあります。このクラスのモデルに関する、文書化されたAIインシデントやエージェント障害は、OrcaRouter AIインシデントアーカイブに収集されており、各エントリには独自の情報源、重大度、信頼度グレード、および係争中フラグが付されています。