واجهة برمجة تطبيقات Hunyuan Image 3 على Novita AI: دليل إنشاء الصور من النص

واجهة برمجة تطبيقات Hunyuan Image 3 على Novita AI: دليل إنشاء الصور من النص

نموذج Tencent Hunyuan Image 3 متاح الآن على Novita AI كواجهة برمجة تطبيقات غير متزامنة لإنشاء الصور من النص على الرابط https://api.novita.ai/v3/async/hunyuan-image-3. يستخدم النموذج بنية خبراء مختلطة (MoE) تحتوي على 80 مليار معلمة — وهو أكبر نموذج مفتوح المصدر من نوعه حتى الآن — ويُعد خيارًا عمليًا للمطورين الذين يحتاجون إلى عرض نصوص قوي متعدد اللغات، واتباع دقيق للتعليمات النصية، وتحجيم مرن للمخرجات بسعر 0.10 دولار لكل صورة. يغطي هذا الدليل ما يجيده النموذج، وكيفية دمجه، وأين يتناسب ضمن خط إنتاج الصور.

النقاط الرئيسية

  • Hunyuan Image 3 متاح على Novita AI عبر POST https://api.novita.ai/v3/async/hunyuan-image-3، بسعر 0.10 دولار/صورة (تم التحقق في 2026-07-06).
  • يستخدم النموذج بنية MoE بحجم 80 مليار معلمة (13 مليار معلمة نشطة لكل رمز) مع إطار عمل موحد لتوليد الصور بشكل تلقائي.
  • يدعم بشكل أصلي التعليمات النصية باللغتين الصينية والإنجليزية مع عرض قوي للنصوص داخل الصورة.
  • واجهة البرمجة غير متزامنة: ترسل طلبًا، تحصل على task_id، ثم تستطلع واجهة نتيجة المهمة للحصول على المخرجات.
  • الاستخدام العملي: المشاهد المعقدة متعددة اللغات، الصور المحتوية على نصوص كثيفة، وخطوط الإنتاج التي تحتاج إلى تفسير تعليمات على مستوى الاستدلال.

ما هو Hunyuan Image 3؟

Hunyuan Image 3 (HunyuanImage 3.0) هو الجيل الثالث من نموذج Tencent لإنشاء الصور من النص، والذي تم إصداره كمصدر مفتوح في سبتمبر 2025. على عكس معظم نماذج إنشاء الصور المبنية على بنية المحول الانتشارية (DiT)، يستخدم Hunyuan Image 3 إطارًا تلقائيًا موحدًا يعالج إنشاء النص والصورة كمشكلة نمذجة واحدة — نفس النهج المعماري المستخدم في نماذج اللغة الضخمة.

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

حقائق رئيسية عن البنية (المصدر: التقرير الفني لـ HunyuanImage 3.0، arXiv 2509.23951، سبتمبر 2025):

  • 80 مليار معلمة إجمالية، 64 خبيرًا، ~13 مليار معلمة نشطة لكل رمز
  • إطار عمل متعدد الوسائط موحد تلقائي (ليس قائمًا على DiT)
  • استدلال سلسلة الأفكار عبر رموز التفكير
  • تدريب معزز بعد التدريب لمحاذاة التعليمات
  • دعم أصلي للغتين الصينية والإنجليزية

مقارنة بـ Hunyuan Image 2.1، يُظهر إصدار 3.0 تحسنًا بنسبة 14.1% في معدل الفوز النسبي في التقييم البشري المهني لجودة الصورة ومحاذاة النص.

الوصول إلى واجهة برمجة تطبيقات Hunyuan Image 3 على Novita AI

تستضيف Novita AI نموذج Hunyuan Image 3 كواجهة برمجة تطبيقات للمهام غير المتزامنة. سير العمل هو:

  1. أرسل طلب إنشاء إلى https://api.novita.ai/v3/async/hunyuan-image-3
  2. استلم task_id في الرد
  3. استطلع https://api.novita.ai/v3/async/task-result باستخدام task_id حتى تصبح حالة المهمة TASK_STATUS_SUCCEED
  4. استخرج رابط الصورة من النتيجة

احصل على مفتاح API الخاص بك من لوحة تحكم Novita AI. الحسابات الجديدة تحصل على رصيد مجاني بقيمة دولار واحد.

ملخص مواصفات وتسعير Hunyuan Image 3

