كيفية استخدام Muse Wonder API: بايثون، البث المتدفق والتسعير

الخلاصة

Muse Wonder هو نموذج معاينة من Meta للبرمجة المعقدة، والاستدلال، وتدفقات العمل العاملية. يمكن للمطورين الوصول إلى Muse Wonder API في CometAPI عبر عميل متوافق مع OpenAI وباستخدام model="muse-wonder". يساعد هذا الدليل المطورين المعتادين على Python أو JavaScript في إرسال أول طلب، وإضافة البث، وتقييم الاستدلال، والوسائط، والتكلفة. بالمقارنة مع Muse Spark، السبب العملي لتقييم Wonder هو قدرته المحتملة على إكمال المهام الصعبة بشكل أكثر موثوقية؛ نافذة السياق الكبيرة وحدها ليست سبباً للانتقال.

أهم النقاط

• التكامل: استخدم مفتاح API خلفي، https://api.cometapi.com/v1، وmodel="muse-wonder".
• السعة: لدى Muse Wonder نافذة سياق بحجم 1,048,576 رمزاً؛ قم بتقليم السياق المكرر للتحكم بالتكلفة.
• القدرات: قيّم البث، واستدعاءات الأدوات، والوسائط بشكل منفصل على مسار البوابة المحدد.
• الاستدلال: يدعم Muse Wonder الأصلي مستويات من minimal حتى max؛ زيادة الجهد ترفع استهلاك الرموز والزمن.
• النشر: قارن الأداء على مهام حقيقية، تحقق من الفوترة الحالية، واحتفظ بنموذج رجوع قبل توسيع المرور.

ما هي واجهة Muse Wonder API؟

قدمت Meta Muse Wonder في 12 أكتوبر 2026. النموذج متاح في المعاينة عبر Meta Model API لأعمال البرمجة المعقدة، والاستدلال، وتدفقات العمل المعتمدة على الأدوات. تستخدم CometAPI المعرّف muse-wonder؛ أما معرّف Meta الأصلي فهو muse-wonder-1.0.

يركز النموذج الأصلي على الاستدلال المستمر، والبرمجة، والعمل المعتمد على الأدوات. ما يزال على التطبيقات توفير الأدوات، والحالة الدائمة، وشروط الإيقاف، وفحوصات الأذونات؛ استدعاء النموذج الفردي لا ينشئ بيئة تنفيذ ذاتية.

مواصفات Muse Wonder API

Muse Wonder مقابل Muse Wonder Full

Muse Wonder متاح عبر Meta Model API؛ أما Muse Wonder Full فهو متاح فقط عبر اشتراكات Power Usage وMaximum Usage في Muse Code، وإعداد reasoning_effort إلى max لا يُحوّل إلى Muse Wonder Full. انظر إعلان الإطلاق من Meta.

Muse Spark API مقابل Muse Wonder API

اختر بين النموذجين بناءً على نجاح المهمة المقاس والتكلفة. يوصي الدليل الأصلي باستخدام Wonder للأعمال المعقدة وSpark للأعباء الحساسة للتكلفة؛ وكلاهما لديه نافذة سياق 1,048,576 رمزاً. قارن إصدار Spark محدداً بدلاً من افتراض أن جميع الإصدارات تمتلك قدرات متطابقة.

Muse Spark أنسب للأعباء الحساسة للتكلفة؛ يستهدف Muse Wonder البرمجة المعقدة والاستدلال المستمر. تحقق من دعم الوسائط، وضوابط الاستدلال، والفوترة للإصدار ومسار البوابة المحددين. احتفظ بالنموذج الذي يحقق أهدافك المقاسة لنجاح المهمة والتكلفة.

كيفية استخدام Muse Wonder API مع CometAPI خطوة بخطوة

الخطوة 1: أنشئ مفتاح CometAPI وآمِنّه

