Qwen: Qwen Image 3 Pro

Qwen-Image-3.0 Pro هو نموذج Qwen الرائد لتوليد الصور وتحريرها، للتخطيطات المعقّدة والتفاصيل الواقعية والنصوص متعددة اللغات. استخدم تعليمات دقيقة أو مرجعًا واحدًا إلى ثلاثة مراجع لإنشاء تصميم بصري أو مشهد منتج أو تعديل بصري محدّد.

Ailoot Ultra · الصور POST /v1/images/generations qwen/qwen-image-3-pro

عن النموذج

يغطي هذا الوصف قدرات النموذج. وترد أدناه المدخلات والمخرجات والخيارات المتاحة في Ailoot للطريقة المحددة.

Qwen-Image-3.0 Pro هو نموذج Qwen الرائد من الجيل الثالث لتوليد الصور وتحريرها. يجمع إنشاء التخطيطات المعقّدة والخامات الواقعية المفصّلة والطباعة متعددة اللغات والالتزام الدقيق بتعليمات الصورة. يشترك Pro وQwen-Image-3.0 القياسي في وضعي التوليد والتحرير الموثّقين؛ ويركّز Pro على جودة الصورة، بينما يوازن الإصدار القياسي بين الجودة والسرعة. الناتج صورة مُصيّرة.

لرسم معلوماتي غني بالمحتوى، حدّد المحتوى قبل المظهر: العنوان الرئيسي والنص الداعم والأرقام والتسلسل الهرمي والعلاقة بين الأقسام. يمكن لتعليمات منتج مفيدة الجمع بين عنصر رئيسي وتفاصيل مقرّبة للخامات وميزات معنونة على لوحة واحدة. ولرسم تعليمي، حدّد المفهوم وبنية المخطط والتعليقات الدقيقة بدلًا من الاعتماد على النموذج لاختراع الحقائق الأساسية. يمكن للتخطيطات المعقّدة أيضًا عرض عدة لوحات أو واجهات متداخلة. أبقِ الحد الأقصى الموصى به للتعليمات، 4,500 توكن، مركّزًا على ما يجب أن يظهر ومكانه.

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

يمكن لـ Pro تحرير النص داخل الصورة وإضافة عناصر أو حذفها أو نقلها وتغيير حركة موضوع الصورة ونقل الأسلوب البصري وتعزيز التفاصيل. يقبل التحرير صورة إدخال واحدة إلى ثلاث صور مع تعليمات. يحدّد ترتيبها الصورة 1 والصورة 2 والصورة 3 في التعليمات. حدّد المرجع الذي يوفّر هوية الموضوع والذي يوفّر عنصرًا أو ملابس والذي يساهم بإعداد المشهد أو الوضعية. يسمّي التعديل المحدّد التغيير المقصود والميزات التي ينبغي أن تبقى دون تغيير، مما يسهّل مقارنة الصورة الناتجة بالمراجع.

المدخلات المدعومة هي JPG وJPEG وPNG وBMP وTIFF وWebP وGIF، مع استخدام الإطار الأول فقط من ملفات GIF المتحرّكة. يمكن أن يصل حجم كل صورة إدخال إلى 10 MB. تقبل واجهة API المحدّدة أضلاعًا من 1 إلى 8,000 بكسل ونسبة بين الضلع الأطول والأقصر لا تزيد على 10:1؛ ونطاقها الموصى به هو 384–2,048 بكسل. يوصي دليل التحرير بشكل منفصل بصور تصل إلى 3,072 بكسل، لذا تعامل مع اختيار المدخلات كإعداد للتفاصيل المطلوبة، لا كوعد بأن كل دقة تحسّن النتيجة. استخدم مرجعًا مقروءًا ومؤطّرًا بشكل مناسب للنص الدقيق أو خصائص الخامات.

المخرجات PNG. يُرجع سير عمل المطوّر بديلًا واحدًا إلى ستة بدائل، والافتراضي بديل واحد، ويدعم مساحة بكسلات إجمالية من 512 × 512 إلى 2,048 × 2,048 بنسب أبعاد من 1:8 إلى 8:1. تسمح ميزانية مساحة البكسلات ببعض الأبعاد غير المربّعة التي يتجاوز ضلعها الأطول 2,048 بكسل. عند عدم تحديد الحجم، يوصي النموذج بدقة بناءً على التعليمات. اختر الشكل المناسب لموضع الاستخدام الفعلي، ثم قارن البدائل المولّدة من حيث اكتمال المحتوى وتفاصيل الموضوع والطباعة عند حجم العرض المقصود.

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

