Claude Opus 5.5 כבר זמין ב-SeedRouter
LogoSeedRouter
כל המאמרים

מדריך Seedream 5.5 API: קוד Python, מחירים ופלט אמיתי

קרא ל-Seedream 5.5 API מ-Python: צור, ערוך עם תמונות ייחוס, הפק PNG שקוף ופרק תמונות לשכבות, עם שלוש הרצות אמיתיות והעלויות שלהן.

קריאה כ-Markdown

כדי לקרוא ל-⁦Seedream 5.5 API⁩, שלח ⁦POST⁩ ל-https://api.seedrouter.ai/v1/images/generations עם ⁦"model": "seedream-5-5"⁩ ופרומפט, שמור את ⁦id⁩ של המשימה שחוזר, ותשאל את ⁦GET /v1/tasks/{id}⁩ עד שהסטטוס יהיה ⁦completed⁩. המשימה שהושלמה מכילה את כתובות התמונות. אותה בקשה גם עורכת עם עד ⁦10⁩ תמונות ייחוס, יוצרת קובצי ⁦PNG⁩ עם רקע שקוף ומפרקת תמונה אחת לשכבות שקופות.

⁦ByteDance⁩ השיקה את ⁦Seedream 5.5⁩ ב-⁦9⁩ בנובמבר ⁦2026⁩, עם שלושה שינויים עיקריים: עריכה יציבה יותר לאורך סבבים רבים, פלט שקוף מובנה ותמונות מציאותיות יותר עם טקסט קטן ברור יותר.[1] הרצנו אותו שלוש פעמים ב-⁦SeedRouter⁩ למחרת. המדריך מתבסס על ההרצות האלה: הקוד ששלחנו, מה חזר, כמה זמן זה לקח וכמה זה עלה. כל שדה מפורט בתיעוד ⁦Seedream 5.5 API⁩, וה-⁦Playground⁩ נמצא בדף המודל.

מה צריך לפני הקריאה הראשונה ל-⁦Seedream 5.5 API⁩?

שני דברים: מפתח ⁦API⁩ ומזהה המודל. אין מה להוריד. ⁦ByteDance⁩ לא פרסמה את המשקולות של ⁦Seedream 5.5⁩, ולכן המודל פועל דרך ⁦API⁩ מתארח והקוד שלך רק שולח ⁦JSON⁩.

צור מפתח בעמוד מפתחות ⁦API⁩ ושמור אותו במשתנה סביבה בשרת שלך, לעולם לא בקוד שרץ בדפדפן:

export SEEDROUTER_API_KEY="your-key"
pip install requests

מזהה המודל הוא ⁦seedream-5-5⁩. מזהה אחד מכסה יצירה מטקסט לתמונה, עריכה ופירוק תמונה לשכבות; שדות הבקשה קובעים מה יופעל. חשבון חדש מתחיל עם יתרה חינמית קטנה, שמספיקה לכמה תמונות בדיקה בגודל ⁦1K⁩ לפני שטוענים יתרה.

איך יוצרים תמונה עם ⁦Python⁩?

השליחה חוזרת מיד עם משימה, ולא עם התמונה. הסקריפט הזה שולח פרומפט, מתשאל כל ⁦10⁩ שניות, מפסיק אחרי ⁦15⁩ דקות ושומר כל תמונה שחוזרת.

import os
import time
import requests

API = "https://api.seedrouter.ai/v1"
HEADERS = {"Authorization": f"Bearer {os.environ['SEEDROUTER_API_KEY']}"}


def submit(body):
    r = requests.post(f"{API}/images/generations", headers=HEADERS, json=body, timeout=60)
    r.raise_for_status()
    return r.json()["id"]


def wait(task_id, limit=900):
    deadline = time.time() + limit
    while time.time() < deadline:
        r = requests.get(f"{API}/tasks/{task_id}", headers=HEADERS, timeout=30)
        r.raise_for_status()
        task = r.json()
        if task["status"] in ("completed", "failed"):
            return task
        time.sleep(10)
    raise TimeoutError(f"{task_id} is still running; poll it again later")


task_id = submit({
    "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",
})
task = wait(task_id)
if task["status"] == "failed":
    raise RuntimeError(task["error"]["message"])

