Seedream 5.0 Pro

⁦Seedream 5.0 Pro⁩ هو نموذج الصور من ⁦ByteDance⁩. ينشئ الطلب الواحد صورة واحدة من موجّه، أو من موجّه مع ما يصل إلى ⁦10⁩ صور مرجعية، أو يقسّم صورة واحدة إلى صورة القاعدة وما يصل إلى ⁦16⁩ طبقة شفافة. أرسل الطلب، واحتفظ بمعرّف المهمة المُعاد، واقرأ الصور المكتملة من المهمة. تُرسل الصور المرجعية كروابط ⁦URL⁩.

معرّفات النماذج

راجع صفحة النموذج للاطلاع على الأسعار الحالية.

مثال سريع

curl https://api.seedrouter.ai/v1/images/generations \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedream-5-0-pro",
    "prompt": "A red ceramic mug on a white table, soft studio light, product photography. No text, no logos.",
    "size": "1K",
    "watermark": false
  }'

نقطة النهاية

POST https://api.seedrouter.ai/v1/images/generations

الاستجابة مهمة ({"id": "task_...", "status": "processing"}) لا الصورة المكتملة. استعلم GET /v1/tasks/{task_id} للحصول على النتيجة. واحتفظ بمفاتيح ⁦API⁩ في شفرة تعمل على الخادم. تُرسل الصور المرجعية وطلبات تقسيم الصورة إلى طبقات في الطلب نفسه عبر image؛ ولا يُستخدم /v1/images/edits لهذا النموذج ويعيد ⁦400⁩.

المعاملات

تُحذف الحقول غير المدرجة في هذه القائمة قبل تمرير الطلب؛ ولا تسبّب خطأ مطلقًا ولا تغيّر المخرجات. لا تتاح n أو stream أو seed أو response_format أو التوليد المتتابع. وcallback_url غير متاح؛ استعلم عن المهمة بدلًا منه.

مقاس المخرجات

يحدّد المستوى المقاس التقريبي ويحدّد الموجّه الشكل. اذكر نسبة العرض إلى الارتفاع في prompt (مثل "مشهد أفقي بنسبة ⁦16:9⁩") ليختار النموذج الإطار:

لإطار ثابت، أرسل أبعادًا دقيقة بالبكسل بدلًا من مستوى. يكلّف 1K و1.5K المبلغ نفسه؛ ويكلّف 2K وأي مقاس فوق ⁦2.61⁩ مليون بكسل أكثر (راجع عوامل التكلفة).

الصور المرجعية

مرّر صورة واحدة لتحريرها، أو 2–⁦10⁩ صور لدمجها، وحدّد في prompt ما يجب الحفاظ عليه وما يجب تغييره. أشِر إليها بحسب ترتيبها ("السترة من الصورة 1").

{
  "model": "seedream-5-0-pro",
  "prompt": "Put the jacket from image 1 on the model from image 2, standing on a rainy street at night.",
  "image": ["https://example.com/jacket.png", "https://example.com/model.jpg"],
  "size": "1.5K"
}

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

أرسل صورة واحدة بالضبط مع layer_decomposition: true. تعيد المهمة صورة القاعدة أولًا، ثم كل طبقة كملف ⁦PNG⁩ شفاف.

{
  "model": "seedream-5-0-pro",
  "image": "https://example.com/poster.png",
  "layer_decomposition": true,
  "prompt": "Separate the headline, the product and the background."
}

تتضمن كل طبقة z_index (صورة القاعدة هي 0؛ وتوضع الأرقام الأعلى فوقها)، وname وdescription وbounding_box. يمثّل bounding_box.absolute القيم [left, top, right, bottom] ببكسلات صورة القاعدة؛ ويمثّل bounding_box.normalized المربع نفسه بأجزاء من ألف من عرض صورة القاعدة وارتفاعها. لإعادة بناء الصورة، غيّر مقاس كل طبقة ليلائم مربعها وضعها على صورة القاعدة بترتيب z_index تصاعديًا.

مع size: "auto" تحتفظ صورة القاعدة وكل طبقة بمقاسها في صورة الإدخال. يجب أن يكون الإدخال ⁦PNG⁩ أو ⁦JPEG⁩ بعدد بكسلات إجمالي (العرض × الارتفاع) بين ⁦262,144⁩ (⁦512 × 512⁩) و⁦36,000,000⁩ (⁦6000 × 6000⁩).

خلفية شفافة

أرسل ملف ⁦PNG⁩ واحدًا يتضمن قناة ألفا مع background: "transparent" للحصول على ملف ⁦PNG⁩ بخلفية شفافة:

{
  "model": "seedream-5-0-pro",
  "prompt": "Turn this sticker into a glossy enamel pin, keep the outline.",
  "image": "https://example.com/sticker.png",
  "background": "transparent",
  "output_format": "png"
}

مدخلات الوسائط

كل صورة مرجعية رابط ⁦HTTP⁩(S) عام. ولا تُقبل روابط ⁦data URI⁩ بصيغة ⁦Base64⁩: ارفع الملف إلى تخزينك الخاص ومرّر رابطه. الصيغ المقبولة هي ⁦JPEG⁩ و⁦PNG⁩ و⁦WebP⁩ و⁦BMP⁩ و⁦TIFF⁩ و⁦GIF⁩ و⁦HEIC⁩ و⁦HEIF⁩، حتى ⁦30 MB⁩ لكل ملف، بنسبة بين ⁦1:16⁩ و⁦16:1⁩، وبعرض وارتفاع أكبر من ⁦14⁩ بكسل، وبحد أقصى ⁦36,000,000⁩ بكسل إجمالًا. يقبل تقسيم الصورة إلى طبقات ⁦PNG⁩ أو ⁦JPEG⁩ فقط.

