واجهة برمجة تطبيقات 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 «متوافق للاستبدال المباشر مع OpenAI SDK وAnthropic SDK وواجهات CLI للوكلاء المتوافقة مع OpenAI»، مع الجملة المرافقة التي تقول إنه «لا يوجد عميل مخصص يجب تعلّمه». عمليًا، يعني ذلك تغييرًا في عنوان 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

ستة معرّفات مهمة لتوليد النصوص، والأسعار الواردة أدناه هي أسعار ميتا نفسها، المنشورة على صفحة التسعير وحدود المعدل الخاصة بها، بالدولار لكل مليون رمز. وهي أسعار قائمة المورّد، وليست أرقامًا مدقَّقة بشكل مستقل.

• 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 — «النسخة الأصلية»، والوضع القياسي فقط. نفس نافذة السياق، ونفس الأسعار القياسية مرة أخرى.

• 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 بصراحة بأن «O​penAI SDK لا يقرأ MODEL_API_KEY تلقائيًا»، لذا إما أن تمرّر api_key صراحةً أو تصدّر OPENAI_API_KEY باستخدام مفتاح Meta الخاص بك

تشمل نقاط النهاية المذكورة في مرجع 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 رمز في الدقيقة

• أصناف المساهم — 150 طلبًا في الدقيقة و3,000,000 توكن في الدقيقة

• muse-wonder-1.0 — 3,000 دورة في الدقيقة و4,000,000 رمز في الدقيقة؛ muse-image-1.0 — 150 دورة في الدقيقة دون حد أقصى للرموز

• الاستجابات الخلفية — حد أقصى منفصل قدره 600 عملية إرسال في الدقيقة لكل فريق

• عند التجاوز — HTTP 429 مع ترويسة Retry-After، واستجابات تحمل x-ratelimit-limit-tokens وx-ratelimit-remaining-tokens وx-ratelimit-limit-requests وx-ratelimit-remaining-requests

مفتاح Muse Code API ومفتاح Model API هما من النوع نفسه من بيانات الاعتماد. عند أول تشغيل لـ 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 mode مخفض، وليس مجانيًا — صياغة 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 ليست موجّهة هنا أيضًا.

ما لا توثقه Meta

هناك عدة أمور يتوقعها المطوّر بشكل معقول، وهي غائبة ببساطة عن توثيق API الخاص بـ Meta، والنسخة الصادقة من هذه الصفحة تقول ذلك بدلًا من التطرق إليها بإيجاز.

• المؤسسات والمشاريع — لا يوجد مفهوم للمؤسسة أو المشروع في صفحة المصادقة، ولا تسلسل هرمي، ولا طريقة لتحديد نطاق مفتاح لواحد منها. التجميع الوحيد الذي تصفه Meta هو فريق.

• نطاقات المفاتيح — لا مجموعات أذونات، ولا قيود لكل مورد، ولا مفاتيح للقراءة فقط. كل مفتاح هو مفتاح كامل، ولهذا فإن نصيحة Meta نفسها هي استخدام مفتاح واحد لكل تطبيق.

• عمر المفتاح وتدويره — الإبطال موثّق (احذفه من لوحة التحكم)؛ التدوير مجرد نصيحة ("أبطِل ودوّر فورًا")، دون أي انتهاء صلاحية أو TTL أو إجراء تبديل في أي مكان.

• SDK من الطرف الأول — لم يُنشر أي منها؛ فادعاء التوافق هو قصة التكامل، وميتا لا تقول إنه سيكون هناك واحد.

• استخدام مجاني — لا توجد فئة مجانية، ولا أرصدة، ولا نسخة تجريبية، كما ورد أعلاه.

• معرّف API لـ Muse Glimmer — لا تُدرج صفحة النماذج أي معرّف، وتستبعده Meta من نقطة نهاية النماذج، لأنه يُوزّع كأوزان.

إذا كان سبب بحثك عن هذا هو أحد تلك الفجوات، فالجواب هو أن المعلومات غير منشورة، وكانت صفحة أسوأ ستخمّن مخطط تحديد نطاق المفتاح أو نقطة نهاية التدوير وتتركك لتكتشف التخمين في الثانية فجرًا. أما بالنسبة لما هو منشور، فالصورة مكتملة بما يكفي للبناء عليها: عنوان URL أساسي تقليدي على https://api.meta.ai/v1، ومفتاح Bearer تنشئه بنفسك، وتوافق فوري مع عملاء OpenAI وAnthropic، وحدود معدل موثّقة لكل فريق، وبطاقة أسعار تكون فيها نقطتا تفتيش Muse Spark اللتان يخدمهما هذا الموقع متطابقتين في كل من النافذة والسعر.

صفحة muse-code في هذه المدونة تغطي منصة التشغيل بعمق؛ هذه الصفحة ليست سوى السطح البرمجي.

في فجوات كهذه تظهر أيضًا أنماط الفشل: فالحوادث الموثّقة للذكاء الاصطناعي وإخفاقات الوكلاء المتعلقة بنماذج من هذه الفئة تُجمع في OrcaRouter AI Incident Archive، حيث يحمل كل مدخل مصادره الخاصة ودرجة خطورته ودرجة ثقته وعلامة كونه محل نزاع.