كيفية استخدام Hy3 Preview API مجانًا؟

أطلقت Tencent الإصدار الأولي من Hy3 Preview كمصدر مفتوح في 22 أبريل 2026، وفي غضون يوم واحد أدرجه OpenRouter كنقطة نهاية مجانية بالكامل. لا توجد بطاقة ائتمان، ولا قياس للتوكنات، ولا فترة تجريبية. يمكنك استدعاء نفس نموذج "مزيج الخبراء" (Mixture-of-Experts) ذي الـ 295 مليار معلمة الذي يشغل تطبيق Yuanbao ومساعد CodeBuddy من Tencent من التعليمات البرمجية الخاصة بك، اليوم، بدون أي تكلفة.

يوضح هذا الدليل كيفية استخدام واجهة برمجة تطبيقات Hy3 Preview مجانًا عبر OpenRouter، ومساحة Hugging Face، ومستودع Hy3 الأصلي. كما يغطي أوضاع التفكير التي تجعل Hy3 مختلفًا عن معظم النماذج المفتوحة لعام 2026، وكيفية اختبار واجهة برمجة التطبيقات داخل Apidog دون كتابة نصوص مهملة.

إذا كنت ترغب في أسرع طريق للحصول على ردك الأول، فانتقل إلى "خطوة بخطوة: استدعِ Hy3 Preview مجانًا على OpenRouter".

باختصار

• Hy3 Preview مجاني على OpenRouter تحت معرف النموذج tencent/hy3-preview:free مع تسعير 0 دولار للإدخال و0 دولار للإخراج.
• إنه نموذج مزيج الخبراء (Mixture-of-Experts): 295 مليار معلمة إجمالية، 21 مليار معلمة نشطة، 192 خبيرًا مع توجيه top-8، ونافذة سياق بحجم 256 ألف توكن.
• تأتي ثلاثة أوضاع تفكير مدمجة: no_think للإجابات السريعة، وlow، وhigh لسلسلة تفكير عميقة في مهام الوكيل والترميز.
• المعايير قوية بالنسبة لنموذج ذي أوزان مفتوحة: SWE-bench Verified 74.4، Terminal-Bench 2.0 54.4، GPQA Diamond 87.2، MMLU 87.42.
• يمكنك تشغيله بثلاث طرق مجانية: الطبقة المجانية في OpenRouter، ومساحة Hy3-preview في Hugging Face، أو الاستدلال المحلي باستخدام vLLM والأوزان المفتوحة.
• يتكامل Apidog جيدًا مع نقطة نهاية OpenRouter لأن Hy3 يستخدم مخطط OpenAI Chat Completions؛ وجه طلبًا إلى OpenRouter وانطلق.

ما هو Hy3 Preview؟

Hy3 Preview هو أول إصدار رئيسي من فريق نماذج Hunyuan الأساسية المعاد هيكلته في Tencent، والذي يقوده الآن ياو شونيو، باحث سابق في OpenAI استعانت به الشركة لدفع مكدس التفكير الخاص بها. دعنا نعتبره النموذج الأكثر قدرة من Tencent حتى الآن وإجابة مباشرة على أبرز الإصدارات الصينية ذات الأوزان المفتوحة من DeepSeek و Alibaba و Zhipu.

الملف التقني من بطاقة النموذج الرسمية يركز على الوكيل أولاً:

• البنية: مزيج من الخبراء (Mixture-of-Experts)، 80 طبقة بالإضافة إلى طبقة MTP واحدة، 64 رأس انتباه مع انتباه التساؤل المجمع.
• المعلمات: 295 مليار إجمالاً، 21 مليار نشطة لكل تمريرة أمامية.
• الخبراء: 192 متخصصًا مع توجيه top-8 لكل توكن.
• السياق: 256 ألف توكن (262,144 على قائمة OpenRouter).
• أداة الترميز (Tokenizer): مفردات مكونة من 120,832 إدخالًا بدقة BF16.
• الترخيص: ترخيص Tencent Hy Community، يسمح بالاستخدام التجاري ضمن شروط الترخيص.

