ה-API של Meta Muse: מה מפתח באמת מקבל, ואילו מודלים של Muse הוא משרת

אין מוצר שנקרא ממש Muse API. ה-API שמגיש את מודלי Muse של Meta הוא Meta Model API, הוא עונה בכתובת https://api.meta.ai/v1, ומודלי Muse שמפתח יכול לקרוא להם דרכו הם Muse Spark 1.3 (זה ש-Meta ממליצה עליו כרגע), Muse Spark 1.2 ו-Muse Spark 1.1 — שני האחרונים שאתר זה מנתב, בתור meta/muse-spark-1.1 ו-meta/muse-spark-1.2. אם חיפשת "muse api" ורצית תשובה של שורה אחת, זו היא. שאר העמוד הזה הוא הפירוט שמאחורי זה: כמה עולה כל מודל למיליון טוקנים במחירון המפורסם של Meta, מה צריך שיהיה לך ביד לפני הקריאה הראשונה, מול מה נמדדת למעשה מגבלת הקצב, ולמה המספרים שעל כרטיס המנוי של Muse Code לא עוברים לחשבונית API.

יש לקרוא את זה כדף עזר ולא כידיעה חדשותית. Meta Model API פעיל, ומודלי Muse שבו ניתנים לקריאה כבר היום; אין כאן שום הכרזה, ואף דף בבלוג הזה לא השיב בעבר על שאלת הגישה הפרוגרמטית לסדרת המודלים הזו. כאשר נתון מגיע מהתיעוד של Meta עצמה, הדף הזה מציין זאת, וכאשר Meta אינה מפרסמת דבר, הדף מציין זאת במקום למלא את החלל.

מה זה בעצם "ה-Meta Muse API"?

ההגדרה של Meta עצמה היא משפט אחד: Model API הוא "פלטפורמת האינפרנס למודלים האחרונים של Meta, כולל Muse Wonder ו-Muse Spark." סדרת Muse מתארחת בפלטפורמה הזו ולא ב-API משלה, ולכן חיפוש אחר נקודת קצה ייעודית ל-Muse אינו מוביל לשום מקום — נקודת הקצה היא של Meta, ו-Muse היא משפחת מודלים אחת עליה.

המשטח הוא קונבנציונלי במכוון. שלושה פורמטים של בקשות מתועדים תחת מה ש-Meta מכנה משטחי Model API: Responses API, Chat Completions API ו-Messages API. הטענה המרכזית לגבי האינטגרציה היא ש-Model API הוא "תואם drop-in ל-SDK של OpenAI, ל-SDK של Anthropic, ול-CLIs של סוכנים תואמי OpenAI", עם השורה הנלווית שאין "לקוח מותאם אישית שצריך ללמוד". בפועל, המשמעות היא שינוי של base-URL ומפתח, לא שכתוב מחדש.

הפלטפורמה מספקת יותר מאשר סדרת Spark. לצד muse-spark-* היא חושפת את muse-wonder-1.0, muse-image-1.0, muse-voice-transcribe-1.0 ו-sam-3.1, כך שקורא שבונה פייפליין משולב יכול לגשת ליצירת תמונות, תמלול וסגמנטציה באותו אישור גישה. אחד מבני משפחת Muse אינו ניתן לקריאה כלל: Muse Glimmer הוא מודל במשקלים פתוחים "שנבנה כדי לרוץ על החומרה שלך", שמופץ כמשקלים ולא מוגש דרך ה-API, ו-Meta מחריגה אותו מנקודת הקצה של רשימת המודלים. אם השאלה שלך היא "האם אני יכול לקרוא ל-Glimmer", התשובה היא לא — אתה מוריד אותו.