الحقل التفاصيل المصدر / تاريخ التحقق
الاسم المعروض Hunyuan Image 3 وثائق Novita AI / 2026-07-06
نقطة النهاية /v3/async/hunyuan-image-3 وثائق Novita AI / 2026-07-06
الرابط الأساسي https://api.novita.ai وثائق Novita AI / 2026-07-06
البنية MoE بحجم 80 مليار معلمة، تلقائي، 13 مليار نشطة arXiv 2509.23951 / سبتمبر 2025
اللغات المدعومة الإنجليزية، الصينية مستودع Tencent HunyuanImage-3.0 / سبتمبر 2025
تنسيق المخرجات JPEG (افتراضي) وثائق Novita AI / 2026-07-06
التسعير 0.10 دولار لكل صورة novita.ai/models / 2026-07-06
نوع الواجهة غير متزامنة (إرسال + استطلاع) وثائق Novita AI / 2026-07-06
أفضل استخدام المشاهد متعددة اللغات، الصور المحتوية على نصوص كثيفة، تفسير التعليمات المعقدة تقييم

القدرات الرئيسية للمطورين

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

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

التسعير المرن. تقبل الواجهة معلمة size بتنسيق width*height، تغطي مجموعة واسعة من نسب الأبعاد لمخرجات الويب ووسائل التواصل الاجتماعي والطباعة.

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

متى تستخدم Hunyuan Image 3

  • تعليماتك النصية قصيرة أو مقدمة من المستخدم وتحتاج إلى تفصيل ذكي قبل الإنشاء
  • تحتاج إلى نصوص مقروءة بالصينية أو الإنجليزية داخل الصورة
  • تقوم بإنشاء أصول تسويقية مترجمة، أو صور منتجات، أو رسوم تحريرية
  • تصف تعليماتك مشاهد معقدة تحتوي على عناصر دلالية متعددة تحتاج إلى تكوين متماسك

متى لا تستخدم Hunyuan Image 3

  • تحتاج أقل تكلفة لكل صورة: بسعر 0.10 دولار/صورة، البدائل مثل Qwen Image على Novita AI (0.02 دولار/صورة) أو Seedream 3.0 (0.03 دولار/صورة) أرخص بكثير لخطوط الإنتاج عالية الحجم حيث لا يكون عرض النصوص والاستدلال أمرًا بالغ الأهمية.
  • تحتاج إلى تحرير الصور أو إعادة التلوين: Hunyuan Image 3 هو نص إلى صورة فقط. لسير عمل تحرير الصور، استخدم نموذج تحرير مخصص.
  • تحتاج أوقات استجابة أقل من ثانية: البنية غير المتزامنة تضيف تأخيرًا من الاستطلاع. إنها غير مناسبة للتطبيقات التفاعلية في الوقت الفعلي.

بداية سريعة لواجهة البرمجة

Python

import requests
import time

API_KEY = "YOUR_NOVITA_API_KEY"
BASE_URL = "https://api.novita.ai"

def generate_image(prompt: str, size: str = "1024*1024", seed: int = -1) -> str:
    # إرسال طلب الإنشاء
    response = requests.post(
        f"{BASE_URL}/v3/async/hunyuan-image-3",
        headers={
            "Authorization": f"Bearer {API_KEY}",
            "Content-Type": "application/json",
        },
        json={
            "prompt": prompt,
            "size": size,
            "seed": seed,
        },
    )
    response.raise_for_status()
    task_id = response.json()["task_id"]

    # استطلاع النتيجة
    while True:
        result = requests.get(
            f"{BASE_URL}/v3/async/task-result",
            headers={"Authorization": f"Bearer {API_KEY}"},
            params={"task_id": task_id},
        )
        result.raise_for_status()
        data = result.json()
        status = data.get("task", {}).get("status")
        if status == "TASK_STATUS_SUCCEED":
            return data["images"][0]["image_url"]
        elif status == "TASK_STATUS_FAILED":
            raise RuntimeError(f"فشل الإنشاء: {data}")
        time.sleep(2)

image_url = generate_image(
    prompt="صورة منتج بسيطة لعلبة ماتشا يابانية فاخرة على سطح رخام أبيض، إضاءة استوديو",
    size="1024*1024",
)
print(image_url)

cURL

# الخطوة 1: إرسال الطلب
curl -s -X POST https://api.novita.ai/v3/async/hunyuan-image-3 \
  -H "Authorization: Bearer $NOVITA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "كشك طعام شارعي مضاء بالنيون في هونغ كونغ ليلاً، سينمائي، انعكاسات مطرية",
    "size": "1280*720",
    "seed": -1
  }'

# الرد: {"task_id": "..."}

# الخطوة 2: استطلاع النتيجة
curl -s "https://api.novita.ai/v3/async/task-result?task_id=YOUR_TASK_ID" \
  -H "Authorization: Bearer $NOVITA_API_KEY"

