SeeDream Images Generation API توضيح الربط

​

عملية التقديم

📘 الوثائق الكاملة: SeeDream Images Generation API →

​

الاستخدام الأساسي

• accept: نوع الاستجابة التي ترغب في تلقيها، هنا يتم ملؤها بـ application/json، أي بتنسيق JSON.
• authorization: مفتاح استدعاء API، يمكن اختياره مباشرة بعد التقديم.

• prompt: كلمة التلميح.
• model: نموذج التوليد، الافتراضي هو doubao-seedream-5-0-260128 (SeeDream 5.0 Lite، الأحدث). يدعم doubao-seedream-5-0-pro-260628، doubao-seedream-5-0-260128 (يقبل أيضًا الاسم المستعار الرسمي doubao-seedream-5-0-lite-260128)، doubao-seedream-4-5-251128، doubao-seedream-4-0-250828. حيث أن doubao-seedream-5-0-pro-260628 (SeeDream 5.0 Pro) هو نموذج الصورة الفردية الرائد، يقوم بتوليد صورة واحدة فقط، لا يدعم توليد مجموعة صور (sequential_image_generation)، أو التدفق (stream) أو البحث عبر الإنترنت (tools). يجب تمرير سلسلة النموذج الكاملة (doubao-seedream-5-0-260128)، تمرير اختصارات مثل doubao-seedream-5.0-lite سيؤدي إلى إرجاع 400.
• image: معلومات الصورة المدخلة، تدعم URL أو ترميز Base64. doubao-seedream-5-0-pro-260628 يدعم إدخال صورة واحدة أو عدة صور (من 2 إلى 10 صور، بدءًا من الصورة الثانية يتم احتسابها)، doubao-seedream-5-0-260128، doubao-seedream-4-5-251128، doubao-seedream-4-0-250828 تدعم إدخال صورة واحدة أو عدة صور.
• size: تحديد معلومات حجم الصورة المولدة، تدعم الطريقتين التاليتين، ولا يمكن استخدامهما معًا. الطريقة 1 | تحديد دقة الصورة المولدة، ووصف نسبة العرض إلى الارتفاع للصورة بلغة طبيعية في prompt. تختلف الإعدادات المدعومة لكل نموذج: doubao-seedream-5-0-pro-260628 يدعم 1K/1.5K/2K؛ doubao-seedream-5-0-260128 يدعم 2K/3K/4K؛ doubao-seedream-4-5-251128 يدعم فقط 2K/4K؛ doubao-seedream-4-0-250828 يدعم 1K/2K/4K. الطريقة 2 | تحديد قيم بكسل العرض والارتفاع للصورة المولدة: الافتراضي هو 2048x2048، نطاق القيم الكلي للبكسل ونسبة العرض إلى الارتفاع تختلف حسب النموذج (على سبيل المثال، نطاق البكسل الكلي لـ 5.0 Pro هو [921600, 4624220]، الحد الأدنى للبكسل الكلي لـ 5.0 Lite / 4.5 هو 3,686,400، والحد الأدنى لـ 4.0 هو 921,600).
• sequential_image_generation: مجموعة الصور: مجموعة من الصور المرتبطة بالمحتوى الذي أدخلته. doubao-seedream-5-0-260128، doubao-seedream-4-5-251128، doubao-seedream-4-0-250828 تدعم هذه المعلمة، الافتراضي هو disabled.
• stream: التحكم في ما إذا كان سيتم تفعيل وضع الإخراج المتدفق. doubao-seedream-5-0-260128، doubao-seedream-4-5-251128، doubao-seedream-4-0-250828 تدعم هذه المعلمة، الافتراضي هو false.
• response_format: تحديد تنسيق الاستجابة للصورة المولدة. الافتراضي هو url، ويدعم أيضًا b64_json.
• watermark: ما إذا كان يجب إضافة علامة مائية إلى الصورة المولدة. الافتراضي هو true.
• output_format: تحديد تنسيق ملف الصورة المولدة، يدعم jpeg (الافتراضي) و png. فقط doubao-seedream-5-0-pro-260628 و doubao-seedream-5-0-260128 تدعمان ذلك.
• tools: تكوين الأدوات التي يجب على النموذج استدعاؤها، حاليًا تدعم web_search (البحث عبر الإنترنت). فقط SeeDream 5.0 Lite تدعم ذلك.
• optimize_prompt_options: تكوين تحسين كلمة التلميح. 5.0 Pro تدعم standard/fast؛ 5.0 Lite و 4.5 تدعمان فقط standard؛ 4.0 تدعم standard/fast.
• background: يدعم فقط تحرير الصورة الفردية 5.0 Pro. transparent يتطلب إدخال صورة PNG تحتوي على قناة شفافة، ويجب أن يكون output_format هو png؛ opaque هو خلفية عادية غير شفافة.
• layer_decomposition: يدعم فقط 5.0 Pro. عند تعيينه إلى true، يجب إدخال صورة PNG/JPEG، يمكن عدم تمرير prompt للتقسيم التلقائي، أو استخدام لغة طبيعية/<bbox> لتحديد العناصر؛ size تدعم auto/1K/1.5K/2K. لا يمكن استخدام هذا الوضع مع مجموعة الصور، أو التدفق، أو البحث عبر الإنترنت، أو background.
• callback_url: URL الذي يحتاج إلى استدعاء النتائج.
• async: ما إذا كان يجب معالجة الطلب بشكل غير متزامن. عند تعيينه إلى true، ستعيد الواجهة على الفور task_id، دون الحاجة لتوفير callback_url، ثم يمكنك الاستعلام عن النتائج عبر /seedream/tasks.