for i, image in enumerate(task["output"]["data"]):
    data = requests.get(image["url"], timeout=60).content
    with open(f"seedream-{i}.{image['output_format']}", "wb") as f:
        f.write(data)
    print(image["size"], image["url"])

זו ההרצה הראשונה שלנו. היא הסתיימה תוך ⁦47⁩ שניות והחזירה ⁦PNG⁩ אחד בגודל ⁦1248 × 832⁩.

קומקום תה מקרמיקה בצורת שועל ישן, שנוצר עם ⁦Seedream 5.5 API⁩ בגודל ⁦1K⁩

שני הרגלים מהלולאה חשובים בסביבת ייצור. אם התשאול נתקל בפסק זמן, שמור את מזהה המשימה ובדוק אותה שוב; ייתכן שהתמונה עדיין בדרך. אל תשלח את הבקשה פעם שנייה כדי "לנסות שוב", כי כך נוצרים משימה שנייה וחיוב שני.

אילו שדות בקשה חשובים?

רוב הבקשות צריכות רק ⁦model⁩, ⁦prompt⁩ ו-⁦size⁩. השדות שתגדיר בתדירות הגבוהה ביותר, עם ברירות המחדל שלהם:

שדהברירת מחדלמה הוא עושה
⁦prompt⁩חובהמה ליצור. אופציונלי רק בפירוק תמונה לשכבות.
⁦image⁩איןכתובת ציבורית אחת של תמונה, או רשימה של עד ⁦10⁩ כתובות, לעריכה; תמונה אחת בדיוק לפירוק תמונה לשכבות.
⁦size⁩⁦2K⁩⁦1K⁩, ⁦1.5K⁩ או ⁦2K⁩, או מידות מדויקות בפיקסלים כמו ⁦2560x1440⁩.
⁦output_format⁩⁦png⁩⁦png⁩ או ⁦jpeg⁩.
⁦background⁩⁦auto⁩⁦transparent⁩ יוצר ⁦PNG⁩ עם ערוץ אלפא.
⁦layer_decomposition⁩⁦false⁩פירוק תמונת הקלט היחידה לתמונת בסיס ולשכבות.
⁦layer_decomposition_options⁩אין⁦max_images⁩ (⁦2–100⁩, ברירת מחדל ⁦30⁩) ו-⁦text_recognition⁩.
⁦watermark⁩⁦false⁩⁦true⁩ מוסיף סימון "⁦AI generated⁩".

הפלט הגדול ביותר הוא ⁦2K⁩. העריכה שלנו ביחס ⁦16:9⁩ בגודל ⁦2K⁩ החזירה ⁦2560 × 1440⁩, וגדלים מדויקים בפיקסלים יכולים להגיע לסך של ⁦4,624,220⁩ פיקסלים. אין שדה ליחס גובה-רוחב: לצורה קבועה, שלח מידות מדויקות בפיקסלים. אין רמת ⁦3K⁩ או ⁦4K⁩, כך שאם צריך קובץ גדול יותר, תצטרך להגדיל אותו אחר כך. תיעוד ⁦API⁩ מפרט את כל השדות. שדות שאינם מפורטים בו מוסרים במקום להידחות, כך ש-⁦seed⁩, ⁦style⁩ או ⁦n⁩ שנשארו בטעות מ-⁦API⁩ אחר לתמונות לא יכשילו את הבקשה, וגם לא יעשו דבר. בקשה אחת יוצרת תמונה אחת.

איך עורכים תמונה עם תמונות ייחוס?

הכנס את תמונת המקור ל-⁦image⁩ וציין בפרומפט מה לשנות ומה לשמור. ההרצה השנייה שלנו הפכה צילום שטוף שמש של צבעי על המרפסת שמקיפה את ראש המגדלור לליל חורף:

task_id = submit({
    "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://static.seedrouter.ai/media/landing/models/seedream-5-5/v1/lighthouse-source.webp",
    "size": "2560x1440",
})

היא נמשכה ⁦40⁩ שניות והחזירה ⁦PNG⁩ בגודל ⁦2560 × 1440⁩. הצבעי, התנוחה שלו, המברשת, החבל המגולגל, שתי פחיות הצבע והמעקה נשארו כולם במקומם. נוספו שלג יורד, שלג על רצפת המרפסת ועל כתפיו, שמיים חשוכים וחלונות מוארים מעל הפס האדום.

