كيفية استخدام Muse Wonder مجانًا على CometAPI

ملخص سريع

أنشئ حساب CometAPI مجانيًا، واستخدم رصيد التسجيل بقيمة $0.10، وأرسل طلبًا إلى muse-wonder. لا تحتاج إلى بطاقة ائتمانية أو اشتراك شهري للبدء. أدناه نستعرض إصلاح خطأ صغير في JavaScript كي ينتج اختبارك الأول شيئًا يمكنك التحقق منه واستخدامه.

أهم النقاط المستخلصة

• استخدم رصيد التسجيل في CometAPI لتجربة Muse Wonder دون دفعة أولية.
• أنشئ مفتاح API واستدعِ muse-wonder عبر نقطة نهاية Chat Completions الخاصة بـ CometAPI.
• ابدأ بمهمة واحدة مكتفية ذاتيًا واختبر النتيجة قبل الانتقال إلى مشروع أكبر.
• الوصول المجاني يأتي من رصيد البداية؛ أما الاستمرار في الاستخدام فيُحتسب وفق الاستهلاك.

كيفية اختبار Muse Wonder بإصلاح خطأ JavaScript

نوصي بأن تستخدم أول طلب لك إلى Muse Wonder لحل مشكلة صغيرة يمكنك التحقق منها. يُعدّ إصلاح خطأ نقطة انطلاق جيدة: يمكنك تزويد الدالة كاملةً، وتحديد السلوك المطلوب، والتحقق مما إذا كان الكود المُعاد يعمل.

في هذا الشرح، سنُصلح الدالة average(). إنها تحسب المتوسط الحسابي لمصفوفة غير فارغة، لكنها تُرجع NaN عند تمرير مصفوفة فارغة:

function average(xs) {
  return xs.reduce((a, b) => a + b, 0) / xs.length;
}

نريد من Wonder الحفاظ على الحساب المعتاد وأن ترمي RangeError عند تمرير مصفوفة فارغة. هذا يمنح التجربة خط نهاية واضحًا: دالة مُصححة تجتاز ثلاثة تحققات.

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

الشكل 1. يأخذك اختبار مركّز من رصيد البداية إلى نتيجة يمكنك التحقق منها. تصميم توضيحي أصلي يدمج رسوميات OpenMoji مع تحجيم متناسب وترتيب جديد. مرخّص بموجب CC BY-SA 4.0؛ راجع الاعتمادات الكاملة للصورة والترخيص.

كيفية استخدام Muse Wonder مجانًا على CometAPI

الخطوة 1 أنشئ حسابك وفعّل الرصيد

افتح صفحة التسجيل في CometAPI وأنشئ حسابًا. بعد تسجيل الدخول، افتح Wallet لمشاهدة رصيد تسجيل بقيمة $0.10. تتم إضافة هذا الرصيد تلقائيًا؛ لا توجد خطوة استرداد منفصلة.

يموّل هذا الرصيد أولى طلباتك إلى Muse Wonder. يمكنك تأجيل إعداد الدفع والعمل عبر المثال باستخدام رصيد البداية.

تفضّل البدء في المتصفح؟ افتح صفحة نموذج Wonder واختر Playground. يمكنك إرسال الدالة ومتطلب المصفوفة الفارغة هناك باستخدام رصيد الحساب نفسه؛ توضح خطوات واجهة API أدناه كيفية تنفيذ الطلب من الطرفية.

الخطوة 2 أنشئ مفتاح API

افتح API Keys، وانقر Create API Key، وامنح المفتاح اسمًا مثل wonder-trial، ثم انقر Create. انسخ المفتاح وعيّنه في الطرفية المحلية لديك:

export COMETAPI_KEY="YOUR_COMETAPI_KEY"

استبدل النص النائب بمفتاحك. احفظ المفتاح الحقيقي بعيدًا عن كود المتصفح والمستودعات العامة. يعرض API quickstart شاشات إنشاء الحساب والمفتاح.

الخطوة 3 أرسل طلب إصلاح الخطأ