عوامل التكلفة

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

generation:          cost = image price for its tier + extra references × reference price
layer decomposition: cost = images returned × per-image price for the request's tier

• تشمل شريحة السعر الأدنى الصور حتى ⁦2.61⁩ مليون بكسل (1.5K وما دون)؛ وكل ما يزيد يقع في الشريحة الأعلى.
• يُحتسب تقسيم الصورة إلى طبقات على صورة القاعدة وكل طبقة. يستخدم الطلب بأكمله شريحة واحدة: السعر الأدنى فقط عندما تبقى كل صورة مُعادة ضمن ⁦2.61⁩ مليون بكسل.
• يغطي المبلغ المحجوز عند قبول المهمة أكبر نتيجة ممكنة: صورة واحدة بالشريحة المطلوبة، أو ⁦17⁩ صورة لتقسيم الصورة إلى طبقات (يُحتسب auto ضمن الشريحة الأعلى). ثم تُحتسب المهمة على الصور المُعادة فعلًا ويُحرّر الفرق.

اطّلع على الرسوم النهائية في سجل استخدام حسابك. والمهام الفاشلة لا تُحتسب.

بنية المخرجات

يعيد الإرسال المهمة:

{"id": "task_...", "model": "seedream-5-0-pro", "status": "processing", "created_at": 1789689600}

جلب المهمة

GET https://api.seedrouter.ai/v1/tasks/{task_id}

استعلم كل ⁦10⁩–⁦20⁩ ثانية حتى تصبح status بقيمة completed أو failed. انتهاء مهلة الشبكة أثناء الاستعلام لا يعني فشل التوليد: احتفظ بمعرّف المهمة وتابع التحقق منها. ولا تنشئ مهمة أخرى للتحقق من التقدّم.

المهمة المكتملة

{
  "id": "task_...",
  "model": "seedream-5-0-pro",
  "status": "completed",
  "created_at": 1789689600,
  "finished_at": 1789689653,
  "output": {
    "created": 1789689650,
    "data": [
      {
        "url": "https://static.seedrouter.ai/media/tasks/task_example/0.jpg",
        "size": "1024x1024",
        "output_format": "jpeg"
      }
    ],
    "usage": { "output_tokens": 4096, "total_tokens": 4096 }
  }
}

تسرد مهمة تقسيم الصورة إلى طبقات صورة القاعدة ثم كل طبقة:

{
  "data": [
    { "url": "https://static.seedrouter.ai/media/tasks/task_example/0.jpg", "size": "832x1248", "output_format": "jpeg", "z_index": 0 },
    {
      "url": "https://static.seedrouter.ai/media/tasks/task_example/1.png",
      "size": "527x1044",
      "output_format": "png",
      "z_index": 1,
      "name": "Ceramic coffee cup",
      "description": "White ceramic cup with a matte glaze, extracted without the table.",
      "bounding_box": { "absolute": [212, 418, 610, 1206], "normalized": [255, 335, 733, 966] }
    }
  ]
}

في اختباراتنا، استغرقت صورة بمقاس 1K نحو ⁦35⁩–⁦55⁩ ثانية، واستغرق تقسيم الصورة إلى طبقات بمقاس 1K أعاد صورة القاعدة و⁦13⁩ طبقة نحو ⁦140⁩ ثانية.

الأخطاء

الطلبات المرفوضة قبل إنشاء المهمة تعيد خطأ ⁦HTTP⁩ مع كائن error ولا تُحتسب. أما المهمة التي تفشل بعد قبولها فتعيد ⁦HTTP 200⁩ عند الاستعلام عنها، مع status: "failed" وكائن error.

راجع فهرس الأخطاء المشترك للاطلاع على الرموز وحالات ⁦HTTP⁩ وإرشادات إعادة المحاولة.

{
  "id": "task_...",
  "model": "seedream-5-0-pro",
  "status": "failed",
  "error": {
    "code": 60001,
    "message": "The request was rejected by the content policy. Please revise the prompt or input images."
  }
}

إذا انتهت مهلة الإرسال نفسه، فراجع مهامك قبل الإرسال مجددًا: فربما قُبل الطلب الأول.

نصائح

• ابدأ بمقاس 1K أو 1.5K للتجربة والتعديل؛ يكلّف 1.5K مثل 1K.
• حدّد الشكل في الموجّه عند استخدام مستوى، أو أرسل أبعادًا دقيقة بالبكسل لتخطيط ثابت.
• مع عدة صور مرجعية، وضّح مساهمة كل منها وأشِر إليها بحسب ترتيبها.
• اضبط watermark: false عندما تحتاج إلى صورة بلا علامة؛ فالإعداد الافتراضي يضيف علامة.
• لتقسيم الصورة إلى طبقات، اسرد العناصر التي تريد فصلها لتقليل عدد الطبقات.

مواضيع ذات صلة

• ⁦Playground⁩ وأسعار ⁦Seedream 5.0 Pro⁩
• تنزيل ⁦OpenAPI⁩
• ⁦Markdown⁩ قابل للنسخ