ما يميزه عن نموذج MoE عام في نطاق 200 مليار هو التدريب الموجه للوكلاء. أعادت Tencent بناء بنيتها التحتية للتعلم المعزز (RL) لاستخدام الأدوات متعدد الأدوار، وتضعه الدرجات المنشورة على SWE-bench Verified و Terminal-Bench 2.0 ومجموعة WildClawBench الداخلية بالقرب من أفضل النماذج المغلقة في مهام الكود وواجهة الأوامر.

ثلاث طرق مجانية لاستخدام Hy3 Preview

لديك ثلاثة مسارات اعتمادًا على ما إذا كنت تريد واجهة مستخدم للدردشة، أو واجهة برمجة تطبيقات (API)، أو أوزانًا محلية.

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

خطوة بخطوة: استدعِ Hy3 Preview مجانًا على OpenRouter

إليك المسار الأدنى من الصفر للحصول على استجابة عاملة من tencent/hy3-preview:free.

1. إنشاء حساب OpenRouter. قم بالتسجيل على openrouter.ai. يكفي البريد الإلكتروني؛ لا يلزم طريقة دفع للنماذج المجانية.
2. إنشاء مفتاح API. في لوحة تحكم OpenRouter، افتح "Keys" وأنشئ مفتاحًا جديدًا. انسخه إلى متغير بيئة، على سبيل المثال export OPENROUTER_API_KEY=sk-or-....
3. افتح صفحة النموذج. انتقل إلى قائمة Hy3 Preview المجانية وتأكد من أن لافتة الحالة تشير إلى "Free" (مجاني). سترى أيضًا إحصائيات الاستخدام هناك؛ عند الإطلاق، كانت نقطة النهاية تتعامل مع 6.81 مليار توكن مطالبة يوميًا عبر جميع المستخدمين.

أرسل طلبك الأول. يكشف OpenRouter عن مخطط OpenAI Chat Completions، لذا فإن أي حزمة تطوير برمجيات (SDK) من OpenAI تعمل:

curl https://openrouter.ai/api/v1/chat/completions \
  -H "Authorization: Bearer $OPENROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "tencent/hy3-preview:free",
    "messages": [
      {"role": "user", "content": "Explain the MoE routing decision inside a top-8 of 192 setup in 3 sentences."}
    ],
    "temperature": 0.9,
    "top_p": 1.0
  }'

1. قم بتشغيل التفكير عند الحاجة. يقبل Hy3 معلمة reasoning مع تعيين effort على low أو high. يعيد OpenRouter مسار التفكير في مصفوفة reasoning_details منفصلة، يتم احتسابها كـ "سلة توكنات" خاصة بها:

{
  "model": "tencent/hy3-preview:free",
  "messages": [
    {"role": "user", "content": "Plan, then write a Bash script that rotates daily log files older than 30 days into a dated archive folder."}
  ],
  "reasoning": {"effort": "high"}
}

1. كرر. حافظ على الجلسة في نفس الخيط إذا كنت تريد أن يبني النموذج على السياق السابق؛ نافذة Hy3 التي تبلغ 256 ألف توكن تتعامل مع معظم قواعد التعليمات البرمجية الكاملة من البداية إلى النهاية.

هذا هو التدفق بأكمله. النموذج الذي تستدعيه هو نفسه المنشور على Hugging Face؛ الجودة على الطبقة المجانية من OpenRouter مطابقة للمسارات المدفوعة على مقدمي الخدمات الآخرين.

مجاني، مدفوع، ومستضاف ذاتيًا: أين تختلف

المسار المجاني ليس هو الوحيد، ومن المفيد رؤية الاختلاف الحقيقي قبل الالتزام بواحد.

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