שני דברים שאנשים נוטים לכלול בשגרה תחת "Muse API" הם מוצרים נפרדים ושייכים לעמודים אחרים. Muse Code הוא סוכן הקידוד של Meta למסוף ול-CI — הארנס הנמכר כמנוי, שהושק כבטא ב-2026-08-05 ויצא מבטא ב-2026-08-31 — והוא אינו API, אינו מודל, ואינו נדרש כדי לקרוא ל-API. העמוד muse-code של הבלוג הזה מכסה את הארנס, ו-meta-muse-code-terminal-coding-agent מכסה את הסוכן לעומק. מה שמופיע כאן הוא רק המשטח התכנותי.

המודלים שאפשר לקרוא להם, והתעריפים שפרסמה Meta

שישה מזהים חשובים ליצירת טקסט, והתעריפים שלהלן הם של Meta עצמה, שפורסמו בעמוד התמחור ומגבלות הקצב שלה בדולרים למיליון טוקנים. אלה מחירי מחירון של הספק, לא נתונים שעברו ביקורת בלתי תלויה.

• 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. אין גרסת Contributor של 1.1.

• muse-wonder-1.0 — מודל Muse המסוגל ביותר של Meta, המיועד לעבודה סוכנית לטווח ארוך: קלט 4.00$, פלט 20.00$, קלט במטמון 0.20$, מצב Standard בלבד, ו-Meta מצהירה במפורש ש"מצב Contributor אינו זמין עבור Muse Wonder ב-Model API."

מודלי Muse שאינם טקסט מתומחרים לפי יחידה ולא לפי טוקן: Muse Image במחיר $0.01 לתמונה, Muse Voice Transcribe במחיר $0.18 לשעה, ו-SAM 3.1 במחיר $2.50 ל-1,000 תמונות ו-$0.20 ל-1,000 פריימים. עיגון חיפוש באינטרנט, אם תפעילו אותו, הוא $2.50 ל-1,000 שאילתות חיפוש.

שתי הצהרות כלליות מופיעות מתחת לטבלה הזו וכדאי להכיר אותן לפני שאתם קובעים את הגודל של עומס עבודה. הראשונה היא "קלט שמור במטמון עולה פחות" — קריאות מהמטמון הן בערך עשירית מהקלט ב-Standard Spark, וכאחד מחמישים ב-Contributor. השנייה היא "אין תוספת מחיר להקשר ארוך", וזה חשוב כאן יותר מאשר ברוב הפלטפורמות מפני שהחלון של סדרת Spark הוא 1,048,576 אסימונים; מסמך ארוך לא מעביר אתכם לתמחור אחר.

בשאלה הזו, הבריף לעמוד הזה ציפה לניגוד: בין meta/muse-spark-1.1 ל-meta/muse-spark-1.2 אין מה לבחור מבחינת חלון או תעריף. Meta מפרסמת נתון הקשר אחד עבור הקו ושורת תעריף אחת שמכסה "muse-spark-1.3 / 1.2 / 1.1." מה שמבדיל ביניהם הוא הצ'קפוינט — 1.2 הוא המאוחר יותר — ובפלטפורמה של Meta, קיומו של וריאנט Contributor עבור 1.2 ולא עבור 1.1. כל מי שאומר לך שהשניים נבדלים באורך ההקשר או במחיר לא קורא את אותם כרטיסים.

מה צריך להיות לך ביד כדי לבצע את השיחה הראשונה

כל מה שבמדור הזה לקוח מהתיעוד של Meta עצמה. במקום שבו בדרך כלל היה אמור להיכנס משהו ש-Meta אינה אומרת, העמוד הזה משאיר את הפער גלוי לעין במקום להמציא מבנה בקשה סביר.

קבלת גישה

