المنزل المدونة

كيفية استخدام واجهة برمجة تطبيقات Qwen Image 2.1

غلاف مدونة واجهة برمجة تطبيقات Qwen Image 2.1

Oct 18, 2026

EmpirioLabs AI

كوين إيميج 2.1 متوفر على EmpirioLabs. إنه نموذج توليد وتحرير الصور من علي بابا، ويعمل كمعرف واحد للنموذج مع نسختين: Pro لأعلى جودة صورة وتعديلات معقدة، وTurbo لتوليد أسرع وأقل تكلفة. كلاهما يعمل عبر النموذج ما بعد /v1/images/generations، في واجهة برمجة التطبيقات وفي Playground.

شاهد فيلم الإطلاق

كل صورة في الفيلم هي مخرج حقيقي من كوين إيميج 2.1. تم إنتاج الموسيقى التصويرية بواسطة ACE-Step على EmpirioLabs. شاهدها على يوتيوب.

برو أم توربو؟

النسخةأفضل ملاءمةالتصنيف
qwen-image-2.1-proالأصول النهائية، التصاميم النصية الثقيلة، والتعديلات المعقدة متعددة الصورمعدل واحد لكل صورة مخرجة وعلى كل حجم
qwen-image-2.1-turboالمسودات، التوليد عالي الحجم، والتعديلات الروتينيةمعدل أقل لكل صورة مخرجة عند كل حجم

Pro هو الافتراضي. كلا النسختين تأخذان حتى عشر صور مرجعية ويعيدان حتى ست صور لكل طلب. اختر نسخة مع model_variant; معرفات النماذج qwen-image-2.1-pro و qwen-image-2.1-turbo اختر أيضا واحدا مباشرة.

توليد صورة

المجموعة التزامن: صحيح لاستلام الصورة النهائية في الرد. بدونها، يعيد الطلب مهمة للاستطلاع عند اذهب /v1/jobs/{id}.

curl -X POST https://api.empiriolabs.ai/v1/images/generations \ -H "التفويض: حامل $EMPIRIOLABS_API_KEY" \ -H "المحتوى-TYPE: application/json" \ -D '{ "MODEL": "qwen-image-2-1", "model_variant": "qwen-image-2.1-turbo", "الطلب": "سوق ليلي تحت المطر، فوانيس ورقية منعكسة في البرك، لافتة مرسومة يدويا مكتوب عليها OPEN LATE", "RESOLUTION": "1K", "aspect_ratio": "16:9", "num_images": 2, "تزامن": صحيح }'

تعديل باستخدام صور مرجعية

أرفق صورة واحدة إلى عشر صور في الصور، ويصبح الموضوع هو تعليمات التحرير:

curl -X POST https://api.empiriolabs.ai/v1/images/generations \ -H "التفويض: حامل $EMPIRIOLABS_API_KEY" \ -H "المحتوى-TYPE: application/json" \ -D '{ "MODEL": "qwen-image-2-1", "IMAGES": [ "https://example.com/product.png", "https://example.com/kitchen.png" ], "الطلب": "ضع الزجاجة من الصورة الأولى على طاولة الرخام من الصورة الثانية، في ضوء الصباح الناعم.", "الحجم": "2048*1536", "negative_prompt": "ملصق مشوه، زجاجة مكررة", "بذرة": 4242, "تزامن": صحيح }'

الصور الشفافة

مخرج PNG شفاف. المخرجات هي ملفات PNG. للحصول على خلفية شفافة، قم بتعيين prompt_extend إلى خطأ ووصف الصورة بهذا الشكل:

{ "model": "qwen-image-2-1", "prompt": "هذه صورة RGBA مع شفافية. كوب قهوة خزفي مع طلاء أزرق. الصورة تحتوي على قناة ألفا والخلفية شفافة.", "prompt_extend": خاطئ، "الدقة": "1K", "aspect_ratio": "1:1", "تزامن": صحيح }

الأحجام

  • الإعدادات المسبقة. المجموعة الحل إلى 1K, 2K، أو أوتو، و aspect_ratio إلى أوتو, 1:1, 16:9, 9:16, 3:2, 2:3, 4:3, 3:4, 5:4، أو 4:5. الإعدادات الافتراضية، 2K والتلقائية، تعطي صورة بدقة 2048x2048.
  • الأحجام الدقيقة. أرسلني الحجم ك العرض*الارتفاع، أو مجموعة use_custom_size مع custom_width و custom_height. يجب أن تبقى المساحة الإجمالية بين 512x512 و2560x2560 بكسل، مع نسبة عرض إلى ارتفاع تتراوح بين 1:8 إلى 8:1.
  • رايات طويلة. الحد الأقصى هو على المساحة، لذا يمكن أن يتجاوز أحد الجانبين 2560 بكسل: 4096*512 هو حجم صالح.

ملاحظات تشغيلية

  • تمديد موجه الوكيل مخصص text-to-image فقط. طلب يرفق الصور مع prompt_extend_mode تم ضبطه على وكيل يفشل. استخدم مباشر، هو الافتراضي عند التحرير.
  • الدقة التلقائية مع نسبة العرض إلى الارتفاع الثابتة تستخدم إعداد 1K المسبق. الدقة: "تلقائي" مع aspect_ratio: "16:9" إرجاعات بحجم 1920x1080. المجموعة الحل إلى 2K بالنسبة للحجم الأكبر.

التسعير

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

القوالب والتركيب

كوين إيميج 2.1 متوفر أيضا في قوالب الجيل وكنموذج صورة في Compose.

ابدأ البناء

جرب Qwen Image 2.1 في الملعب، واقرأ توثيق واجهة برمجة التطبيقات لكل معلمة وحقل استجابة.

إفصاح: كتب هذا المقال بمساعدة الذكاء الاصطناعي وتمت مراجعته من قبل EmpirioLabs AI.

هل أنت مستعد لاستخدام نقاط نهاية أفضل؟

استكشف نماذجنا، أو تواصل معنا بشأن استفسارات الأعمال، أو النشر المخصص، أو أي شيء آخر.