أنشئ حساباً، وولّد مفتاح API خلفياً، واحفظه بعيداً عن كود المتصفح والمستودعات العامة. اتبع وثائق تكامل CometAPI للمصادقة. تتطلب هذه الأمثلة حساباً ممولاً أو مؤهلاً، Python 3.10+ أو بيئة Node.js LTS مدعومة، وإتاحة اتصال HTTPS صادر. احفظ أمثلة JavaScript كملفات .mjs.

عيّن مفتاح API في جلسة Bash.

export COMETAPI_KEY="your_cometapi_api_key"

عيّن مفتاح API في جلسة PowerShell.

$env:COMETAPI_KEY="your_cometapi_api_key"

الخطوة 2: ضبط نقطة نهاية Muse Wonder

الخطوة 3: أرسل أول طلب باستخدام cURL

أرسل طلب دردشة مصادقاً بسيطاً.

curl -X POST "https://api.cometapi.com/v1/chat/completions" \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "muse-wonder",
    "messages": [
      {"role": "system", "content": "You are a senior engineer."},
      {"role": "user", "content": "List three ways to improve Python API reliability."}
    ],
    "stream": false
  }' 

يجب أن يُعيد طلب غير متدفق ناجح choices[0].message.content. افحص القيم المعادة للحقلين model وusage عند توفرهما، وتأكد أن النص يجيب على طلبك. تتطلب أخطاء المصادقة التحقق من بيانات الاعتماد؛ وتشير أخطاء النموذج غير الصحيح إلى ضرورة التحقق من الوصول إلى النموذج. الأمثلة توضّح أنماط الطلب ولا تمثل زمناً مقاساً أو نتائج معيارية.

الخطوة 4: أرسل طلباً باستخدام Python

ثبّت مكتبة عميل Python.

pip install --upgrade openai

أرسل طلب Python وافحص استخدام الرموز.

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["COMETAPI_KEY"],
    base_url="https://api.cometapi.com/v1",
    timeout=120.0,
)
response = client.chat.completions.create(
    model="muse-wonder",
    messages=[
        {"role": "system", "content": "You are a Python engineer."},
        {"role": "user", "content": "Review: def divide(a,b): return a/b"},
    ],
)
print(response.choices[0].message.content)
if response.usage:
    print("Total tokens:", response.usage.total_tokens)

الخطوة 5: استخدم JavaScript أو Node.js

ثبّت مكتبة عميل JavaScript.

npm install openai

أرسل طلباً باستخدام Node.js.

import OpenAI from "openai";
const client = new OpenAI({
  apiKey: process.env.COMETAPI_KEY,
  baseURL: "https://api.cometapi.com/v1",
});
const response = await client.chat.completions.create({
  model: "muse-wonder",
  messages: [{role: "user", content: "Explain async/await."}],
});
console.log(response.choices[0].message.content);

كيفية بث استجابات Muse Wonder عبر CometAPI

يعيد البث أجزاء استجابة تدريجية عبر أحداث يُرسلها الخادم. يحسّن الإحساس بالاستجابة، لكنه لا يحسن بالضرورة التكلفة الإجمالية أو وقت الإكمال. اعرض فقط الأجزاء التي تحتوي على محتوى، وتعامل مع حالات الانقطاع والمهلات.

مثال بث Python

اقرأ أجزاء الاستجابة التدريجية في Python.

import os
from openai import OpenAI
client = OpenAI(api_key=os.environ["COMETAPI_KEY"],
                base_url="https://api.cometapi.com/v1", timeout=180.0)
stream = client.chat.completions.create(
    model="muse-wonder",
    messages=[{"role": "user", "content": "Design a scalable FastAPI service."}],
    stream=True,
)
parts = []
for chunk in stream:
    if not chunk.choices:
        continue
    content = chunk.choices[0].delta.content
    if content:
        print(content, end="", flush=True)
        parts.append(content)
print("\nResponse complete.")

مثال بث JavaScript