סצנת הצבעי במגדלור אחרי העריכה של ⁦Seedream 5.5⁩ לליל חורף מושלג

עם כמה תמונות ייחוס, התייחס אליהן לפי הסדר ברשימה ("הז׳קט מתמונה ⁦2⁩"). כל תמונת ייחוס מחויבת, כולל הראשונה, אז שלח רק את התמונות שהעריכה צריכה.

הטענה המרכזית של ⁦ByteDance⁩ לגבי הגרסה הזו היא שאזורים שלא נערכו נשארים זהים ברמת הפיקסל לאורך עריכות, כפי שנבדק ב-⁦100⁩ סבבים רצופים.[1] דרך ה-⁦API⁩, עריכה בכמה סבבים היא לולאה: קח את כתובת ה-⁦URL⁩ ממשימה שהושלמה והעבר אותה ב-⁦image⁩ בבקשה הבאה. עדיין לא הרצנו בעצמנו שרשרת ארוכה, ולכן איננו יכולים לאשר את הנתון של ⁦100⁩ סבבים. זכור שכל סבב הוא משימה חדשה וכולל תשלום על תמונת הייחוס שלו.

איך מקבלים ⁦PNG⁩ שקוף?

הגדר את ⁦background⁩ ל-⁦transparent⁩ והשאר את ⁦output_format⁩ כ-⁦png⁩. זה עובד מפרומפט בלבד או עם תמונות ייחוס:

task_id = submit({
    "model": "seedream-5-5",
    "prompt": "A glossy red enamel pin shaped like a cherry, product cutout",
    "background": "transparent",
    "size": "1K",
})

⁦transparent⁩ עם ⁦jpeg⁩ נדחה לפני שנוצרת משימה, כי ל-⁦JPEG⁩ אין ערוץ אלפא. ⁦ByteDance⁩ מתארת זאת כפלט ⁦RGBA⁩ מובנה עם שקיפות מלאה וחלקית וקצוות שמרונדרים בקפידה, כך שאין צורך להסיר את הרקע מהנכס בנפרד.[1]

איך מפרקים תמונה לשכבות דרך ה-⁦API⁩?

שלח תמונה אחת בדיוק עם ⁦layer_decomposition: true⁩. ההרצה השלישית שלנו פירקה פוסטר ג׳אז עם זיהוי טקסט מופעל ועם החזרה של ארבע תמונות לכל היותר:

task_id = submit({
    "model": "seedream-5-5",
    "image": "https://static.seedrouter.ai/media/landing/models/seedream-5-5/v1/poster-source.webp",
    "layer_decomposition": True,
    "size": "1K",
    "layer_decomposition_options": {"max_images": 4, "text_recognition": True},
})

היא נמשכה ⁦39⁩ שניות והחזירה ארבע תמונות: תמונת הבסיס ושלוש שכבות שקופות.

פוסטר ג׳אז שפורק באמצעות ⁦Seedream 5.5 API⁩ לתמונת בסיס, שכבת איור ושתי שכבות טקסט

⁦z_index⁩⁦name⁩ כפי שהוחזרהתיבה על תמונת הבסיסקובץ ⁦PNG⁩
0תמונת בסיסכל הקנבס⁦836 × 1254⁩
1⁦Dark blue serif main title text with dash decorations⁩⁦836 × 414⁩⁦1455 × 721⁩
2⁦Gradient paper art figure and wave decorations⁩⁦836 × 1067⁩⁦906 × 1157⁩
3⁦Dark blue serif bottom caption text⁩⁦765 × 204⁩⁦1981 × 529⁩

שתי שכבות הטקסט חזרו עם המילים שחולצו. ה-⁦text_recognition⁩ של שכבת הכותרת הכיל ⁦"BLUE TIDE\nSESSIONS"⁩, עם גופן שהוערך כ-⁦HTF Didot⁩ בצבע ⁦#122C4D⁩, ושכבת שורת הפרטים הכילה ⁦"LIVE JAZZ · PIER 7 HALL · SATURDAY 9 PM"⁩. לכל שורה יש תיבה תוחמת וסגנון משלה, כך שתוכל להקליד מחדש את הטקסט בגופן שלך באותו מקום.