גישה היא חשבון Model API בתוספת מפתח. המדריך המהיר של Meta מפנה אותך ללוח הבקרה: "קבל מפתח מלוח הבקרה של Model API → מפתחות API → צור מפתח API." עמוד האימות מוסיף את החלק שאנשים מפספסים: "העתק את המפתח מיד. אתה רואה אותו רק פעם אחת." מפתח מוצג בצורה LLM|607358788350350|nx9.....LJY, ו-Meta לעולם אינה מסבירה מה משמעות המקטעים. אפשר לבטל מפתח מאותו לוח בקרה — "מחיקת מפתח אחד מותירה מפתחות אחרים של הצוות ללא שינוי" — וזה הטיעון של Meta להנפיק מפתח אחד לכל אפליקציה במקום לשתף מפתח אחד.

סכימת האימות

טוקן Bearer, בכותרת Authorization:

• כותרת — Authorization: Bearer $MODEL_API_KEY

• כתובת URL בסיס — https://api.meta.ai/v1, כאשר https://api.meta.ai מתועד עבור רתמות בפורמט Anthropic

• משתנה סביבה — MODEL_API_KEY, שאותו Meta מורה לך להגדיר ולא לקודד ישירות בקוד, לצד העצה הרגילה "לעולם אל תעלה מפתחות לבקרת גרסאות"

• הסתייגות לקוח — Meta מצהירה במפורש: "ה-SDK של O​penAI לא קורא אוטומטית את MODEL_API_KEY," לכן או שאתה מעביר api_key במפורש, או שאתה מייצא OPENAI_API_KEY עם מפתח ה-Meta שלך

נקודות הקצה המופיעות בתיעוד ה־API של Meta כוללות POST /v1/chat/completions ו־POST /v1/responses לטקסט, /v1/images/generations ו־/v1/images/edits עבור Muse Image, ‏POST /v1/asr/transcribe וכן WebSocket בזמן אמת בכתובת wss://api.meta.ai/v1/asr/realtime לתמלול, ו־POST /v1/files להעלאות. אין SDK שפורסם על ידי Meta: עמוד ה־SDKs מפרט את הלקוחות של OpenAI ו־Anthropic, והעמדה של Meta היא תאימות ולא ספרייה של צד ראשון. אם חיכיתם לחבילת meta שתתקינו, אין כזו.

מגבלות קצב, וכנגד מה הן נמדדות

זו השאלה שמי שמחפש "muse code api key" בדרך כלל באמת שואל, ו-Meta עונה עליה בצורה מדויקת יותר מרוב הספקים. המגבלות המפורסמות הן לפי צוות, לא לפי מפתח: "מפתחות באותו צוות חולקים מגבלות קצב." שני מהנדסים שמנפיקים שני מפתחות לא מכפילים את התקרה — הם מחלקים אותה.

• muse-spark-1.3, muse-spark-1.2, muse-spark-1.1 — 3,000 בקשות בדקה ו-4,000,000 טוקנים בדקה

• גרסאות Contributor — 150 בקשות בדקה ו-3,000,000 טוקנים בדקה

• muse-wonder-1.0 — 3,000 RPM ו-4,000,000 TPM; muse-image-1.0 — 150 RPM ללא הגבלת טוקנים

• תגובות רקע — תקרה נפרדת של 600 הגשות בדקה לכל צוות

• במקרה של הפרה — HTTP 429 עם כותרת Retry-After, ותגובות הנושאות x-ratelimit-limit-tokens, x-ratelimit-remaining-tokens, x-ratelimit-limit-requests ו-x-ratelimit-remaining-requests

מפתח API של Muse Code ומפתח API של Model הם אותו סוג של אישור. ההרצה הראשונה של Muse Code מבקשת ממך לבחור בין התחברות בדפדפן לבין הדבקת מפתח API — "לסקריפטים ול-CI, יש להשתמש במפתח API" — וסדר החיפוש המתועד שלה הוא META_API_KEY תחילה, לאחר מכן מפתח שמור, ולאחר מכן סשן דפדפן שמור, כאשר מפתח API תמיד גובר על התחברות בדפדפן.

צורת החיוב: טוקנים נמדדים, לא מושב