اقرأ أجزاء الاستجابة التدريجية في Node.js.

import OpenAI from "openai";
const client = new OpenAI({
  apiKey: process.env.COMETAPI_KEY,
  baseURL: "https://api.cometapi.com/v1",
});
const stream = await client.chat.completions.create({
  model: "muse-wonder",
  messages: [{role: "user", content: "Outline a research agent."}],
  stream: true,
});
for await (const chunk of stream) {
  const text = chunk.choices?.[0]?.delta?.content;
  if (text) process.stdout.write(text);
}

ما هي مستويات جهد الاستدلال التي يدعمها Muse Wonder؟

القيم المدعومة لجهد الاستدلال

يقبل النموذج الأصلي minimal, low, medium, high, xhigh, وmax؛ ولا توجد قيمة غير مدعومة. ابدأ بإعداد متوسط وارفعه فقط عندما تبرره تقييماتك نظير زيادة زمن الاستجابة وتكلفة رموز الإخراج. راجع مرجع الاستدلال من Meta. اختبر إعادة التوجيه عبر البوابة بشكل منفصل.

كيفية ضبط جهد الاستدلال في Chat Completions

يرسل المثال التالي قيمة high عبر البوابة كاختبار قدرة. إذا رُفض الطلب، افحص الخطأ قبل إزالة الحقل: يمكن أن يشير 400 أيضاً إلى رسائل غير صالحة، أو نموذج غير صحيح، أو مشكلة أخرى في الطلب. أعد المحاولة بطلب نصي بسيط لعزل السبب.

اختبر high لجهد الاستدلال على البوابة.

import os
from openai import OpenAI, BadRequestError
client = OpenAI(api_key=os.environ["COMETAPI_KEY"],
                base_url="https://api.cometapi.com/v1")
try:
    response = client.chat.completions.create(
        model="muse-wonder",
        messages=[{"role": "user", "content": "Diagnose a distributed timeout."}],
        extra_body={"reasoning_effort": "high"},
    )
    print(response.choices[0].message.content)
except BadRequestError as err:
    print("This reasoning parameter may not be accepted:", err)

كيفية ضبط جهد الاستدلال في Responses API

تضع واجهة Responses API الأصلية الحقل كـ reasoning.effort وتستخدم muse-wonder-1.0. المثال أدناه يستخدم بيانات اعتماد Meta ونقطة نهاية أصلية؛ تحقق من دعم Responses بشكل مستقل قبل تكييفه مع CometAPI.

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["META_API_KEY"],
    base_url="https://api.meta.ai/v1",
)
response = client.responses.create(
    model="muse-wonder-1.0",
    input="Diagnose a distributed timeout.",
    reasoning={"effort": "high"},
)
print(response.output_text)

لماذا لا تؤدي قيمة max إلى اختيار Muse Wonder Full

تغيّر max ميزانية الاستدلال للنموذج المحدد. لا تغيّر معرّف النموذج ولا تمنح وصولاً إلى Full؛ يتم توضيح التمييز في الوصول ضمن مقدمة النموذج.

كيف يمكن لـ Muse Wonder API تحليل الصور وملفات PDF

توثّق Meta مدخلات الصورة، والفيديو، والصوت، وPDF لـ Wonder الأصلي. دعم الوسائط الأصلي من Meta لا يضمن أن CometAPI يقبل نفس مخطط المحتوى، أو صيغة URL، أو أنواع الملفات، أو حدود الحجم. تحقق من هذه التفاصيل على المسار المحدد قبل الاستخدام الإنتاجي. المثال أدناه لـ image_url هو نمط توافق: استخدم صورة قابلة للوصول تملكها، وأكد دعم نقطة النهاية، وافحص الإجابة مقابل التفاصيل المرئية.

اختبر URL صورة باستخدام صورة معروفة.

