DEV Community

Cover image for كيفية استخدام Hy3 Preview API مجانًا؟
Yusuf Khalidd
Yusuf Khalidd

Posted on • Originally published at apidog.com

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

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

جرّب Apidog اليوم

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

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

باختصار

  • Hy3 Preview مجاني على OpenRouter عبر معرف النموذج tencent/hy3-preview:free (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.
  • 3 طرق مجانية للتشغيل:
    1. OpenRouter (طبقة مجانية)
    2. مساحة Hy3-preview في Hugging Face
    3. الاستدلال المحلي باستخدام vLLM والأوزان المفتوحة.
  • تكامل Apidog: Hy3 يستخدم مخطط OpenAI Chat Completions، وبالتالي يمكن استخدام Apidog مباشرة مع نقطة نهاية 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).
  • الترميز: مفردات 120,832 إدخال بدقة BF16.
  • الترخيص: ترخيص Tencent Hy Community للاستخدام التجاري بشروط الترخيص.

نقطة القوة الأساسية: تدريب موجه للوكلاء مع بنية تحتية حديثة للتعلم المعزز واستخدام أدوات متعدد الأدوار، مما يضعه قريباً من أفضل النماذج المغلقة في مهام الكود وCLI حسب نتائج SWE-bench وTerminal-Bench.

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

حدد المسار الأنسب حسب احتياجك:

المسار ما هو مجاني؟ مناسب لـ
OpenRouter tencent/hy3-preview:free API متوافقة مع OpenAI نعم بناء الوكلاء، السكربتات، الخلفيات
مساحة Hugging Face دردشة متصفح نعم مطالبات سريعة، تجارب أولية
أوزان ذاتية الاستضافة (vLLM/SGLang) تشغيل الأوزان على GPU خاصتك مجاني (تكلفة العتاد) الخصوصية، الأحمال الكبيرة

معظم المطورين يختارون OpenRouter لسهولة الاستخدام وحدود المعدل السخية للطبقة المجانية.

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

للحصول على استجابة من tencent/hy3-preview:free بسرعة:

  1. أنشئ حساب OpenRouter:

    سجّل في openrouter.ai. لا حاجة لطريقة دفع للنماذج المجانية.

  2. أنشئ مفتاح API:

    من لوحة OpenRouter > "Keys" > أنشئ مفتاح جديد. خزنه في متغير بيئة:

   export OPENROUTER_API_KEY=sk-or-...
Enter fullscreen mode Exit fullscreen mode
  1. افتح صفحة النموذج: زر قائمة Hy3 Preview المجانية وتأكد أن الحالة "Free".

  1. أرسل الطلب الأول: OpenRouter يدعم مخطط OpenAI Chat Completions. أي SDK لـ OpenAI يعمل. مثال عبر curl: 
   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": "اشرح آلية توجيه MoE في إعداد top-8 من 192 في 3 جمل."}
       ],
       "temperature": 0.9,
       "top_p": 1.0
     }'
Enter fullscreen mode Exit fullscreen mode
  1. تشغيل وضع التفكير: Hy3 يقبل معلمة reasoning مع effort: low أو effort: high. مثال: 
   {
     "model": "tencent/hy3-preview:free",
     "messages": [
       {"role": "user", "content": "خطط واكتب سكربت Bash يدوّر سجلات أقدم من 30 يوم إلى مجلد أرشيف بتاريخ."}
     ],
     "reasoning": {"effort": "high"}
   }
Enter fullscreen mode Exit fullscreen mode
  1. استمر بنفس الخيط: استخدم نفس الـ thread للحفاظ على السياق؛ نافذة 256K توكن تتيح لك العمل مع قواعد كود كاملة.

الجودة على الطبقة المجانية في OpenRouter مطابقة للمدفوعة على مزودين آخرين.

مجاني، مدفوع، ومستضاف ذاتيًا: المقارنة

القدرة OpenRouter مجاني OpenRouter مدفوع مستضاف ذاتيًا (vLLM/SGLang)
تكلفة التوكن 0 دولار حسب المزود كهرباء + استهلاك GPU
أوضاع التفكير جميعها جميعها جميعها
طول السياق 256K 256K 256K (حسب الذاكرة)
الأداء تحت الحمل مجمع مشترك مخصص حسب العتاد
حدود المعدل حسب OpenRouter حسب المزود لا يوجد
احتفاظ البيانات سياسة OpenRouter حسب المزود على أجهزتك
رؤية توكن التفكير نعم نعم نعم

الخيار المجاني مناسب للنماذج الأولية والمشاريع الجانبية. الخيار المدفوع أو المستضاف ذاتيًا مطلوب للأداء الحرج أو السعة الأعلى.