{
  "success": true,
  "task_id": "81246f86-05ff-4d7d-9553-1013e0c1cd32",
  "trace_id": "ab50a78d-ab1f-457f-a46b-c2259cd5d35b",
  "data": [
    {
      "prompt": "لقطة منتج فوتوغرافية واقعية لزجاجة عطر زجاجية مزخرفة على لوح أسود مبلل، ضوء رئيسي من صندوق ناعم واحد، قطرات ماء، خلفية داكنة ومزاجية، 85 مم ماكرو.",
      "size": "2048x2048",
      "image_url": "https://platform2.cdn.acedata.cloud/seedream/901c6af6-e83a-4849-b233-295f6c20bacb.jpg"
    }
  ]
}

• success، حالة مهمة توليد الفيديو في الوقت الحالي.
• task_id، معرف مهمة توليد الفيديو في الوقت الحالي.
• trace_id، معرف تتبع مهمة توليد الفيديو في الوقت الحالي.
• data، قائمة نتائج مهمة توليد الصورة في الوقت الحالي.
  • image_url، رابط مهمة توليد الصورة في الوقت الحالي.
  • prompt، كلمة التوجيه.
  • size: بكسل الصورة المولدة.

curl -X POST 'https://api.acedata.cloud/seedream/images' \
-H 'accept: application/json' \
-H 'authorization: Bearer ${token}' \
-H 'content-type: application/json' \
-d '{
  "action": "generate",
  "model": "doubao-seedream-5-0-260128",
  "prompt": "لقطة منتج فوتوغرافية واقعية لزجاجة عطر زجاجية مزخرفة على لوح أسود مبلل، ضوء رئيسي من صندوق ناعم واحد، قطرات ماء، خلفية داكنة ومزاجية، 85 مم ماكرو."
}'

​

تحرير مهمة الصورة

• model: النموذج المستخدم في مهمة تحرير الصورة هذه، doubao-seedream-5-0-pro-260628، doubao-seedream-5-0-260128، doubao-seedream-4-5-251128، doubao-seedream-4-0-250828 تدعم جميعها إدخال الصورة.
• image: تحميل الصورة التي تحتاج إلى تحريرها، صورة واحدة أو أكثر.

import requests

url = "https://api.acedata.cloud/seedream/images"