يعمل الأمر التالي في طرفية Bash أو Zsh مع تثبيت curl. يستدعي Muse Wonder باستخدام معرف النموذج muse-wonder عبر نقطة نهاية /v1/chat/completions في CometAPI:

curl "https://api.cometapi.com/v1/chat/completions" \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "muse-wonder",
    "messages": [
      {
        "role": "user",
        "content": "Fix this JavaScript function. For non-empty arrays, preserve the arithmetic mean. For an empty array, throw a RangeError. The function must return 4 for [2, 4, 6], return 0 for [-2, 0, 2], and throw RangeError for []. Return only the corrected JavaScript function named average, without Markdown fences, explanations, or tests. Use no external packages. Function: function average(xs) { return xs.reduce((a, b) => a + b, 0) / xs.length; }"
      }
    ]
  }'

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

في استجابة JSON، تكون الإجابة في choices[0].message.content كما هو موضح في تنسيق استجابة Chat Completions. انسخ الدالة المُعادة إلى ملف باسم average-test.cjs.

الخطوة 4 تحقق مما إذا كان الإصلاح يعمل

اقرأ الدالة أولًا: ينبغي أن تتحقق من المصفوفة الفارغة قبل القسمة على طولها. ثم ضع هذه التحققات أسفلها في average-test.cjs:

const assert = require("node:assert/strict");

assert.equal(average([2, 4, 6]), 4);
assert.equal(average([-2, 0, 2]), 0);
assert.throws(() => average([]), RangeError);

console.log("All three checks passed.");

مع وجود Node.js مثبتًا، شغّل:

node average-test.cjs

تخدم هذه التحققات أغراضًا مختلفة:

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

إذا أخفق أحد التحققات، تابع بالخطأ المحدد والدالة المُعادة. يمنح الفشل المحدد Wonder هدفًا ملموسًا للتصحيح.

الخطوة 5 راجع استهلاك الطلب

افتح Logs في حساب CometAPI لديك ووسّع الطلب. راجع استهلاك الرموز والتكلفة، ثم تحقق من الرصيد المتبقي في Wallet. يشرح دليل الحساب مكان العثور على الحساب التفصيلي.

الآن لديك جزآن لتجربة مفيدة: نتيجة يمكنك تقييمها وسجل بما استهلكته. احتفظ بهما معًا عند اتخاذ قرار عمّا تجربه لاحقًا.

كيفية تقليل استهلاك الرموز عند اختبار Muse Wonder

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

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

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

إلى أي مدى يمكنك التجربة باستخدام الرصيد المجاني

تبلغ تكلفة Muse Wonder حاليًا $3.20 لكل مليون رمز مُدخل و**$16 لكل مليون رمز مُخرَج** على CometAPI.

على سبيل القياس، يكلف طلب افتراضي يحتوي على 2,000 رمز مُدخل غير مُخبأ و500 رمز مُخرَج خاضع للفوترة:

(2,000 × $3.20 + 500 × $16) ÷ 1,000,000 = $0.0144

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

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

هل أحتاج إلى بطاقة ائتمانية للبدء؟

لا. يمكنك إنشاء حساب CometAPI مع رصيد تجربة مجاني من دون إضافة بطاقة ائتمانية. لا يلزم اشتراك شهري مدفوع لهذه التجربة عبر واجهة API.

ماذا يحدث عندما ينفد رصيد البداية؟

الاستخدام اللاحق يحتاج تمويلًا. تحقق من الرصيد المتبقي قبل المتابعة: قد يكلف الطلب الأخير أكثر من الرصيد المتبقي ويجعل الرصيد سالبًا.

الخلاصة

أنشئ حسابك على CometAPI، استخدم رصيد التسجيل وأوكل إلى Muse Wonder مهمة واحدة مفيدة. في هذا الشرح، يعني النجاح دالة مُصححة تجتاز التحققات الثلاثة، مع تسجيل استهلاكها في Logs.

عندما تكون جاهزًا لربط Wonder بتطبيقك، واصل مع CometAPI Muse Wonder API guide. ستكون قد حصلت على مفتاح API، وطلب عامل، ومثال ملموس على الكيفية التي تريد بها من النموذج أن يساعدك.