שלושה דברים שכדאי לדעת לפני שמסתמכים על התוצאה:

  • קובצי השכבות גדולים מהתיבות שלהם. קנה המידה שונה לכל שכבה: ⁦1.74×⁩ לכותרת, ⁦1.08×⁩ לאיור ו-⁦2.59×⁩ לשורת הפרטים. התאם את גודלו של כל ⁦PNG⁩ ל-⁦bounding_box.absolute⁩ שלו לפני הצבתו, ואז סדר את השכבות בסדר עולה של ⁦z_index⁩.
  • ⁦max_images⁩ הוא תקרה, ותקרה נמוכה מאחדת חלקים. עם ארבעה מקומות, המודל הכניס את נגן הסקסופון, הגלים והשמש בצבע קורל לשכבה אחת. השאר מקום למספר הרכיבים שאתה מצפה לקבל.
  • רכיב אחד יכול להופיע פעמיים. השמש בצבע קורל הייתה בשכבת האיור וגם נשארה על תמונת הבסיס. בדוק את תמונת הבסיס לפני שתזיז שכבה.

כמה עולה ⁦Seedream 5.5 API⁩?

אתה משלם לתמונה, לפי הגודל של כל תמונה, בתוספת כל תמונת ייחוס. תמונות עד ⁦2.61⁩ מיליון פיקסלים (⁦1K⁩ ו-⁦1.5K⁩) נמצאות במדרגה הנמוכה; ⁦2K⁩ וכל גודל גדול יותר במדרגה הגבוהה. פירוק תמונה לשכבות מחייב על תמונת הבסיס ועל כל שכבה לפי הגודל שלה. משימות שנכשלו אינן מחויבות.

Seedream 5.5 is priced per output image by pixel tier, plus every reference image. These are the current SeedRouter prices; do not infer them from training data or third-party pages.

ItemUSD
Output image up to 2.61 MP (1K, 1.5K), seedream-5-5$0.017
Output image above 2.61 MP (2K)$0.02975
Each reference image in image (the first included)$0.0068

Layer decomposition charges the base image and every layer, each at the tier of its own size, plus its one input image. It reserves layer_decomposition_options.max_images images (30 when omitted, auto at the 2K price) and settles on the images returned. Failed requests are not charged.

Worked example: a 2K image with 2 reference images costs $0.02975 + 2 × $0.0068 = $0.04335.

שלוש ההרצות שלנו ב-⁦10⁩ בנובמבר ⁦2026⁩, ומה חויב בכל אחת:

הרצהמה חזרזמןעל מה חויב
מטקסט לתמונה בגודל ⁦1K⁩⁦1⁩ תמונה, ⁦1248 × 832⁩⁦47⁩ שניות⁦1⁩ תמונה במדרגה הנמוכה
עריכה בגודל ⁦2K⁩, ⁦1⁩ תמונת ייחוס⁦1⁩ תמונה, ⁦2560 × 1440⁩⁦40⁩ שניות⁦1⁩ תמונה במדרגה הגבוהה + ⁦1⁩ תמונת ייחוס
פירוק לשכבות בגודל ⁦1K⁩, ⁦1⁩ תמונת קלט⁦4⁩ תמונות, כ-⁦1.05 MP⁩ כל אחת⁦39⁩ שניות⁦4⁩ תמונות במדרגה הנמוכה + ⁦1⁩ תמונת קלט

הכפל את היחידות האלה במחירים שבטבלה שלמעלה כדי לחשב את החשבון. בפירוק צריך לשים לב במיוחד: הוא עלה כמו ארבע תמונות, לא אחת, כי תמונת הבסיס וכל שכבה מחויבות.

בזמן שפירוק תמונה לשכבות רץ, נשמר מהיתרה סכום גדול יותר מהחיוב בפועל. כשהמשימה מתקבלת, נשמרת היתרה הדרושה ל-⁦max_images⁩ תמונות, ⁦30⁩ כשהשדה מושמט, כאשר ⁦auto⁩ נחשב למדרגה הגבוהה. כשהמשימה מסתיימת, החיוב הוא על התמונות שחזרו והשאר משתחרר. לכן, פירוק ללא ⁦max_images⁩ וללא ⁦size⁩ זקוק ליתרה שמספיקה ל-⁦30⁩ תמונות במדרגה הגבוהה בתוספת תמונת הקלט כדי להתחיל, גם אם הוא מחזיר ארבע תמונות. הגדר את ⁦max_images⁩ קרוב למספר החלקים שאתה מצפה לקבל ובחר רמה, כמו בהרצה השלישית שלנו (התבקשו ארבע תמונות, חזרו ארבע), והסכום שנשמר יישאר קרוב לחשבון.

