Muse Wonder API-ні қалай пайдалану: Python, стриминг және баға белгілеу

TL;DR

Muse Wonder — күрделі кодтау, пайымдау және агенттік жұмыс процестері үшін Meta ұсынған алдын ала қарау үлгісі. Әзірлеушілер CometAPI-дегі Muse Wonder API қызметіне OpenAI-мен үйлесімді клиент және model="muse-wonder" арқылы қол жеткізе алады. Бұл нұсқаулық Python немесе JavaScript-ке таныс әзірлеушілерге бірінші сұрауды жіберуге, ағындық беруді қосуға және пайымдау, медиа және құнды бағалауға көмектеседі. Muse Spark-пен салыстырғанда Wonder-ды бағалаудың практикалық себебі — күрделі тапсырмаларды сенімдірек аяқтау әлеуеті; тек үлкен контекст терезесі көшу үшін жеткілікті себеп емес.

Key Takeaways

• Интеграция: бекенд API кілтін, https://api.cometapi.com/v1 және model="muse-wonder" пайдаланыңыз.
• Сыйымдылық: Muse Wonder контекст терезесі 1,048,576 токен; құнын бақылау үшін қайталанатын контексті қысқартыңыз.
• Қабілеттер: таңдалған шлюз бағыты бойынша ағындық беру, құрал шақырулары және медиа мүмкіндіктерін жеке бағалаңыз.
• Пайымдау: жергілікті Muse Wonder minimal-дан max-қа дейін қолдайды; күш-жігерді арттыру токен шығынын және кідірісті ұлғайтады.
• Жариялау: нақты тапсырмаларды бенчмарктаңыз, ағымдағы биллингті растаңыз және трафикті кеңейтпес бұрын кері қайту моделін сақтаңыз.

What Is Muse Wonder API?

Meta Muse Wonder-ды 2026 жылғы 12 қазанда таныстырды. Бұл үлгі күрделі кодтау, пайымдау және құралға негізделген жұмыс процестері үшін Meta Model API арқылы алдын ала қарауда қолжетімді. CometAPI үлгі идентификаторы muse-wonder-ды қолданады; Meta-ның жергілікті идентификаторы — muse-wonder-1.0.

Жергілікті үлгі ұзаққа созылатын пайымдау, кодтау және құралға негізделген жұмысқа шоғырланған. Қолданбалар әлі де құралдарды, тұрақты күйді, тоқтату шарттарын және рұқсат тексерулерін қамтамасыз етеді; жеке үлгі шақыруы автономды орындау ортасын құрмайды.

Muse Wonder API specifications

Muse Wonder vs Muse Wonder Full

Muse Wonder Meta Model API арқылы қолжетімді; Muse Wonder Full тек Muse Code ішіндегі Power Usage және Maximum Usage жазылымдары арқылы қолжетімді, ал reasoning_effort мәнін max ету Muse Wonder Full-ға ауыстырмайды. Meta-ның іске қосу туралы хабарламасын қараңыз.

Muse Spark API vs Muse Wonder API

Модельдерді таңдау — өлшенген тапсырма сәттілігі мен құн бойынша. Жергілікті нұсқаулық Wonder-ды күрделі жұмысқа, Spark-ты шығынға сезімтал жүктемелерге ұсынады; екеуіне де 1,048,576 токендік контекст терезесі беріледі. Барлық нұсқалардың бірдей мүмкіндіктері бар деп жорамалдамай, нақты Spark нұсқасын салыстырыңыз.

Muse Spark шығынға сезімтал жүктемелерге лайық; Muse Wonder күрделі кодтау және ұзақ пайымдау үшін нысатталған. Дәл модель нұсқасы мен шлюз бағыты бойынша медиа қолдауды, пайымдау басқаруларын және биллингті тексеріңіз. Өлшенген тапсырма сәттілігі мен шығын мақсаттарыңызға сай келетін модельді ұстаңыз.

How to Use Muse Wonder API with CometAPI Step by Step