import os
from openai import OpenAI
client = OpenAI(api_key=os.environ["COMETAPI_KEY"],
                base_url="https://api.cometapi.com/v1")
response = client.chat.completions.create(
    model="muse-wonder",
    messages=[{"role": "user", "content": [
        {"type": "text", "text": "Describe anomalies in this dashboard."},
        {"type": "image_url", "image_url": {
            "url": "https://example.com/dashboard.png"}},
    ]}],
)
print(response.choices[0].message.content)

لخط سير نصي يمكن التنبؤ به مع PDF، استخرج النص القابل للتحديد محلياً وأرسل مقاطع مختارة كنص. هذا لا يختبر إدخال PDF الأصلي ولا يحافظ على تخطيط الصفحات، أو الأشكال، أو المحتوى الممسوح. المثال يحدّ الإدخال إلى 50,000 حرف لاختبار صغير؛ على المعالجة الإنتاجية اختيار أو تقسيم المحتوى والحفاظ على مراجع الصفحات بدلاً من اقتطاع التقرير بصمت.

استخرج نص PDF القابل للتحديد لاختبار محدود.

# pip install pymupdf openai
import os
import fitz
from openai import OpenAI
client = OpenAI(api_key=os.environ["COMETAPI_KEY"],
                base_url="https://api.cometapi.com/v1")
with fitz.open("report.pdf") as doc:
    document_text = "\n".join(p.get_text() for p in doc)
response = client.chat.completions.create(
    model="muse-wonder",
    messages=[{"role": "user", "content":
        "Summarize the risks in this report:\n" + document_text[:50000]}],
)
print(response.choices[0].message.content)

كيف تبني وكيلاً يستدعي الأدوات باستخدام Muse Wonder API

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

نفّذ طلب أداة محدوداً لحالة الطلب.

import json, os
from openai import OpenAI
client = OpenAI(api_key=os.environ["COMETAPI_KEY"],
                base_url="https://api.cometapi.com/v1")
tools = [{"type": "function", "function": {
    "name": "get_order_status",
    "description": "Look up an order status",
    "parameters": {"type": "object",
        "properties": {"order_id": {"type": "string"}},
        "required": ["order_id"], "additionalProperties": False}
}}]
messages = [{"role": "user", "content": "Status of order A1001?"}]
r = client.chat.completions.create(model="muse-wonder",
    messages=messages, tools=tools, tool_choice="auto")
msg = r.choices[0].message
messages.append(msg)
if msg.tool_calls:
    for call in msg.tool_calls:
        if call.function.name != "get_order_status":
            raise ValueError("Tool not permitted")
        args = json.loads(call.function.arguments)
        status = {"A1001": "Shipped"}.get(args["order_id"], "Not found")
        messages.append({"role": "tool", "tool_call_id": call.id,
                         "content": json.dumps({"status": status})})
    r = client.chat.completions.create(model="muse-wonder",
        messages=messages, tools=tools)
    print(r.choices[0].message.content)
else:
    print(msg.content)

هذا المثال التعليمي يعالج جولة واحدة من استدعاء الأدوات. إذا طلبت الاستجابة اللاحقة استدعاء أداة أخرى، فتابع فقط ضمن حلقة محدودة وتحقق مرة أخرى من الاسم والمعاملات. خزن نتائج الأدوات لضمان أمان إعادة المحاولة؛ يحتاج وكيل الإنتاج أيضاً إلى حد زمني، وحد أقصى للتكرارات، وحالة إكمال واضحة.

كم تبلغ تكلفة Muse Wonder API

توضح أسعار Meta الرسمية 4.00$ لكل مليون رموز إدخال غير مخزّنة، 0.20$ لكل مليون رموز إدخال مخزّنة، و20.00$ لكل مليون رموز إخراج.

