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⁩ להעתקה