Step 1: Create and secure your CometAPI key

Тіркелгі жасап, бекенд 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"

Step 2: Configure the Muse Wonder endpoint

Step 3: Send your first request with 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 мәнін қайтарады. Қайтарылған үлгіні және (берілсе) usage мәнін тексеріп, мәтіннің сұрауыңызға жауап беретінін растаңыз. Аутентификация қателері — тіркелгі деректерін, ал жарамсыз модель қатесі — модельге қолжетімділікті тексеруді талап етеді. Мысалдар сұрау үлгілерін көрсетеді және өлшенген кідіріс немесе бенчмарк нәтижелерін білдірмейді.

Step 4: Make a Python request

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)

Step 5: Use JavaScript or 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);

How to Stream Muse Wonder Responses with CometAPI

Ағындық беру сервер-сентті оқиғалар арқылы жауаптың инкременттік бөліктерін қайтарады. Бұл қабылданатын жеделдікті арттырады, бірақ міндетті түрде жалпы құнды немесе аяқталу уақытын қысқартпайды. Тек мазмұны бар бөліктерді көрсетіңіз және үзілулер мен уақыт асуларын өңдеңіз.

Python streaming example

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 streaming example

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);
}

What Reasoning Effort Levels Does Muse Wonder Support?

Supported Reasoning Effort Values

Жергілікті үлгі minimal, low, medium, high, xhigh және max мәндерін қабылдайды; ешқайсысы қолдаусыз емес. Орташа параметрден бастап, тек бағалауларыңыз қосымша кідіріс пен шығыс токен құнын ақтағанда ғана көтеріңіз. Meta reasoning анықтамасын қараңыз. Шлюз арқылы бағыттауды жеке сынаңыз.

How to Set Reasoning Effort in 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)

How to Set Reasoning Effort in the Responses API

Meta-ның жергілікті Responses API өрісті reasoning.effort ретінде ішке орналастырады және muse-wonder-1.0 үлгісін пайдаланады. Төмендегі мысал Meta тіркелгі деректерін және оның жергілікті соңғы нүктесін қолданады; оны CometAPI-ге бейімдемес бұрын Responses қолдауын жеке растаңыз.

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)

Why max Does Not Select Muse Wonder Full

max таңдалған үлгінің пайымдау бюджетін өзгертеді. Ол үлгі идентификаторын өзгертпейді және Full қолжетімділігін бермейді; қолжетімділік айырмашылығы үлгіге кіріспеде түсіндіріледі.

How Can Muse Wonder API Analyze Images and PDFs

Meta жергілікті Wonder үшін сурет, видео, аудио және PDF енгізуді құжаттайды. 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)

How Can You Build a Tool-Calling Agent With 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)

Бұл оқыту мысалы бір құрал-шақыру раундын өңдейді. Егер кейінгі жауап тағы бір құрал шақыруын сұраса, тек шектелген цикл шеңберінде жалғастырыңыз және оның атауы мен аргументтерін қайтадан тексеріңіз. Қайта әрекет ету қауіпсіздігі үшін құрал нәтижелерін сақтаңыз; өндірістік агент үшін сондай-ақ уақыт шектеуі, итерация шектеуі және аяқталу шарты қажет.

How Much Does Muse Wonder API Cost

Meta-ның ресми бағалары 1 миллион кэштенбеген кіріс токені үшін $4.00, 1 миллион кэштенген кіріс токені үшін $0.20 және 1 миллион шығыс токені үшін $20.00 көрсетеді.

Бастапқы мақаладағы 2026 жылғы 14 қазан баға кесіндісінде CometAPI үшін 1 миллион кэштенбеген кіріс токеніне $3.20 және 1 миллион шығыс токеніне $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

How to Migrate and Run Muse Wonder in Production

Update and Validate the Integration

Көптеген 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)

Тікелей трафиктің шағын канарейка бөлігінен бастаңыз. Дұрыстығын, құрал сәттілігін, бірінші токен кідірісін, жалпы кідірісті, қайта әрекет ету жиілігін және сәтті аяқталған тапсырмаға шаққандағы жалпы құнын салыстырып, содан кейін ғана ауқымды ұлғайтыңыз.