نصائح عملية لضبط Hy3

  • اضبط درجة الحرارة حسب المهمة: استخدم temperature=0.9, top_p=1.0 افتراضيًا. خفّض إلى 0.3 للإخراج المنظم.
  • ضع وضع التفكير على no_think للدردشة البسيطة: استخدم low أو high فقط للتخطيط، الأكواد متعددة الخطوات، أو المسائل الرياضية.
  • سمِّ الأدوات في مطالبة النظام: Hy3 درب على أدوات محددة، لذا وصف الأداة في system prompt يعطي نتائج أفضل.
  • ألصق الكود بدلاً من تلخيصه: استخدم نافذة 256K لصق ملفات كاملة واطلب التعديلات مباشرة.
  • عالج تعديلات الملفات دفعة واحدة: Hy3 يتعامل بشكل أفضل مع تعديلات متعددة بنفس الرسالة.
  • اطلب خطة أولاً في مهام الوكيل: نمط "خطط، ثم نفذ" يعطي نتائج أنظف من الطلبات المباشرة.

حدود يجب الانتباه لها قبل النشر

  • حدود المعدل ديناميكية: قد تواجه استجابات 429 في ساعات الذروة. نفذ آلية إعادة المحاولة مع تأخير متزايد.
  • توكنات التفكير تحسب كإخراج: مجانية في الطبقة المجانية، لكن تحسب في المدفوعة.
  • الترخيص ليس Apache 2.0: راجع شروط ترخيص Tencent Hy Community قبل دمج النموذج في منتج تجاري.
  • استدعاء الأدوات يتطلب المحلل الصحيح: في الاستضافة الذاتية، استخدم --tool-call-parser hy_v3 مع vLLM أو hunyuan مع SGLang.
  • الإنجليزية والصينية أولويتان: اللغات الأخرى مدعومة بجودة أقل.
  • متأخر قليلاً عن أفضل النماذج الأمريكية في بعض المعايير: الأفضلية في الوكلاء، مع بعض الفجوة في معايير التفكير المعقدة.

مسار المطور السريع: Hy3 Preview + Apidog

استخدام curl جيد للعرض السريع، لكن التكرار الفعلي أسرع عبر عميل API مرئي مثل Apidog.

  1. افتح Apidog وأنشئ مشروع جديد.

    استورد مواصفات OpenAI Chat Completions OpenAPI.

  2. اضبط عنوان URL الأساسي:

    استخدم https://openrouter.ai/api/v1 وعيّن متغير بيئة OPENROUTER_API_KEY.

  3. أنشئ طلب جديد:

    نفّذ /chat/completions مع النموذج tencent/hy3-preview:free.

  4. انسخ الطلب للمقارنة:

    جرب أوضاع التفكير الثلاثة (no_think, low, high) وقارن النتائج مباشرة في Apidog.

  5. احفظ قوالب المطالبات:

    استفد من نظام القوالب والمتغيرات لإعادة استخدام المطالبات وتهيئة أدواتك بسرعة.

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

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

إذا واجهت حدود الطبقة المجانية في OpenRouter، جرب التالي:

هذه النماذج لا تتطابق مع أرقام Hy3 في مهام SWE-bench/Terminal-Bench، لكنها جيدة للدردشة وحالات الاستخدام المتعددة. أنشئ مجموعة في Apidog وقارن النتائج فعليًا.

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

إذا كان لديك عتاد مناسب، اتبع الخطوات التالية لتشغيل النموذج محليًا:

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
Enter fullscreen mode Exit fullscreen mode

لـ SGLang استخدم --tool-call-parser hunyuan و--reasoning-parser hunyuan. بعد تشغيل الخادم على http://localhost:8000/v1، استخدم أي SDK متوافق مع OpenAI بتغيير الـ endpoint فقط.

النموذج الكامل يتطلب 8 وحدات معالجة رسومية فئة H100 بدقة BF16. ستظهر نسخ مكمّاة لاحقًا.

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

هل Hy3 Preview مجاني؟

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

كيف يقارن Hy3 Preview بـ DeepSeek V3 و Qwen 3؟

درجات SWE-bench Verified (74.4) وTerminal-Bench (54.4) تضعه في قمة النماذج الصينية. ميزة Hy3 في تدريب الوكيل واستخدام الأدوات المدرب بـ RL. للدردشة، Qwen 3 وDeepSeek V3 أيضًا منافسان.

ما هي أوضاع التفكير في Hy3؟

ثلاثة أوضاع:

  • no_think للإجابات المباشرة (افتراضي)
  • low
  • high بدل بينها عبر معلمة reasoning في OpenRouter أو chat_template_kwargs={"reasoning_effort": "high"} عند الاستدعاء المباشر.

هل يمكنني استخدام Hy3 Preview تجاريًا؟

نعم، بموجب ترخيص Tencent Hy Community مع الإسناد والالتزام بشروط الاستخدام. راجع مستودع GitHub للاطلاع على الترخيص الكامل.

ما هو طول السياق المدعوم في الطبقة المجانية؟

256 ألف توكن. قائمة OpenRouter تعرض 262,144 توكن مطابقة لبطاقة النموذج.

كيف أختبر Hy3 Preview دون كتابة كود؟

جرب مساحة Hy3-preview على Hugging Face، أو وجّه Apidog إلى نقطة نهاية OpenRouter. في Apidog، استورد مواصفات OpenAI OpenAPI وحدد: عنوان URL الأساسي، مفتاح API، واسم النموذج.

Top comments (0)