Qwen: Qwen Image 3
يجمع Qwen-Image-3.0 بين توليد الصور وتحريرها للتصاميم الغنية بالمعلومات والمشاهد المفصّلة والكتابة بلغات متعددة. يوازن الإصدار القياسي بين الجودة والسرعة، ويقبل وصفًا نصيًا أو ما يصل إلى ثلاث صور مع تعليمة تحرير.
عن النموذج
يغطي هذا الوصف قدرات النموذج. وترد أدناه المدخلات والمخرجات والخيارات المتاحة في Ailoot للطريقة المحددة.
Qwen-Image-3.0 هو الجيل الثالث من نماذج الصور لدى Qwen، ويجمع إنشاء الصور من النص والتحرير المستند إلى مراجع في نموذج واحد. يوازن الإصدار القياسي بين جودة الصورة وسرعة الاستجابة، بينما يُعد Qwen-Image-3.0 Pro الإصدار الرائد الموجّه إلى الجودة. ينتج الطلب صورة: ملصقًا أو شرحًا مصوّرًا أو مشهد منتج أو لوحة قصصية أو صورة فوتوغرافية معدّلة، وليس مستندًا قابلًا للتحرير أو واجهة تعمل فعليًا.
تلائم إمكاناته في المحتوى الغني مساحة تصميم تضم عدة أقسام مترابطة أو تخطيطًا بصريًا متداخلًا. جهّز العناوين والصياغة الدقيقة والتسلسل الهرمي والعلاقة بين اللوحات قبل إضافة التفاصيل الأسلوبية. ولمقارنة منتجات، يحدّد التوجيه المفيد المنظر الرئيسي للمنتج، والسمات المطلوب تسميتها، وترتيب قراءة اللوحات الداعمة. وللوحة قصصية، صِف موضوع كل لوحة وحركتها وتعليقها النصي بصورة منفصلة. الحد الأقصى الموصى به للطلب النصي هو 4,500 رمز؛ خصّص هذه المساحة للمحتوى والتخطيط اللذين تحتاجهما الصورة فعلًا.
يدعم النموذج خامات مفصّلة، وكتابة يصل صغرها إلى نص جرى عرضه بحجم 10 بكسلات، ورسمًا أصليًا للنصوص عبر 12 لغة مع خطوط وأساليب فنية متعددة. ويمكن لهذه الإمكانات الجمع بين جسم واقعي ورسم غني بالمعلومات، بدلًا من فرض الاختيار بين صورة فوتوغرافية وتصميم كثيف النصوص. قدّم الكلمات والأرقام الدقيقة المطلوب رسمها، ولغتها المقصودة، ومواضعها. تعامل مع الواجهة المولّدة بوصفها نموذجًا بصريًا: الأزرار والمخططات والتسميات داخل الصورة لا تنفّذ سلوك تطبيق.
يمكن للتحرير تغيير النص، وإضافة الأشياء أو إزالتها، ونقل العناصر، وتعديل حركة الموضوع، ونقل أسلوب، أو تحسين تفاصيل صورة متضررة. قدّم من صورة واحدة إلى ثلاث صور وتعليمة تحرير واحدة واضحة. يتبع ترقيم الصور ترتيب تقديمها، لذا حدّد أي صورة توفّر الموضوع، وأيها توفّر قطعة الملابس أو الجسم، وأيها توفّر البيئة. ولمشهد منتج، اطلب وضع الجسم من الصورة 1 في بيئة الصورة 2، مع الحفاظ على السمات التي تميّز المنتج. اجعل التغييرات ومتطلبات الحفاظ على التفاصيل صريحة.
يقبل سير إدخال الصور المحدد JPG وJPEG وPNG وBMP وTIFF وWebP وGIF؛ ويُعالج الإطار الأول فقط من GIF المتحرك. يمكن أن يصل حجم كل صورة إلى 10 MB. تقبل واجهة API الحالية أبعادًا من 1 إلى 8,000 بكسل، مع نسبة بين الضلع الأطول والأقصر لا تتجاوز 10:1، وتوصي بأبعاد 384–2,048 بكسل للحصول على نتائج جيدة. اختر صورة إدخال تُظهر بوضوح التفاصيل المطلوب نقلها أو تحريرها. فقد يخفي المرجع المقتصّ بإحكام البنية المحيطة اللازمة لوضع جسم بصورة طبيعية.
تكون المخرجات بصيغة PNG، بعدد من صورة واحدة إلى ست صور لكل طلب، وصورة واحدة افتراضيًا. تتراوح مساحة البكسلات في المخرج من 512 × 512 إلى 2,048 × 2,048، مع نسب أبعاد بين 1:8 و8:1؛ وهذه حدود للمساحة، وليست قاعدة تفرض ألا يزيد كل ضلع على 2,048 بكسل. إذا لم يُحدّد حجم، يقترح النموذج دقة استنادًا إلى الطلب النصي. اختر تكوينًا أفقيًا أو مربعًا أو رأسيًا للاستخدام المقصود، ثم افحص الصورة المعادة بذلك الحجم الفعلي، حتى يمكن تقييم التسميات الصغيرة والتفاصيل الدقيقة في مواضع ظهورها.
تُفعّل إعادة صياغة الطلب افتراضيًا في سير عمل الجهة المنتجة. يعمل التحسين المباشر مع التوليد والتحرير كليهما؛ أما التحسين بالوكيل فهو وضع إعادة صياغة أكثر تفصيلًا مخصّص لتحويل النص إلى صورة فقط، ويُرفض في تحرير صورة انطلاقًا من صورة. ويُفعّل التفكير افتراضيًا، ويتطلب إعادة صياغة الطلب، ويزيد زمن التوليد. يمكن للطلبات السلبية وصف العناصر غير المرغوبة، بينما تساعد بذرة عشوائية ثابتة على مقارنة التنويعات. اذكر الاستبعادات ومتطلبات الحفاظ الدقيق بوضوح، بدلًا من توقّع أن تجعل البذرة طلبًا يتغير يعيد صورة مطابقة.
للحصول على ناتج نهائي مفيد، افحص الكلمات المرسومة والوحدات وترتيب اللوحات والتفاصيل التي تحدّد هوية الموضوع، ثم عدّل الجزء المحدد الذي لم يلبِّ التوجيه. توفّر الاستجابة متعددة الصور بدائل للمقارنة؛ فاحتفظ بارتباط كل صورة معادة بالطلب والمراجع التي أنتجتها. تنتهي صلاحية عناوين الصور لدى الجهة المنتجة بعد 24 ساعة، لذا احتفظ بملف الصورة الفعلي عندما تصبح النتيجة جزءًا من مشروع. يظل الإصدار القياسي 3.0 منفصلًا عن Pro وعن نماذج Qwen 2.1 ذات أعداد المراجع وميزات الشفافية المختلفة.
Ailoot Ultra · الصور POST /v1/images/generations qwen/qwen-image-3
qwen/qwen-image-3البداية
يجمع Qwen-Image-3.0 بين توليد الصور وتحريرها للتصاميم الغنية بالمعلومات والمشاهد المفصّلة والكتابة بلغات متعددة. يوازن الإصدار القياسي بين الجودة والسرعة، ويقبل وصفًا نصيًا أو ما يصل إلى ثلاث صور مع تعليمة تحرير.
- المدخلات المقبولة
- النص · الصور
- النتائج
- الصور
متاح في Ailoot · المدخلات والطرائق
Ailoot Ultra · الصور POST /v1/images/generations
- الإدخال
text,image- الإخراج
image
| الحقل | النوع | المتطلب | القيم والحدود | القيمة الافتراضية |
|---|---|---|---|---|
الحقلmodel | النوعstring | المتطلبمطلوب | القيم والحدود qwen/qwen-image-3 | القيمة الافتراضية— |
الحقل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.06 تقدير قبل الإنشاء هذا التقدير ليس رسومًا إضافية ولا تعرفة ثابتة لعملية التوليد المكتملة. |
تحجز Ailoot مبلغًا تقديريًا قبل الطلب. وبعد ظهور النتيجة، تُسوّي الرسوم النهائية بناءً على الاستخدام المقاس. وتستخدم تسوية البث سجل الاستخدام النهائي. كيفية عمل حجز المبلغ وتسوية الرسوم →
أمثلة للطلبات
Ailoot Ultra · الصور
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', '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}/contentGET /v1/media/assetsGET /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
الأسماء البديلة لمسارات الطرائق
/v1/images
معرّفات النماذج ذات الصلة IDs
FAQ · Qwen: Qwen Image 3
- ما المدخلات والنتائج المتاحة؟
POST /v1/images/generations·qwen/qwen-image-3:text,image→image- ما الحقول التي يستخدمها الطلب؟
POST /v1/images/generations·qwen/qwen-image-3:model,prompt,resolution,aspect_ratio,n,input_references,provider- ما الحدود المطبقة؟
POST /v1/images/generations·qwen/qwen-image-3:n.minimum:1;n.maximum:6