זה הקטע שקוראים טועים בו, ולכן כדאי להיות בוטים לגביו. מנוי Muse Code הוא מקום חודשי במחיר קבוע עם מחירון; Model API הוא צריכה מדודה בחשבון. עמוד האימות של Meta מציין את המודל ישירות — "החיוב של Meta Model API מבוסס שימוש: אתה מחויב על הטוקנים שהבקשות שלך צורכות" — כשקלט ופלט נספרים בנפרד, כשהפלט בדרך כלל עולה יותר, והתעריפים משתנים לפי מודל. הכסף נגבה כאשר היתרה שלך מגיעה לסף התשלום שלך, וכל יתרה שנותרת מחויבת אוטומטית בראשון לחודש. Meta מוסיפה שיש "אין מינימומים או התחייבות מראש".

אסימטריה אחת בין שני המוצרים קלה להיתקל בה. Meta מציינת ש-Muse Code "מנויים כברירת מחדל למצב Contributor, ואפשר להפעיל או לכבות אותו בהגדרות." ב-API ברירת המחדל הפוכה: מקבלים תמחור Standard ותנאי Standard, אלא אם כן פונים במכוון למזהה מודל -contributor. לכן קורא שהריץ את Muse Code לפי תנאי Contributor כל הזמן, ואז מחליף למפתח ב-muse-spark-1.2, ינחת על כרטיס התעריפים של Standard בערך פי שנים-עשר ממחיר הקלט, בלי לשנות דבר מלבד הלקוח.

מה ש-Meta לא מציינת הוא אם מנוי מקנה לך שימוש כלשהו ב-API. שום דבר בעמוד האימות, בעמוד התמחור או בעמוד המוצר לא מציין שתוכנית כוללת אסימוני Model API או קרדיטים; עמוד ה-API מתייחס למפתח כאל שיטת אימות בלבד, ועמודי המנוי הם נושא בפני עצמם. אל תניחו ששני הדברים ניתנים להחלפה, ואל תעבירו את הנתון החודשי של המנוי לתקציב אסימונים — הם עונים על שאלות שונות.

בכל הנוגע לחינם: אין שכבה חינמית מתועדת עבור Model API, אין קרדיט ניסיון ואין מכסה חינמית. גם עמוד המוצר של סוכן הקידוד אינו מפרט תוכנית חינם. מצב Contributor מוזל, לא חינם — הניסוח של Meta הוא תמחור מוזל "בתמורה להרשאה להשתמש בתוכן שלך כדי לאמן מודלים עתידיים של Meta", המכסה את הפרומפטים, הקוד, הקבצים וההקשר שאתה שולח וכן את התגובות שאתה מקבל בחזרה. זהו סחר חליפין, לא מתנה. אם עמוד אומר לך של-Meta Muse API יש שכבה חינמית, הוא לא קורא את עמוד התמחור של Meta.

מה המאפיין הזה מנתב

אנו מספקים שני מודלים מהקו הזה, וטענת הזמינות בעמוד זה מצומצמת במכוון. שניהם זמינים בקטלוג היום: meta/muse-spark-1.1 ו-meta/muse-spark-1.2. לשניהם אותו חלון הקשר של 1,048,576 טוקנים שמפרסמת Meta, ו-1.2 הוא הצ'קפוינט המאוחר יותר. התעריפים המפורסמים שלנו עבורם הם מחיר המחירון של Meta המועבר הלאה בתוספת של 0% — $1.25 למיליון טוקני קלט, $4.25 למיליון טוקני פלט ו-$0.15 למיליון קריאות מהמטמון — וזה כל העניין בהסדר העברה: שינוי בתעריף של ספק נכנס לתוקף כאן באותו יום, בלי תמחור מחדש מצידנו.