تسرد لقطة التسعير بتاريخ 14 أكتوبر 2026 في المصدر أسعار CometAPI بـ 3.20$ لكل مليون رموز إدخال غير مخزّنة و16.00$ لكل مليون رموز إخراج. هذه أسعار بوابة، وليست بديلاً لأسعار Meta البالغة 4.00$ للإدخال و20.00$ للإخراج. تحقق من أسعار حسابك ومسارك الحاليين قبل الاستخدام؛ لا يُفترض وجود تعرفة للمدخلات المخزّنة في CometAPI.

لعدد 100,000 رمز إدخال غير مخزّن و50,000 رمز إخراج مفوترة، تعطي أسعار Meta المذكورة 0.40$ + 1.00$ = 1.40$. وتعطي أسعار CometAPI المذكورة 0.32$ + 0.80$ = 1.12$. يستثني هذا المثال الرسوم الإضافية ولا يفترض أي خصم للتخزين المؤقت.

في هذا المثال غير المخزّن، تعطي أسعار CometAPI المعروضة تقديراً أقل بنسبة 20%. تعتمد الفواتير الفعلية على استخدام الرموز، وفوترة المسار، وأي رسوم إضافية. إذا انطبق التخزين المؤقت، فاحسبه باستخدام التعرفة المؤكدة بدلاً من تطبيق تعرفة الإدخال غير المخزّن على كل الرموز.

قدّر التكلفة باستخدام أسعار CometAPI في لقطة المصدر؛ واستبدلها بأسعار حسابك المؤكدة.

def estimate_cost(input_tokens, output_tokens,
                  input_rate=3.20, output_rate=16.00):
    if input_tokens < 0 or output_tokens < 0:
        raise ValueError('Token counts must be non-negative')
    return (input_tokens * input_rate
            + output_tokens * output_rate) / 1_000_000

print(estimate_cost(100000, 50000))  # 1.12

كيفية الترحيل وتشغيل Muse Wonder في الإنتاج

حدّث وحقق من صحة التكامل

يمكن لمعظم تكاملات العملاء المتوافقة مع OpenAI الاحتفاظ ببنيتها العامة. حدّث Base URL، وبيانات الاعتماد، ومعرّف النموذج، ثم نفّذ تقييماً مرحلياً على مطالبات حقيقية. تتطلب حقول الاستدلال والوسائط المتعددة الخاصة بالبروتوكول تحققاً مستقلاً.

عيّن COMETAPI_KEY، وحدّث Base URL إلى https://api.cometapi.com/v1 واختر muse-wonder. تحقق من المصادقة والوصول إلى النموذج عبر طلب نصي بسيط. ثم اختبر حقول الاستدلال، وأجزاء البث، وتنفيذ استدعاءات الأدوات، وأي صيغة وسائط بشكل منفصل. افحص الأخطاء وجودة الإجابات: يمكن أن يكون HTTP 400 لعدة أسباب، بينما لا يثبت نجاح حالة HTTP وحده دعم القدرات. سجّل usage المعاد وقارن التكلفة مع ميزانيتك. أبقِ Base URL والنموذج قابلين للتهيئة حتى تتمكن من الرجوع.

اضبط ترحيلاً واعتماداً على البيئة مع خيار الرجوع.

import os
from openai import OpenAI
client = OpenAI(
    api_key=os.environ["COMETAPI_KEY"],
    base_url=os.getenv("AI_BASE_URL", "https://api.cometapi.com/v1"),
)
model = os.getenv("AI_MODEL", "muse-wonder")
r = client.chat.completions.create(
    model=model,
    messages=[{"role":"user", "content":"Review this API design."}],
)
print(r.choices[0].message.content)

ابدأ بنسبة كاناري صغيرة من المرور الحي. قارن الدقة، ونجاح الأدوات، وزمن الرمز الأول، والزمن الكلي، ومعدل إعادة المحاولة، وإجمالي التكلفة لكل مهمة مكتملة بنجاح قبل توسيع النشر.

أضف مهلات، حدوداً لإعادة المحاولة، ومراقبة

