Seedream 5.5

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

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

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

مثال سريع

curl https://api.seedrouter.ai/v1/images/generations \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedream-5-5",
    "prompt": "A ceramic teapot shaped like a sleeping fox on a linen tablecloth, soft morning window light, shallow depth of field. No text.",
    "size": "1K"
  }'

نقطة النهاية

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⁩: يعيد كل طلب صورة واحدة، أو حتى ⁦max_images⁩ من الصور مع ⁦layer_decomposition⁩. و⁦callback_url⁩ غير متاح؛ استعلم عن المهمة بدلًا منه.

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

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

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

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

{
  "model": "seedream-5-5",
  "prompt": "Turn this scene into a snowy winter night with warm light from the lighthouse windows, keep the composition",
  "image": "https://example.com/lighthouse.jpg",
  "size": "2560x1440"
}

خلفية شفافة

اضبط ⁦background: "transparent"⁩ للحصول على ملف ⁦PNG⁩ بخلفية شفافة، من موجّه وحده أو من صور مرجعية:

{
  "model": "seedream-5-5",
  "prompt": "A glossy red enamel pin shaped like a cherry, product cutout",
  "background": "transparent",
  "output_format": "png",
  "size": "1K"
}

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

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

{
  "model": "seedream-5-5",
  "image": "https://example.com/poster.jpg",
  "layer_decomposition": true,
  "size": "1K",
  "layer_decomposition_options": { "max_images": 4, "text_recognition": true }
}

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

يحدّد المستوى مقاس صورة القاعدة وكل طبقة. مع ⁦auto⁩، تتبع المخرجات صورة الإدخال، مع رفع المقاس إلى ⁦1K⁩ على الأقل وخفضه إلى ⁦2K⁩ كحد أقصى.

التعرف على النص

مع ⁦layer_decomposition_options.text_recognition: true⁩، تتضمن الطبقة التي تحمل نصًا مطبوعًا عاديًا أيضًا ⁦text_recognition⁩: قيمة ⁦text⁩ كاملة (الأسطر موصولة بـ⁦\n⁩)، و⁦lines⁩، لكل منها ⁦bounding_box⁩ خاص بها و⁦runs⁩ من نص بأنماط مختلفة. يتضمن ⁦style⁩ لكل مقطع ⁦similar_font_family⁩ و⁦foreground_color⁩ (⁦#RRGGBB⁩) والسمات ⁦bold⁩ و⁦italic⁩ و⁦underline⁩ و⁦strikethrough⁩ و⁦shadow⁩ و⁦translucent⁩. الخطوط والسمات تقديرات النموذج. لا تعيد الحروف الفنية أو المكتوبة بخط اليد نصًا، وقد يمنع ⁦prompt⁩ المُرسل مع التقسيم ظهوره، لذا تعامل مع الحقل على أنه اختياري.

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

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

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

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

cost = Σ each returned image's price for its own tier + reference images × reference price

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

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

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

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

{"id": "task_...", "model": "seedream-5-5", "status": "processing", "created_at": 1794323757}

جلب المهمة

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

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

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

{
  "id": "task_...",
  "model": "seedream-5-5",
  "status": "completed",
  "created_at": 1794323757,
  "finished_at": 1794323804,
  "output": {
    "data": [
      {
        "url": "https://static.seedrouter.ai/media/tasks/task_example/0.png",
        "size": "1248x832",
        "output_format": "png",
        "background": "opaque"
      }
    ]
  }
}

تسرد مهمة تقسيم الصورة إلى طبقات صورة القاعدة ثم كل طبقة. هذا تقسيم فعلي لملصق مع تفعيل التعرف على النص؛ نعرض صورة القاعدة والأولى من طبقاته الثلاث:

{
  "data": [
    { "url": "https://static.seedrouter.ai/media/tasks/task_example/0.png", "size": "836x1254", "output_format": "png", "background": "opaque", "z_index": 0 },
    {
      "url": "https://static.seedrouter.ai/media/tasks/task_example/1.png",
      "size": "1455x721",
      "output_format": "png",
      "background": "transparent",
      "z_index": 1,
      "name": "Dark blue serif main title text with dash decorations",
      "description": "Dark blue serif main title text reading \"BLUE TIDE SESSIONS\", with short horizontal dash decorations on its left and right sides.",
      "bounding_box": { "absolute": [0, 0, 836, 414], "normalized": [0, 0, 1000, 330] },
      "text_recognition": {
        "text": "BLUE TIDE\nSESSIONS",
        "lines": [
          {
            "bounding_box": { "absolute": [146, 69, 694, 196], "normalized": [175, 55, 830, 156] },
            "runs": [
              {
                "text": "BLUE TIDE",
                "style": { "similar_font_family": "HTF Didot", "foreground_color": "#122C4D", "bold": false, "italic": false, "underline": false, "strikethrough": false, "shadow": false, "translucent": false }
              }
            ]
          },
          {
            "bounding_box": { "absolute": [175, 168, 664, 300], "normalized": [209, 134, 794, 239] },
            "runs": [
              {
                "text": "SESSIONS",
                "style": { "similar_font_family": "HTF Didot", "foreground_color": "#122C4D", "bold": false, "italic": false, "underline": false, "strikethrough": false, "shadow": false, "translucent": false }
              }
            ]
          }
        ]
      }
    }
  ]
}

في اختباراتنا، استغرقت صورة بمقاس ⁦1K⁩ مدة ⁦47⁩ ثانية، وتحرير بمقاس ⁦2K⁩ مع صورة مرجعية واحدة ⁦40⁩ ثانية، وتقسيم الصورة إلى طبقات بمقاس ⁦1K⁩ أعاد أربع صور ⁦39⁩ ثانية. قد تستغرق عمليات التقسيم الأكبر عدة دقائق.

الأخطاء

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

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

{
  "id": "task_...",
  "model": "seedream-5-5",
  "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⁩.
• استخدم أبعادًا دقيقة بالبكسل لشكل ثابت، مثل ⁦2560x1440⁩ لنسبة ⁦16:9⁩ بمقاس ⁦2K⁩.
• لكل صورة مرجعية تكلفة: أرسل فقط الصور اللازمة للتحرير.
• لتقسيم الصورة إلى طبقات، اضبط ⁦max_images⁩ قريبًا من عدد العناصر المتوقع؛ فالحجز يتبعه.
• عندما تريد النص بالدرجة الأولى، احذف ⁦prompt⁩ من التقسيم مع تفعيل ⁦text_recognition⁩.

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

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