تفحص خطوة عملية لمراجعة النتيجة النص الدقيق والأرقام وترتيب القراءة والالتزام بالمراجع والحواف أو الخامات المهمة للتصميم. عندما يحتاج جزء معيّن إلى تنقيح، احتفظ بالتكوين الناجح وصِف التغيير المحدّد. احتفظ بكل الصور المختارة مع تعليماتها ومراجعها، لأن مواقع مخرجات المطوّر تنتهي صلاحيتها بعد 24 ساعة. تخص أوضاع Pro وحدوده الموثّقة إصدار 3.0؛ أما دعم عشرة مراجع والشفافية الأصلية الموصوفان لـ Qwen 2.1 فهما قدرات إصدار منفصل.

Ailoot Ultra · الصور POST /v1/images/generations qwen/qwen-image-3-pro

qwen/qwen-image-3-pro

Alibaba /qwen/qwen-image-3-pro

البداية

المدخلات المقبولة: النص · الصور
النتائج: الصور

متاح في Ailoot · المدخلات والطرائق

Ailoot Ultra · الصور POST /v1/images/generations

الإدخال: text, image
الإخراج: image

الحقل	النوع	المتطلب	القيم والحدود	القيمة الافتراضية
الحقل`model`	النوع`string`	المتطلبمطلوب	القيم والحدود qwen/qwen-image-3-pro	القيمة الافتراضية—
الحقل`prompt`	النوع`string`	المتطلبمطلوب	القيم والحدود الحد الأدنى للطول: ⁦1⁩	القيمة الافتراضية—
الحقل`resolution`	النوع`string`	المتطلباختياري	القيم والحدود 1K, 2K	القيمة الافتراضية—
الحقل`aspect_ratio`	النوع`string`	المتطلباختياري	القيم والحدود 1:1, 1:2, 1:4, 2:1, 2:3, 3:2, 3:4, 4:1, 4:3, 4:5, 5:4, 9:16, 16:9	القيمة الافتراضية—
الحقل`n`	النوع`integer`	المتطلباختياري	القيم والحدود الحد الأدنى: ⁦1⁩ الحد الأقصى: ⁦6⁩	القيمة الافتراضية—
الحقل`input_references`	النوع`array`	المتطلباختياري	القيم والحدود الحد الأدنى للعناصر: ⁦0⁩ الحد الأقصى للعناصر: ⁦4⁩	القيمة الافتراضية—
الحقل`provider`	النوع`object`	المتطلباختياري	القيم والحدود	القيمة الافتراضية—

معلمات الطريقة ودورة حياتها

المعلمة	المواصفات
المعلمة`content_type`	المواصفاتapplication/json
المعلمة`required`	المواصفاتmodel, prompt
المعلمة`material_types`	المواصفاتtext, image

دورة الحياة: synchronous_result_then_owned_library

GET /v1/media/tasks/{task_id} · قيمة task_id الفعلية المُعادة أو سجل مكتبة الوسائط

GET /v1/media/assets/{asset_id}/content

GET /v1/media/assets

GET /v1/media/assets/{asset_id}

الباقات

كيفية احتساب الرسوم النهائية

تقدّر التعرفات المعروضة التكلفة قبل التوليد. تُحسب الرسوم النهائية من التكلفة المسجّلة لعملية التوليد الأصلية. مدة المخرجات المقاسة والكميات المتوقعة ليست الكمية النهائية الخاضعة للفوترة.

مراجع التسعير لا تضيف خيارات للطلب. المعلمات المدعومة مذكورة للطريقة المحددة.

الوضع السريع: غير محدد عند اختيار الوضع السريع
الوضع المرن: غير محدد عند اختيار وضع flex
أقصى جهد للاستدلال: غير محدد عندما يُطبَّق الضبط الافتراضي default مع أقصى جهد للاستدلال

تعرفات تقديرية للمقارنة

الأسعار حسب الإعدادات

طابق كل رسم مع الشروط المعروضة. طبّق تعرفة واحدة لكل مجموعة من الإعدادات البديلة.

الإعدادات	جدول التعرفة	الكمية المتوقعة	وحدة الفوترة	الرسوم
الإعداداتالتعرفات الأساسية للرموز	جدول التعرفةالتعرفة الأساسية	الكمية المتوقعة—	وحدة الفوترة—	الرسوم الإدخال · رموز الإدخال · تقدير للمقارنة فقط — / 1K من الرموز الإخراج · رموز الإخراج · تقدير للمقارنة فقط — / 1K من الرموز الإدخال · قراءة ذاكرة التخزين المؤقت · تقدير للمقارنة فقط — / 1K من الرموز الإدخال · الكتابة إلى ذاكرة التخزين المؤقت · تقدير للمقارنة فقط — / 1K من الرموز الإدخال · الكتابة إلى ذاكرة التخزين المؤقت، 1 ساعة · تقدير للمقارنة فقط — / 1K من الرموز
الإعداداتصورة إدخال	جدول التعرفة—	الكمية المتوقعة—	وحدة الفوترةلكل صورة مُدخلة	الرسوم الإدخال · صورة إدخال · تقدير للمقارنة فقط $0.006 لكل صورة مُدخلة
الإعداداتتكلفة التوليد التقديرية	جدول التعرفة—	الكمية المتوقعةتقدير لتوليد واحد	وحدة الفوترة—	الرسوم الإخراج · تكلفة التوليد التقديرية · تقدير للمقارنة فقط $0.08 تقدير قبل الإنشاء هذا التقدير ليس رسومًا إضافية ولا تعرفة ثابتة لعملية التوليد المكتملة.

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