معاملات الطلب

المعامل النوع مطلوب ملاحظات
prompt string نعم وصف نصي للصورة. يدعم الإنجليزية والصينية.
size string لا أبعاد المخرجات بصيغة width*height (مثال: "1024*1024"، "1280*720"، "768*1024")
seed integer لا -1 لعشوائي؛ قم بتعيين قيمة ثابتة لإعادة إنتاج النتائج

قيم حالة نتيجة المهمة

الحالة المعنى
TASK_STATUS_QUEUED تم استلام الطلب، في انتظار التشغيل
TASK_STATUS_RUNNING الإنشاء قيد التقدم
TASK_STATUS_SUCCEED مكتمل — رابط الصورة متاح في images[0].image_url
TASK_STATUS_FAILED فشل الإنشاء

كيف يتناسب Hunyuan Image 3 مع سير عمل واجهة البرمجة الخاص بك

النمط غير المتزامن المستخدم من قبل Hunyuan Image 3 على Novita AI هو نفسه المستخدم في نقاط نهاية إنشاء الصور والفيديو الأخرى على المنصة — أرسل مهمة، استلم task_id، استطلع النتائج. إذا كنت تستخدم بالفعل FLUX.1 Dev على Novita AI أو عائلة Kontext، فإن التبديل إلى Hunyuan Image 3 هو تغيير بسيط في نقطة النهاية بالإضافة إلى تحديث جسم الطلب.

اختلاف عملي واحد: يأخذ Hunyuan Image 3 جسم طلب مسطح (prompt، size، seed) بدلاً من كائنات input/parameters المتداخلة. تحقق من وثائق Novita AI للمخطط الأساسي قبل الدمج.

التوصية النهائية

Hunyuan Image 3 هو الاختيار الصحيح على Novita AI عندما يكون الاستدلال على التعليمات، أو عرض النصوص متعددة اللغات، أو تكوين المشاهد المعقدة أكثر أهمية من التكلفة. بسعر 0.10 دولار لكل صورة، فهو في الطرف الأعلى من كتالوج صور Novita AI — حوالي 3 أضعاف سعر Seedream 3.0 و5 أضعاف Qwen Image — لكنه يقدم قدرة مختلفة بشكل هادف: يفسر النموذج التعليمات المقتضبة، وينتج نصوصًا مقروءة بالصينية والإنجليزية داخل الصور، ويتعامل مع المشاهد كثيفة الدلالات حيث تميل النماذج الأبسط إلى إنتاج تركيبات غير متماسكة.

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

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

ما هي نقطة نهاية Novita AI لـ Hunyuan Image 3؟

POST https://api.novita.ai/v3/async/hunyuan-image-3. الواجهة غير متزامنة — ترسل طلبًا، تحصل على task_id، ثم تستطلع /v3/async/task-result حتى تصبح الحالة TASK_STATUS_SUCCEED.

كم تكلفة Hunyuan Image 3 على Novita AI؟

0.10 دولار لكل صورة اعتبارًا من 2026-07-06 (المصدر: novita.ai/models). تحقق من التسعير الحالي على صفحة تسعير Novita AI قبل بناء نموذج تكلفة لأحمال العمل الإنتاجية.

ما الذي يجعل Hunyuan Image 3 مختلفًا عن FLUX.1 أو Stable Diffusion؟

يستخدم Hunyuan Image 3 إطارًا متعدد الوسائط موحدًا تلقائيًا بدلاً من بنية المحول الانتشارية (DiT) المستخدمة من قبل FLUX.1 ومعظم متغيرات Stable Diffusion. التأثير العملي هو استدلال أقوى على التعليمات عبر رموز تفكير سلسلة الأفكار، وعرض نصوص متعددة اللغات أفضل، ومعالجة أكثر تماسكًا للمشاهد المعقدة متعددة العناصر.

هل يدعم Hunyuan Image 3 تحرير الصور أو إعادة التلوين؟

لا. النموذج على Novita AI هو نص إلى صورة فقط. لتحرير الصور، استخدم نموذج تحرير مخصص مثل FLUX.1 Kontext أو Qwen-Image-Edit.

هل يمكنني استخدام تعليمات نصية باللغة الصينية مع Hunyuan Image 3؟

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

كيف يمكنني إعادة إنتاج مخرجات صورة محددة؟

قم بتعيين معامل seed إلى قيمة عدد صحيح ثابت. نفس مجموعة seed وprompt وsize ستعيد إنتاج نفس الصورة.

مقالات موصى بها