headers = {
    "accept": "application/json",
    "authorization": "Bearer {token}",
    "content-type": "application/json"
}

payload = {
    "model": "doubao-seedream-4-0-250828",
  "prompt": "احتفظ بوضعية النموذج وشكل الملابس السائلة المتدفقة دون تغيير. غير مادة الملابس من المعدن الفضي إلى ماء شفاف تمامًا (أو زجاج). من خلال تدفق السائل، يمكن رؤية تفاصيل جلد النموذج. ينتقل تأثير الضوء والظل من الانعكاس إلى الانكسار.",
  "image": ["https://ark-project.tos-cn-beijing.volces.com/doc_image/seedream4_5_imageToimage.png"],
  "size": "2K",
  "watermark": False
}

response = requests.post(url, json=payload, headers=headers)
print(response.text)

{
  "success": true,
  "task_id": "c9aaffa2-b8ac-40ff-8468-43e77cb9ddde",
  "trace_id": "131a40c3-2eaf-44c9-af28-c9b408577286",
  "data": [
    {
      "prompt": "احتفظ بوضعية النموذج وشكل الملابس السائلة المتدفقة دون تغيير. غير مادة الملابس من المعدن الفضي إلى ماء شفاف تمامًا (أو زجاج). من خلال تدفق السائل، يمكن رؤية تفاصيل جلد النموذج. ينتقل تأثير الضوء والظل من الانعكاس إلى الانكسار.",
      "size": "2048x2048",
      "image_url": "https://platform.cdn.acedata.cloud/seedream/3e88db7e-4771-4f6a-adbd-5ae4590c5d59.jpg"
    }
  ]
}

​

تقسيم الطبقات (Seedream 5.0 Pro)

curl -X POST 'https://api.acedata.cloud/seedream/images' \
-H 'accept: application/json' \
-H 'authorization: Bearer ${token}' \
-H 'content-type: application/json' \
-d '{
  "model": "doubao-seedream-5-0-pro-260628",
  "image": "https://example.com/poster.png",
  "layer_decomposition": true,
  "size": "2K",
  "watermark": false
}'

​

الإخراج المتدفق

​

ردود غير متزامنة

{
  "task_id": "c9aaffa2-b8ac-40ff-8468-43e77cb9ddde"
}

{
    "success": true,
    "task_id": "c9aaffa2-b8ac-40ff-8468-43e77cb9ddde",
    "trace_id": "131a40c3-2eaf-44c9-af28-c9b408577286",
    "data": [
        {
            "prompt": "احتفظ بوضعية النموذج وشكل الملابس السائلة كما هو. غير مادة الملابس من المعدن الفضي إلى ماء شفاف تمامًا (أو زجاج). من خلال تدفق السائل، يمكن رؤية تفاصيل جلد النموذج. يتغير تأثير الضوء والظل من الانعكاس إلى الانكسار.",
            "size": "2048x2048",
            "image_url": "https://platform.cdn.acedata.cloud/seedream/3e88db7e-4771-4f6a-adbd-5ae4590c5d59.jpg"
        }
    ]
}

​

معالجة الأخطاء

• 400 token_mismatched : طلب غير صحيح، ربما بسبب معلمات مفقودة أو غير صالحة.
• 400 api_not_implemented : طلب غير صحيح، ربما بسبب معلمات مفقودة أو غير صالحة.
• 401 invalid_token : غير مصرح، رمز تفويض غير صالح أو مفقود.
• 429 too_many_requests : عدد كبير جدًا من الطلبات، لقد تجاوزت الحد الأقصى لمعدل الطلبات.
• 500 api_error : خطأ في الخادم الداخلي، حدث خطأ ما على الخادم.

​

مثال على استجابة الخطأ

{
  "success": false,
  "error": {
    "code": "api_error",
    "message": "فشل في الاسترجاع"
  },
  "trace_id": "2cf86e86-22a4-46e1-ac2f-032c0f2a4e89"
}

​

الاستنتاج