أمثلة للطلبات

Ailoot Ultra · الصور

curl

set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p={'model': 'qwen/qwen-image-3-pro', 'prompt': 'a red panda astronaut floating in space, studio lighting'}

Path("request.json").write_text(json.dumps(p,ensure_ascii=False))
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/images/generations \
  -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
  --data-binary @request.json -D response-headers.txt -o result.json
python3 - <<'PY_RESULT'
import base64, json, os, subprocess
from pathlib import Path
from urllib.parse import urlsplit, urljoin

def save_images(items):
    if not items: raise SystemExit("No completed images; retain the full response")
    for index, item in enumerate(items):
        encoded=item.get("b64_json")
        uri=item.get("url", "")
        if not encoded and uri.startswith("data:image/"):
            header, separator, encoded=uri.partition(",")
            if not separator or ";base64" not in header: raise SystemExit("Unsupported image data URI")
        if encoded:
            raw=base64.b64decode(encoded,validate=True)
        elif uri:
            uri=urljoin("https://api.ailoot.ai",uri)
            parsed=urlsplit(uri)
            if parsed.scheme!="https" or not parsed.netloc or parsed.username or parsed.password:
                raise SystemExit("Invalid returned image URL")
            owned=parsed.netloc=="api.ailoot.ai" and parsed.path.startswith("/v1/media/assets/") and parsed.path.endswith("/content")
            args=["curl","--fail-with-body","--silent","--show-error",uri]
            if owned: args += ["-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"]]
            temporary=Path(f"image-{index}.bin")
            subprocess.run(args+["-o",str(temporary)],check=True)
            raw=temporary.read_bytes()
            temporary.unlink()
        else: raise SystemExit("Image has neither bytes nor URL")
        if not raw: raise SystemExit("Empty image result")
        ext="png" if raw.startswith(b"\x89PNG") else "jpg" if raw.startswith(b"\xff\xd8") else "webp" if raw[:4]==b"RIFF" and raw[8:12]==b"WEBP" else "svg" if raw.lstrip().startswith((b"<svg",b"<?xml")) else "bin"
        Path(f"image-{index}.{ext}").write_bytes(raw)
    print("Every returned image saved; complete response metadata retained")
save_images(json.loads(Path("result.json").read_text())["data"])
PY_RESULT

استلام النتائج وحفظها

Ailoot Ultra · الصور

نزّل كل صورة مُرجعة أو احفظ محتواها بصيغة Base64

GET /v1/media/tasks/{task_id}
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}

عمليات أخرى لقراءة المحتوى

قراءة الأصول الموجودة المملوكة لك

set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/media/assets \
  -H "Authorization: Bearer $AILOOT_API_KEY" -o owned-assets.json
# Preserve every returned asset and follow its exact signed content URL. Do not construct a signed token.

الاحتفاظ بكل النتائج المكتملة

احفظ كل صورة مكتملة؛ نزّلها من كل URL مُرجع، أو فك ترميز محتواها بصيغة Base64.

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

عند الحاجة إلى التحقق من الاستجابة الأصلية

احتفظ بقيمة X-Client-Request-ID المُعادة للمطابقة. اقرأ فقط قيم task_id/asset_id الفعلية المُعادة أو مكتبة الوسائط المملوكة لك؛ ولا تنشئ عنوان URL لمهمة من معرّف العملية، ولا تُعِد إرسال طلب الإنشاء مطلقًا.

حقول الاستجابة

الحقل	النوع
الحقل`created`	النوع
الحقل`data[].url`	النوع
الحقل`data[].b64_json`	النوع
الحقل`usage`	النوع

الأسماء البديلة

الأسماء البديلة للنموذج

Ailoot Ultra qwen/qwen-image-3-pro

الأسماء البديلة لمسارات الطرائق

/v1/images

معرّفات النماذج ذات الصلة IDs

qwen/qwen-image-3-pro

FAQ · Qwen: Qwen Image 3 Pro

ما المدخلات والنتائج المتاحة؟: POST /v1/images/generations · qwen/qwen-image-3-pro: text, image → image
ما الحقول التي يستخدمها الطلب؟: POST /v1/images/generations · qwen/qwen-image-3-pro: model, prompt, resolution, aspect_ratio, n, input_references, provider
ما الحدود المطبقة؟: POST /v1/images/generations · qwen/qwen-image-3-pro: n.minimum: 1; n.maximum: 6

Qwen: Qwen Image 3 Pro