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

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

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

Aug 8, 2026

EmpirioLabs AI

الإجابة المختصرة: صورة كوين 3.0 هو نموذج صورة واحد مع نسخ Base وPro للتوليد والتحرير. الاستخدام model_variant لاختيار نسخة Base الأقل تكلفة أو نسخة Pro ذات الجودة الأعلى. كلاهما يمر بكل ما يمكن تشغيله ما بعد /v1/images/generations.

أساسي أم محترف؟

النسخةأفضل ملاءمةفوترة الإنتاج
qwen-image-3.0تكرار سريع، رسومات إنتاجية، نصوص متعددة اللغات، وتعديلات روتينيةمعدل إخراج واحد عبر 1K و2K
qwen-image-3.0-proتركيبات كثيفة، طباعة دقيقة، واقعية فوتوغرافية، وتعديلات معقدةمستويات إخراج منفصلة من 1K و2K

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

توليد باستخدام القاعدة

المجموعة التزامن: صحيح عندما تريد من الطلب انتظار استجابة الصورة المكتملة على شكل OpenAI. بدونه، يبقى توليد الصور غير متزامن ويعيد مهمة إلى الاستطلاع.

curl -X POST https://api.empiriolabs.ai/v1/images/generations \ -H "التفويض: حامل $EMPIRIOLABS_API_KEY" \ -h "نوع المحتوى: application/json" \ -d '{ "model": "qwen-image-3-0", "model_variant": "qwen-image-3.0", "الطلب": "حملة مميزة للماء الفوار على مجموعة كوبالت. الملصق مكتوب على EMPIRIO LABS بخط أبيض ناصع. تكثف، ضوء حافة صلبة، تصوير منتج تحريري.", "الدقة": "1K", "aspect_ratio": "4:5", "prompt_extend": صحيح، "prompt_extend_mode": "مباشر"، "num_images": 1، "تزامن": صحيح }'

تعديل باستخدام Pro

ضع الصور قبل التعليمات. نفس نقطة النهاية تنتقل تلقائيا إلى وضع التحرير.

curl -X POST https://api.empiriolabs.ai/v1/images/generations \ -H "التفويض: حامل $EMPIRIOLABS_API_KEY" \ -H "المحتوى-TYPE: application/json" \ -D '{ "MODEL": "qwen-image-3-0", "model_variant": "qwen-image-3.0-pro", "IMAGES": [ "https://example.com/product.png", "https://example.com/style-reference.png" ], "التوجيه": "احتفظ بهوية المنتج من الصورة الأولى، استخدم الإضاءة ولغة الألوان من الثانية، وأضف العنوان BUILT FOR TOMORROW.", "size": "2048*1536", "negative_prompt": "نص تهجئتي خاطئ، شعار مشوه، منتج مكرر"، "seed": 271828، "تزامن": صحيح }'

مستويات الدقة والفوترة

  • الإعدادات المسبقة: اختر الحل ك 1K, 2K، أو أوتو، ثم اختر aspect_ratio.
  • الأبعاد الدقيقة: الاستخدام الحجم: "العرض*الارتفاع"، أو أشعل use_custom_size ويوفر custom_width زائد custom_height.
  • عتبة الاحترافية: المخرجات حتى 2.25 ميجابكسل تستخدم معدل 1K. أي شيء أكبر يستخدم معدل 2K.
  • التسعير الأساسي: القاعدة لها سعر إخراج واحد عبر كلا المستويين من البكسل.

أوضاع التوسيع الموجه

مباشر هو الافتراضي ويعمل لكل من التوليد والتحرير. وكيل يقوم بتحسين أعمق للأوامر ل text-to-image، لكنه لا يستخدم عند إرفاق صور مرجعية. Set prompt_extend: خاطئ عندما يجب أن تمر تعليمات الصياغة والتكوين الدقيقة دون تغيير.

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

  • التعديلات التي تعتمد فقط على الصور تعمل. إذا أرفقت صورة بدون توجيه، EmpirioLabs يوفر تعليمة محايدة تحافظ على المواضيع الرئيسية.
  • الأحجام المخصصة لها حدود مساحت. يجب أن تبقى مساحة الإخراج بين 512x512 و2048x2048 بكسل، حيث يمكن أن يكون كل جانب على الأكثر 2048 بكسل، ويجب أن تبقى نسبة العرض إلى الارتفاع بين 1:8 و8:1.
  • تنسيقات المراجع واسعة. تقبل صور JPG، JPEG، PNG، BMP، TIFF، WEBP، وGIF حتى 10 ميجابايت لكل صورة.
  • التعديلات المعقدة 2K تستغرق وقتا أطول. ابن فترة استراحة سخية للعملاء لتحرير Pro المكثف، خاصة مع وجود مراجع متعددة.

جرب Qwen Image 3.0

مفتوح صورة كوين 3.0 في Playground. لكل معامل، ومستوى تسعير، وحقل استجابة، استخدم مرجع واجهة برمجة التطبيقات Qwen Image 3.0.

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

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