كيفية استخدام واجهة برمجة تطبيقات Seedream 5.5

Seedream 5.5 متوفر على EmpirioLabs. إنه أحدث نموذج صور Seedream من ByteDance، صدر في 9 نوفمبر 2026 لجيل text-to-image، وتعديلات تجمع بين ما يصل إلى 10 صور مرجعية، وصور ذات شفافية حقيقية مصنوعة من طلب أو من مراجع، وتحليل الطبقات، الذي يقسم صورة واحدة إلى صورة أساسية بالإضافة إلى ما يصل إلى 99 طبقة شفافة ويمكنه قراءة النص فيها. يعمل في واجهة برمجة التطبيقات وفي Playground.

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

كل صورة في الفيلم أنتجت بواسطة Seedream 5.5 عبر واجهة برمجة التطبيقات EmpirioLabs على 2K، بما في ذلك غواص حر بجانب حوت أحدب، راقص فلامنكو أثناء الدوران، منفاخ زجاج في العمل، وملصق جاز مكتوب بحروف. تم إنتاج الموسيقى بواسطة ACE-Step على EmpirioLabs. شاهدها على يوتيوب.

كيف يقارن

ما الذي يدعمه

• تحويل النص إلى صورة. أرسل طلبا بدون صورة.
• التحرير والاندماج. أرفق صورة إلى عشر صور وصف التغيير، أو كيفية دمجها.
• تعديلات العلامة والإحداثيات. حدد المنطقة التي يجب تغييرها في الصورة المدخلة بدائرة أو سهم أو رسمة، أو أعط موقعها الدقيق ك <bbox> ضع العلامة في الطلب.
• صور شفافة. المجموعة الخلفية إلى شفاف للحصول على PNG مع قناة ألفا، سواء من خلال طلب فقط أو من الصور المرجعية.
• تحلل الطبقات. قسم صورة واحدة إلى صورة أساسية بالإضافة إلى ما يصل إلى 99 طبقة PNG شفافة، كل منها يعود بموقعه في الصورة الأساسية واسم ووصف.
• التعرف على النص. أثناء التفكيك، احصل على نص كل طبقة نصية مطبوعة مع مواقع أسطرها وتصميمها.
• نص في الصورة. اللافتات، الملصقات، الملصقات والطباعة الصغيرة تعرض بالصينية والإنجليزية و14 لغة أخرى، بما في ذلك اليابانية والكورية والعربية والإسبانية والفرنسية.

الإخراج هو PNG افتراضيا، أو JPEG، عند مستويات دقة 1K أو 1.5K أو 2K، أو عند عرض وارتفاع مخصصين.

توليد صورة

curl https://api.empiriolabs.ai/v1/images/generations \ -H "التفويض: حامل $EMPIRIOLABS_API_KEY" \ -H "نوع المحتوى: application/json" \ -d '{ "model": "seedream-5-5", "prompt": "كوب قهوة خزفي بجانب لافتة صغيرة على السبورة مكتوب عليها Oat Flat White 4.50، ضوء نافذة الصباح"، "aspect_ratio": "4:3", "الجودة": "2K" }'

ينتظر الطلب الصورة النهائية ثم يعيدها البيانات. إضافة "التزامن": خطأ لاستعادة وظيفة فورا، مع job_id للتصويت في اذهب /v1/jobs/<job_id> حتى الحالة هي اكتمل.

نفس النداء من حزمة تطوير تطوير OpenAI Python موجهة إلى EmpirioLabs. التحكم الذي لا يحدده SDK يدخل extra_body:

من openai import OpenAI client = OpenAI(base_url="https://api.empiriolabs.ai/v1", api_key="YOUR_EMPIRIOLABS_API_KEY",) result = client.images.generate(model="seedream-5-5", prompt="تيراريوم زجاجي مع منظر طحلب صغير وملصق نحاسي مكتوب عليه Fern Garden", extra_body={"aspect_ratio": "4:3", "quality": "2K"},) print(result.data[0].url)

اصنع صورة شفافة

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

{ "model": "seedream-5-5", "prompt": "فانوس ورقي أحمر لامع مع شرابات ذهبية، مقطوعة منتج معزولة", "خلفية": "شفافة", "جودة": "1K" }

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

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

مرر حتى 10 روابط صور، أو بيانات URI أو صور مرفوعة صورة، ويشير إليها في الموضوع بترتيبها:

{ "model": "seedream-5-5", "prompt": "علق الفانوس الورقي الأحمر من الصورة 1 من الغصن في الصورة 2، مع الحفاظ على كل شيء آخر في الصورة 2 دون تغيير", "image": [ "https://example.com/lantern.png", "https://example.com/branch-poster.png" ] }

تعديل منطقة محددة

لتغيير جزء من الصورة، قم بتحديد الوضع على الإدخال بدائرة أو سهم أو رسم تخطيطي ووصف التغيير، أو أعط المنطقة ك <bbox> العلامة. الصندوق هو اليسار العلوي الأيمن السفلي على شبكة من 0 إلى 1000 فوق الصورة، بغض النظر عن حجم البكسل:

{ "model": "seedream-5-5", "prompt": "أضف مزهرية زجاجية صغيرة بها زهرة توليب بيضاء واحدة داخل <bbox>60 80 300 520</bbox>. احتفظ بكل شيء آخر دون تغيير.", "صورة": "https://example.com/kitchen.png" }

تقسيم الصورة إلى طبقات

المجموعة layer_decomposition إلى صحيح وأرفق صورة واحدة بالضبط. التوجيه اختياري: اتركه للسماح للنموذج باختيار العناصر، أو تسمية العناصر أو المناطق التي سيتم فصلها. max_images يضبط أكبر عدد من الصور للعودة، الصورة الأساسية المرفقة، من 2 إلى 100، و text_recognition يضيف نص كل طبقة نصية مطبوعة:

curl https://api.empiriolabs.ai/v1/images/generations \ -H "التفويض: حامل $EMPIRIOLABS_API_KEY" \ -H "نوع المحتوى: application/json" \ -d '{ "model": "seedream-5-5", "layer_decomposition": صحيح, "image": "https://example.com/magazine-cover.png", "max_images": 10, "text_recognition": صحيح }'

البيانات[0] هي الصورة الأساسية، مع z_index من 0. كل إدخال بعده هو طبقة PNG شفافة بترتيب تكديسها، ومربعها في الصورة الأساسية بالبكسل (bounding_box. مطلق) وعلى شبكة من 0 إلى 1000 (bounding_box. تم تطبيعه), كلاهما ك [يسار، فوق، يمين، أسفل]، واسم ووصف. طبقة نص مطبوعة تحمل أيضا text_recognition:

{ "url": "https://media.empiriolabs.ai/...", "z_index": 1، "عرض": 1723، "ارتفاع": 609، "bounding_box": { "مطلق": [75, 0, 995, 325], "مطبع": [69, 0, 921, 301] }, "name": "نص عنوان أصفر كبير Seedream", "وصف": "نص عنوان أصفر كبير يقرأ \"Seedream\" موضوع في أعلى التركيب.", "text_recognition": { "نص": "Seedream", "خطوط": [ { "bounding_box": { "مطلق": [196، 53, 874، 231]، "مطبع": [181، 49، 809، 214] }، "يجري": [ { "نص": "Seedream", "style": { "similar_font_family": "HTF Didot", "foreground_color": "#F5E25A", "bold": خاطئ، "مائل": خاطئ، "خط تحت": خاطئ، "شطب": خاطئ، "ظل": خاطئ، "شفاف": خاطئ } } ] } }, "خلفية": "شفاف" }

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

أشياء يجب معرفتها قبل طلبك الأول

• صورة واحدة لكل طلب. يعيد الطلب صورة واحدة، و n أعلاه 1 يعيد خطأ. أرسل طلبات منفصلة للتنويعات. تحليل الطبقة هو الاستثناء: يعيد الصورة الأساسية وطبقاتها معا.
• المجموعة max_images للتحليل الذي تحتاجه. بدونه، قد يعطي التحليل ما يصل إلى 30 صورة، وكل صورة تعيد فواتير الصورة. القيمة الأكبر تسمح بتقسيم أدق.
• قم بتكبير كل طبقة حسب صندوقها. الطبقة PNG ليست دائما بحجم بصمتها في الصورة الأساسية: في المثال أعلاه، طبقة 1723x609 تملأ صندوقا بحجم 920x325. قم بتكبير كل طبقة إلى عرض وارتفاع bounding_box. مطلق قبل وضعها في الزاوية العلوية اليسرى من الصندوق.
• التعرف على النص يقرأ النصوص المطبوعة. الكتابة الفنية والكتابة تعود كطبقات بدون text_recognition.
• التحليل لا يأخذ الخلفية. طبقاته دائما شفافة في PNG، والبيئة الخلفية إلى شفاف أو معتم مع layer_decomposition يعيد خطأ.
• النتيجة الشفافة تحتاج إلى PNG. الخلفية: "شفاف" مع output_format: "jpeg" يعيد خطأ.

التسعير

حسب الصورة. Seedream 5.5 هو نظام الدفع حسب الاستخدام ويتم الفوترة لكل صورة مرتجعة بحجمه: 1K و1.5K صورة تشترك في سعر واحد، و2K صورة تحسب بسعر أعلى. كل صورة مرجعية تضيف رسوما. يقوم تحليل الطبقة بفوترة كل صورة تعيدها، الصورة الأساسية وكل طبقة، بحجمها الخاص. يمكنك الدفع أثناء الدفع، أو اختيار خطة مع بدلات أسبوعية. الأسعار الحالية موجودة على صفحة النماذج و صفحة الأسعار.

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

ابدأ البناء

جرب Seedream 5.5 في Playground، اقرأ المرجع الكامل للمعلمة في وثائق واجهة برمجة التطبيقات، أو مقارنتها مع نماذج الصور الأخرى في كتالوج النماذج. للنماذج المبكرة للعائلة، انظر كيفية استخدام واجهة برمجة تطبيقات Seedream 5.0 Pro و كيفية استخدام واجهة برمجة تطبيقات الفلاش Seedream 5.0.