מה שזה נותן למפתח הוא לא הנחה; זו אינטגרציה אחת פחות. Muse Spark נמצא מאחורי נקודת קצה אחת המכסה 200+ מודלים, כך שהוספתו לפייפליין היא לא חוזה שני, מפתח שני או מערכת חיוב שנייה, ובקשה שנכשלת מול ספק אחד עוברת אוטומטית לספק אחר במקום להציג 429 למשתמשים שלך. זה חשוב יותר מהרגיל עם החלפת מודל לא מוכחת: זו דרך להפעיל את meta/muse-spark-1.2 על עומס עבודה אמיתי לפני שמתחייבים לנתיב הזה.

שני דברים אינם ניתנים לניתוב כאן, והדף הזה לא ירכך את זה. meta/muse-spark-1.3 אינו בקטלוג שלנו — אם 1.3 הוא מה שאתם צריכים, פנו ישירות ל-Meta. ו-meta/muse-code אינו מזהה מודל בכלל, לא בפלטפורמה של Meta ולא בשלנו, כי Muse Code הוא הארנס ולא מודל; הוא לא יכול להיות יעד ניתוב. גם צ'קפוינטים בדרג Contributor אינם מנותבים כאן.

מה שמטא לא מתעדת

כמה דברים שמפתח היה מצפה להם באופן סביר פשוט נעדרים מתיעוד ה-API של Meta, והגרסה הכנה של הדף הזה אומרת זאת במקום לשרטט אותם.

• ארגונים ופרויקטים — אין מושג של ארגון או פרויקט בדף האימות, אין היררכיה, ואין דרך להקצות מפתח לאחד מהם. הקיבוץ היחיד ש-Meta מתארת הוא צוות.

• היקפי מפתח — ללא ערכות הרשאות, ללא הגבלות לפי משאב, ללא מפתחות לקריאה בלבד. כל מפתח הוא מפתח מלא, ולכן העצה של Meta עצמה היא מפתח אחד לכל אפליקציה.

• משך חיי מפתח ורוטציה — ביטול מתועד (מוחקים אותו בלוח הבקרה); רוטציה היא רק המלצה ("בטלו וסובבו מיד"), ללא תפוגה, TTL או נוהל גלגול בשום מקום.

• ערכת SDK של צד ראשון — לא פורסמה אף אחת; טענת התאימות היא סיפור האינטגרציה, ו-Meta לא אומרת שתהיה כזו.

• שימוש בחינם — ללא מסלול חינמי, ללא קרדיטים, ללא תקופת ניסיון, כמתואר לעיל.

• מזהה API עבור Muse Glimmer — עמוד המודלים אינו מפרט מזהה, ו-Meta מחריגה אותו מנקודת הקצה של המודלים, מכיוון שהוא מופץ כמשקולות.

אם הסיבה שלך לחיפוש הזה הייתה אחד מהפערים האלה, התשובה היא שהמידע אינו מפורסם, ועמוד גרוע יותר היה מנחש סכימת תחום-מפתח או נקודת קצה של רוטציה ומשאיר אותך לגלות את הניחוש בשעה 2 לפנות בוקר. לגבי מה שכן מפורסם, התמונה שלמה מספיק כדי לבנות עליה: כתובת בסיס קונבנציונלית ב-https://api.meta.ai/v1, מפתח Bearer שאתה יוצר בעצמך, תאימות מיידית עם לקוחות ה-O​penAI וה-A​nthropic, מגבלות קצב מתועדות לפי צוות, וטבלת תעריפים שבה שני ה-checkpoints של Muse Spark שהאתר הזה מגיש זהים הן בחלון והן במחיר.

עמוד ה-muse-code של הבלוג הזה סוקר את ההארנס לעומק; העמוד הזה הוא רק המשטח הפרוגרמטי.

פערים כמו אלה הם גם המקום שבו מתגלים מצבי כשל: התקריות המתועדות של AI וכשלי סוכנים סביב מודלים בסוג הזה נאספים בthe OrcaRouter AI Incident Archive, שבו כל רשומה נושאת את המקורות שלה, חומרה, דירוג מהימנות ודגל מחלוקת.