Add Timeouts, Retry Limits and Monitoring

Сұрау таймауттары мен айқын шектерді орнатыңыз; құпия емес сұрау идентификаторларын және токен пайдалануды жорналға жазыңыз; мүмкін болғанда жеке деректерді жасырыңыз; тек өткінші қателерге ғана қайта әрекет етіңіз; қайтымсыз құрал әрекеттері үшін авторизация талап етіңіз. Егер ол қайта әрекеттерге әкелсе, арзан үлгі шақыруы міндетті түрде арзан тапсырма емес.

Өткінші қателерді шектелген экспоненциалды backoff-пен қайта әрекет етіңіз.

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))

Ұсынылатын операциялық метрика: сәтті тапсырмаға шаққандағы құн = үлгі мен құралдардың жалпы құны / сәтті тапсырмалар саны. Қауіпсіздік пен дұрыстық шектеулерін де, жинақталған шығындарды да бақылаңыз.

FAQ

Why can Muse Wonder API stop before its final answer?

Жергілікті API-де пайымдау мен көрінетін мәтін бір аяқталу бюджетімен ортақтасады. Ұзақ пайымдау кезеңі соңғы жауапқа орын аз қалдыруы мүмкін. Аяқтау себебі мен usage мәнін тексеріңіз, күш-жігерді азайтыңыз немесе тапсырманы тарылтыңыз және маршрут қолдайтын аяқталу шегін тек бюджет аясында ғана ұлғайтыңыз. Үзілген ағын бөлек тасымалдау диагностикасын талап етеді.

Should I retry a Muse Wonder API stream from the beginning?

Жаңа сұрау — үзілген жауаптың автоматты жалғасы емес, жаңа генерация. Жартылай шығысты және сұрау идентификаторын сақтаңыз, жауапты толық емес деп белгілеңіз және басынан бастау немесе айқын контекстпен жалғастыруды сұрау жөнінде шешім қабылдаңыз. Құрал жұмыс ағындары үшін қайта әрекет ету қос рет орындалмауы үшін аяқталған әрекеттерді тұрақтандырыңыз.

How do I validate Muse Wonder API media answers?

Белгілі фактілері бар шағын тест суретті немесе құжатты пайдаланыңыз және жауаптар сол фактілерді талап ететін сұрақтар қойыңыз. Жауапты түпнұсқамен салыстырыңыз, оның ішінде сандар мен бет сілтемелері бойынша. Сәтті HTTP күйі соңғы нүктенің медианы дұрыс қабылдағанын немесе түсіндіргенін дәлелдемейді; масштабтаудан бұрын қателер мен сұрау пішімдерін тексеріңіз.

How can I audit a Muse Wonder API cost discrepancy?

Қайтарылған usage, үлгі, бағыт, сұрау уақыты және сол уақыттағы тіркелгі тарифін жазып алыңыз. Кэштенбеген кірісті, расталған кэш оқуларын және жалпы биллингтелген шығысты, қажет болса пайымдауды бөлек көрсетіңіз. Осы шамаларды биллинг жазбасымен салыстырыңыз; токен есебі қатесі деп қабылдамай тұрып, валютаны, тариф өзгерістерін және қосымша төлемдерді тексеріңіз.

Conclusion

Бір аутентификацияланған CometAPI сұрауынан бастап, қайтарылған жауапты растаңыз, содан кейін ағындық беруді және қосымша қолданбаңызға қажет мүмкіндіктерді қосыңыз. Өндірістік қолдануға дейін таңдалған бағытты растаңыз, биллингті тексеріңіз, құрал рұқсаттарын қатаңдатңыз және кері қайту үлгісін ұстаңыз. Трафикті тек өлшенген тапсырма сәттілігі, кідіріс және құн қабылдау критерийлеріңізге сай келгенде ғана кеңейтіңіз.