نصائح المطالبات والمعلمات للحصول على أقصى استفادة من Hy3

يكافئ Hy3 الإعداد الصريح أكثر من النماذج الأصغر. بعض العادات تساعد.

• طابق درجة الحرارة مع الوضع. توصي بطاقة النموذج بـ temperature=0.9 و top_p=1.0 كإعداد افتراضي. قم بالتقليل إلى 0.3 للإخراج المنظم، وابقَ على 0.9 للعمل الإبداعي.
• استخدم no_think للدردشة اليومية. وضع التفكير الافتراضي متوقف لسبب؛ لا تحتاج إلى low أو high إلا للتخطيط أو التعليمات البرمجية متعددة الخطوات أو الرياضيات. تشغيل high على سؤال من سطر واحد يهدر توكنات التفكير.
• اسم الأدوات في مطالبة النظام. تم تدريب Hy3 على استخدام الأدوات باستخدام محلل معين (hy_v3). حتى على OpenRouter، تحصل على استدعاءات أفضل عندما تصف مطالبة النظام وظيفة كل أداة بدلاً من الاعتماد على المخطط وحده.
• اقتبس التعليمات البرمجية، لا تلخصها. تتيح لك نافذة الـ 256 ألف توكن لصق ملفات كاملة. الصق الملف، ثم اطرح السؤال؛ لا تطلب من النموذج تخيل التعليمات البرمجية.
• معالجة تعديلات الملفات المتعددة دفعة واحدة. تأتي درجة Hy3's SWE-bench Verified البالغة 74.4 من تعديل عدة ملفات بشكل متسق. امنحه المجموعة الكاملة في رسالة واحدة بدلاً من تقطيرها واحدة تلو الأخرى.
• اطلب خطة أولاً. بالنسبة لمهام الوكيل، ينتج نمط من خطوتين ("صِغ خطة، انتظر تأكيدي، ثم نفذ") نتائج أنظف باستمرار من المطالبات ذات الطلقة الواحدة.

حدود جديرة بالمعرفة قبل النشر

بعض العوائق ستوقعك في الخطأ إذا تخطيتها.

• حدود المعدل تتغير مع الحمل. تشارك الطبقة المجانية من OpenRouter السعة عبر جميع المستخدمين المجانيين. عند الإطلاق، كان حجم المطالبات اليومي بالفعل 6.81 مليار توكن؛ قد تشهد الاستدعاءات في ساعات الذروة استجابات 429. ابنِ محاولات إعادة معالجة مع تأخير أسي.
• توكنات التفكير تُحتسب كإخراج. reasoning_details مجانية في الطبقة المجانية من OpenRouter، ولكن على المسارات المدفوعة يتم احتسابها كإخراج. لا تنشر إعدادات افتراضية لـ effort: "high" في منتج حساس للإيرادات دون قياس.
• الترخيص ليس Apache 2.0. يسمح ترخيص Tencent Hy Community بالاستخدام التجاري ولكنه يحمل بنودًا لسياسة الاستخدام والإسناد؛ اقرأ الترخيص الكامل على مستودع GitHub قبل تضمين Hy3 في منتج.
• استدعاء الأدوات يتطلب المحلل الصحيح. إذا كنت تستضيف ذاتيًا، قم بتشغيل vLLM أو SGLang باستخدام --tool-call-parser hy_v3 (أو hunyuan لـ SGLang). بدون ذلك، تعود استدعاءات الأدوات كنص عادي.
• الإنجليزية والصينية هي لغات من الدرجة الأولى؛ اللغات الأخرى من الدرجة الثانية. تُظهر درجات C-Eval 89.80 و CMMLU 89.61 قوة في اللغة الصينية. يتم دعم اللغات الأخرى عبر MMMLU ولكن جودتها تنخفض.
• يتأخر عن أفضل النماذج الرائدة الأمريكية في بعض معايير التفكير. تقع HLE عند 30، وتشير تغطية SCMP إلى أن Hy3 يتساوى مع أفضل النماذج الصينية ولكنه لا يزال متخلفًا عن النماذج الرائدة الحالية لـ OpenAI و Google DeepMind في أصعب مجموعات التفكير.