לאילו שגיאות צריך להיערך?

מה קורהמתיחיוב
⁦HTTP 400⁩ בשליחהפרומפט חסר, ⁦transparent⁩ עם ⁦jpeg⁩, יותר מ-⁦10⁩ תמונות ייחוס, גודל מחוץ לטווח, פירוק לשכבות שאין בו תמונה אחת בדיוקלא
⁦HTTP 401⁩ בשליחהמפתח ⁦API⁩ חסר או שגוילא
משימה במצב ⁦failed⁩ עם ⁦error⁩מדיניות התוכן דחתה את הפרומפט או התמונה, או שלא ניתן היה לקרוא את תמונת הקלטלא
פסק זמן בתשאולרשת או פירוק ממושךהמשך לתשאל את אותו מזהה

תמונות הייחוס חייבות להיות כתובות ⁦HTTP(S)⁩ ציבוריות. כתובות ⁦data URI⁩ ב-⁦Base64⁩ נדחות, אז העלה קודם את הקובץ לאחסון שלך. הפורמטים ⁦JPEG⁩, ⁦PNG⁩, ⁦WebP⁩, ⁦BMP⁩, ⁦TIFF⁩, ⁦GIF⁩, ⁦HEIC⁩ ו-⁦HEIF⁩ מתקבלים, עד ⁦30 MB⁩ לכל קובץ. רשימת הקודים המלאה נמצאת בקטלוג השגיאות.

שאלות נפוצות

יש גרסת ⁦Pro⁩ של ⁦Seedream 5.5⁩?

עדיין לא. פוסט ההשקה של ⁦ByteDance⁩ אומר "⁦A Pro version of the Seedream 5.5 series will follow⁩" (בהמשך תגיע גרסת ⁦Pro⁩ של הסדרה) ואינו מציין תאריך.[1] כיום יש ב-⁦API⁩ מודל אחד, ⁦seedream-5-5⁩. מודל ה-⁦Pro⁩ מהדור הקודם עדיין זמין בתור ⁦Seedream 5.0 Pro⁩.

האם ⁦Seedream 5.5 API⁩ חינמי?

לא. משלמים לתמונה מתוך יתרה ששולמה מראש, ללא מנוי. היתרה החינמית הקטנה של חשבון חדש מספיקה לכמה תמונות בגודל ⁦1K⁩, כך שתוכל להריץ את הסקריפט שלמעלה לפני שתטען יתרה.

אפשר להוריד את ⁦Seedream 5.5⁩?

לא. ⁦ByteDance⁩ לא פרסמה את משקולות המודל, ולכן אין קובץ להרצה מקומית. משתמשים בו דרך ⁦API⁩ כמו זה.

כמה תמונות ייחוס אפשר לשלוח?

עד ⁦10⁩ ב-⁦image⁩. פירוק תמונה לשכבות מקבל תמונה אחת בדיוק.

כמה זמן לוקחת בקשה?

שלוש ההרצות שלנו נמשכו ⁦39⁩ עד ⁦47⁩ שניות. פירוקים שמחזירים שכבות רבות יכולים להימשך כמה דקות, ולכן הסקריפט שלמעלה מתשאל עד ⁦15⁩ דקות.

מקורות

  1. ⁦ByteDance Seed⁩. ⁦More Realistic Images, More Stable Editing Across 100 Rounds | Introducing Seedream 5.5⁩. ⁦9⁩ בנובמבר ⁦2026⁩. נבדק ב-⁦11⁩ בנובמבר ⁦2026⁩ באתר seed.bytedance.com.
  2. ⁦SeedRouter⁩. תיעוד ⁦Seedream 5.5 API⁩. /docs/seedream-5-5.
כל המאמרים

מדריכים קשורים