عيّن مهلات للطلبات وحدوداً صريحة؛ سجّل معرفات الطلب غير الحساسة واستخدام الرموز؛ واحذف المعلومات الشخصية عندما يكون ذلك ممكناً؛ وأعِد المحاولة فقط في حالات الإخفاقات العابرة؛ واطلب تفويضاً للأفعال غير القابلة للعكس في الأدوات. ليست مكالمة نموذج أرخص بالضرورة مهمةً أرخص إذا تسببت في إعادة محاولات.

أعِد محاولة الأخطاء العابرة بارتداد أُسّي محدود.

import os, time, random
from openai import (OpenAI, APIConnectionError, APITimeoutError,
    RateLimitError, InternalServerError)
client = OpenAI(api_key=os.environ["COMETAPI_KEY"],
    base_url="https://api.cometapi.com/v1", timeout=60, max_retries=0)
def complete_with_retry(prompt, attempts=4):
    for i in range(attempts):
        try:
            r = client.chat.completions.create(
                model="muse-wonder",
                messages=[{"role": "user", "content": prompt}])
            return r.choices[0].message.content
        except (RateLimitError, APIConnectionError,
                APITimeoutError, InternalServerError):
            if i == attempts-1:
                raise
            time.sleep(min(2**i, 16) + random.uniform(0, 0.5))

المؤشر التشغيلي المقترح: تكلفة كل مهمة ناجحة = إجمالي تكاليف النموذج والأدوات / عدد المهام الناجحة. تتبع حواجز السلامة والدقة بالإضافة إلى التكاليف الإجمالية.

الأسئلة الشائعة

لماذا قد تتوقف Muse Wonder API قبل الإجابة النهائية؟

يتشارك الاستدلال والنص المرئي ميزانية الإكمال على الواجهة الأصلية. يمكن لجولة استدلال طويلة أن تترك مساحة أقل للإجابة النهائية. افحص سبب الإنهاء والاستخدام، وقلل الجهد أو ضيّق المهمة، وزِد حد الإكمال المدعوم على المسار فقط ضمن ميزانيتك. يتطلب البث المنقطع تشخيص نقل منفصل.

هل يجب أن أعيد تشغيل بث Muse Wonder API من البداية؟

الطلب الجديد هو توليد جديد، وليس متابعة تلقائية لإجابة مقطوعة. احفظ المخرجات الجزئية ومعرّف الطلب، وضع علامة على الإجابة بأنها غير مكتملة، وقرّر ما إذا كنت ستعيد البدء أو تطلب متابعة باستخدام سياق صريح. بالنسبة لتدفقات الأدوات، خزّن الأفعال المكتملة حتى لا يمكن تنفيذها مرتين عند إعادة المحاولة.

كيف أتحقق من صحة إجابات الوسائط في Muse Wonder API؟

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

كيف أراجع فرق تكلفة Muse Wonder API؟

سجّل usage المعاد، النموذج، المسار، وقت الطلب، وسعر الحساب في ذلك الوقت. افصل بين إدخال غير مخزّن، وقراءات ذاكرة مخزن مؤكدة، وإجمالي إخراج مفوتر، بما في ذلك الاستدلال حيثما ينطبق. قارن تلك الكميات مع سجل الفوترة؛ تحقق من العملة، تغييرات الأسعار، والرسوم الإضافية قبل افتراض وجود خطأ في احتساب الرموز.

الخاتمة

ابدأ بطلب واحد مصادق عبر CometAPI، وتأكد من الإجابة المعادة، ثم أضف البث والقدرات التي يحتاجها تطبيقك. قبل النشر الإنتاجي، تحقق من المسار المحدد، وثّق الفوترة، طبّق أذونات الأدوات، واحتفظ بنموذج رجوع. وسّع المرور فقط عندما يحقق نجاح المهمة المقاس، والزمن، والتكلفة معايير قبولك.