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

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

غلاف مدونة Seedream 5.0 Flash API

Sep 29, 2026

EmpirioLabs AI

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

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

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

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

ما الذي يدعمه

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

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

توليد صورة

curl https://api.empiriolabs.ai/v1/images/generations \ -H "التفويض: حامل $EMPIRIOLABS_API_KEY" \ -H "المحتوى-TYPE: application/json" \ -D '{ "MODEL": "seedream-5-0-flash", "الطلب": "مهرجان الفانوس الورقي فوق نهر عند الغروب، تأملات على الماء", "aspect_ratio": "16:9", "الجودة": "2K", "تزامن": true }'

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

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

من openai استيراد OpenAI client = OpenAI(base_url="https://api.empiriolabs.ai/v1", api_key="YOUR_EMPIRIOLABS_API_KEY",) result = client.images.generate(model="seedream-5-0-flash", prompt="مهرجان فوانيس ورقية فوق نهر عند الغروب، انعكاسات على الماء", extra_body={"sync": صحيح، "aspect_ratio": "16:9", "الجودة": "2K"},) print(result.data[0].url)

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

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

{ "model": "seedream-5-0-flash", "prompt": "ضع الكوب من الصورة 1 على الطاولة من الصورة 2، مع الحفاظ على إضاءة الصورة 2", "image": [ "https://example.com/cup.png", "https://example.com/table.jpg" ], "sync": true }

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

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

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

تعمل العلامات أيضا عبر الصور، على سبيل المثال لوضع الموضوع من منطقة من الصورة 1 في منطقة من الصورة 2.

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

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

curl https://api.empiriolabs.ai/v1/images/generations \ -H "التفويض: حامل $EMPIRIOLABS_API_KEY" \ -H "المحتوى-TYPE: application/json" \ -D '{ "MODEL": "seedream-5-0-flash", "layer_decomposition": TRUE, "IMAGE": "https://example.com/perfume-ad.png", "التوجيه": "افصل زجاجة العطر وملصقها وشعاع الضوء", "التزامن": صحيح }'

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

{ "url": "https://media.empiriolabs.ai/...", "z_index": 4، "العرض": 476، "الارتفاع": 1024، "bounding_box": { "المطلق": [1181، 268، 1657، 1292]، "مطبع": [419، 169، 588، 815] }، "الاسم": "الجسم الرئيسي لزجاجة العطر"، "الوصف": "زجاجة عطر مربعة شفافة ذات غطاء ذهبي مكشوف..." }

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

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

  • صورة واحدة لكل طلب. يعيد الطلب صورة واحدة، و n أعلاه 1 يعيد خطأ. أرسل طلبات منفصلة للتنويعات. تحليل الطبقة هو الاستثناء: يعيد الصورة الأساسية وطبقاتها معا.
  • قم بتكبير كل طبقة حسب صندوقها. طبقة PNG ليست دائما بحجم بصمتها في الصورة الأساسية، ويمكن أن تعود طبقة النص إلى حجم أكبر بعدة مرات. قم بتصغير كل طبقة إلى عرض وارتفاع bounding_box. مطلق قبل وضعها في الزاوية العلوية اليسرى من الصندوق.
  • التعليمات تحدد عدد الطبقات التي تعود. بدون توجيه، يفصل النموذج كل عنصر يجده، وكل عنصر يعيد فواتير الصورة. سم العناصر التي تحتاجها، أو اذكر مناطقها ك <bbox> العلامات، للحفاظ على النتيجة لها.
  • أعد محاولة تحليل الطبقة الذي لم يكن بالإمكان معالجته. أحيانا يفشل تحليل الطبقة مع خطأ يقول إن محتوى الصورة لم يكن بالإمكان معالجته. أرسل نفس الطلب مرة أخرى.
  • لا يوجد تحسين سريع للتوجيه. prompt_optimization_mode: "سريع" من Seedream 5.0 Pro يرجع خطأ على Flash. اترك التحكم.
  • النتيجة الشفافة تحتاج إلى إدخال شفاف. الخلفية: "شفاف" يعمل على تعديل صورة واحدة بالضبط تحتوي بالفعل على قناة ألفا، مثل طبقة من التفكيك، مع output_format تم ضبطه على بابوا غينيا الجديدة. إخراج JPEG يعيد خطأ.

التسعير

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

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

ابدأ البناء

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

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

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