مسار المطور السريع: Hy3 Preview بالإضافة إلى Apidog

أوامر curl من سطر الأوامر جيدة للعرض التوضيحي. ولكن للتكرار الفعلي، يوفر عميل واجهة برمجة تطبيقات مرئي ساعات من العمل.

1. افتح Apidog وأنشئ مشروعًا جديدًا. استورد مواصفات OpenAI Chat Completions OpenAPI؛ يستخدم OpenRouter نفس المخطط.
2. عيّن عنوان URL الأساسي إلى https://openrouter.ai/api/v1 وأضف متغير بيئة لـ OPENROUTER_API_KEY.
3. أنشئ طلبًا يستدعي /chat/completions مع تعيين النموذج على tencent/hy3-preview:free.
4. انسخ الطلب لمقارنة أوضاع التفكير. يتيح لك Apidog تكرار طلب وتعديل معلمة واحدة، بحيث يمكنك تشغيل نفس المطالبة مع no_think و low و high جنبًا إلى جنب وفحص زمن الاستجابة واختلاف الإخراج.
5. احفظ قوالب المطالبات. تصبح مطالبات الوكيل طويلة. يحافظ نظام البيئة والمتغيرات في Apidog على فصل مطالبات النظام، ومخططات الأدوات، ودورات المستخدم حتى تتمكن من إعادة استخدامها عبر الاختبارات.

إذا كنت قادمًا من Postman، فإن التحول سريع؛ يغطي دليلنا لاختبار API بدون Postman في 2026 عملية الهجرة. يمكن للفرق التي تعمل ضمن محررها تشغيل نفس سير العمل داخل VS Code مع Apidog داخل VS Code، مما يحافظ على ضبط المطالبات بجانب الكود الذي يستهلك الإخراج.

بدائل مجانية عند بلوغ الحد الأقصى

إذا قام مجمع OpenRouter المجاني بتقييد سرعتك خلال ساعات الذروة، فإليك مساران يستحقان التجربة أولاً.

• مساحة Hugging Face. تستضيف مساحة Hy3-preview عرض دردشة في المتصفح. إنه غير قابل للبرمجة، لكنه مجاني ومفيد للمقارنات السريعة.
• نماذج صينية أخرى مجانية ذات أوزان مفتوحة. يقدم Qwen 3.5 Omni من Alibaba طبقة مجانية ذات إخراج قوي متعدد الوسائط؛ انظر إعلان Qwen 3.5 Omni والرفيق الإرشادي للإعداد. Zhipu GLM 5V Turbo هو خيار آخر مع طبقة مجانية سخية؛ دليل GLM 5V Turbo API يحتوي على الشرح الكامل.

لا تتطابق أي من هذه النماذج مع أرقام SWE-bench و Terminal-Bench لـ Hy3 للترميز الموجه للوكلاء، لكنها تغطي حالات استخدام الدردشة، ومتعدد اللغات، ومتعدد الوسائط التي لا تعطيها الطبقة المجانية من Hy3 أولوية. لإنشاء منتج، قم بتنزيل Apidog وقم بإعداد مجموعة واحدة لكل نموذج؛ فمعايير المقارنة جنبًا إلى جنب على مطالباتك الفعلية تتفوق على قراءة أي لوحة متصدرين.

الاستضافة الذاتية لـ Hy3 Preview باستخدام vLLM

إذا كان لديك الأجهزة اللازمة، فإن الاستدلال المحلي هو المسار الرابع المجاني. توصي بطاقة النموذج بـ vLLM مع توازي الموتر (tensor parallelism) بقيمة 8 وتمكين التنبؤ متعدد التوكنات لفك التشفير التخميني:

vllm serve tencent/Hy3-preview \
  --tensor-parallel-size 8 \
  --speculative-config.method mtp \
  --speculative-config.num_speculative_tokens 1 \
  --tool-call-parser hy_v3 \
  --reasoning-parser hy_v3 \
  --enable-auto-tool-choice \
  --served-model-name hy3-preview

يستخدم أمر SGLang المكافئ --tool-call-parser hunyuan و --reasoning-parser hunyuan. بمجرد أن يصبح الخادم جاهزًا على http://localhost:8000/v1، يمكن لأي حزمة تطوير برمجيات (SDK) من OpenAI الإشارة إليه بنفس الطريقة التي تشير بها إلى OpenRouter؛ فقط عنوان URL الأساسي والمفتاح يتغيران.

توقع ثماني وحدات معالجة رسوميات من فئة H100 بدقة BF16 للنموذج الكامل. ستظهر إصدارات مجتمعية مكمّاة، ولكن عند الإطلاق، المسار الرسمي هو الدقة الكاملة.

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

هل Hy3 Preview مجاني؟
نعم. يسرد OpenRouter tencent/hy3-preview:free بتكلفة 0 دولار لكل مليون توكن إدخال و 0 دولار لكل مليون توكن إخراج. توكنات التفكير في الطبقة المجانية مجانية أيضًا، على الرغم من أنها تُحتسب ضمن حدود المعدل. تأكد من الحالة الحالية على صفحة نموذج OpenRouter قبل الاعتماد عليه للإنتاج.

كيف يقارن Hy3 Preview بـ DeepSeek V3 و Qwen 3؟
درجة Hy3 Preview في SWE-bench Verified البالغة 74.4 و Terminal-Bench 2.0 البالغة 54.4 تضعه في نفس مستوى أفضل النماذج الصينية المفتوحة، مع ميل واضح للوكيل واستخدام الأدوات. بالنسبة للدردشة النقية، فإن Qwen 3 و DeepSeek V3 تنافسيان؛ أما بالنسبة لسير عمل الوكيل والترميز، فإن استخدام الأدوات المدرب بـ RL في Hy3 هو العامل المميز.

ما هي أوضاع التفكير في Hy3؟
ثلاثة: no_think (افتراضي، إجابة مباشرة)، low، و high. قم بالتبديل بينها عبر معلمة reasoning على OpenRouter أو عبر chat_template_kwargs={"reasoning_effort": "high"} عند استدعاء النموذج مباشرة. استخدم high للتخطيط، والتعليمات البرمجية متعددة الخطوات، والرياضيات؛ واتركه متوقفًا للدردشة.

هل يمكنني استخدام Hy3 Preview تجاريًا؟
نعم، بموجب ترخيص Tencent Hy Community. يسمح الترخيص بالاستخدام التجاري مع الإسناد والامتثال لسياسة الاستخدام. اقرأ الشروط الكاملة على مستودع Hy3 على GitHub قبل نشره في منتج يولد إيرادات.

ما هو طول السياق الذي تدعمه الطبقة المجانية؟
256 ألف توكن من البداية إلى النهاية. تُظهر قائمة OpenRouter 262,144 توكنًا، متطابقة مع بطاقة النموذج. يمكنك لصق قاعدة تعليمات برمجية كاملة متوسطة الحجم ولا يزال لديك مساحة لمخططات الأدوات وتاريخ المحادثة.

كيف أختبر Hy3 Preview دون كتابة كود؟
استخدم مساحة Hugging Face لعرض دردشة في المتصفح، أو وجه Apidog إلى نقطة نهاية OpenRouter. يستورد Apidog مواصفات OpenAI OpenAPI، لذا فإن تكوين الطلب يتطلب ثلاثة حقول: عنوان URL الأساسي، ومفتاح API، واسم النموذج.