Scenario Seedream

Scenario Seedream Images

Overview

Seedream, ByteDance's image family on Scenario, spans generation, reference-driven editing, and one member that only takes images apart: Layerize splits a finished image into editable layers. The members agree on little else, so discover them with search and read model_schema_get before every run.

Connection and the core loop: see the scenario skill; model-agnostic image work: the scenario-image skill. If a sibling skill named here is missing from your available skills, ask the user to install it (npx skills add scenario-labs/skills --skill <name>); unattended, proceed from tool schemas and flag the gap.

Quick reference

At authoring time (fields and caps are per member, read the live schema):

On the generators, mode follows from the inputs: empty referenceImages is text-to-image, one or more is an edit or a multi-reference generation (with several, the prompt gives each reference a role by position), and the array shape holds even for one asset. Sequence mode (sequentialImageGeneration: "auto" plus maxImages) lets Lite and 4.5 return a related set in one run, input plus generated capped at 15 images; Pro has no sequence fields. Price per image differs widely: a 2048 px square quoted 4 CU on Flash, 6 on Lite, and 18 on Pro at authoring time, and Pro took about two minutes against under one, so iterate on the cheap members and spend Pro on finals; dry_run both before a batch (the estimate prices the run exactly as submitted, a whole sequence included). Pro and Pro Layerize carry optimizePromptMode: the default standard reasons about the prompt first and is slower; fast costs the same and is usually enough when a reference already sets the composition (on Layerize it trades some split fidelity for speed). Flash's schema says width and height apply only when Resolution is Custom, but Flash has no Resolution field: the pixels apply directly.

Keeping a transparent asset transparent

Flash's background: "transparent" preserves alpha through an edit; it does not cut a subject out. It keeps the transparent surround, not translucency inside the subject: glass at alpha 170 came back near-opaque in one authoring-time test, so composite a translucent part in post. The field defaults to opaque, so a restyle that omits it flattens a valid cutout: set it on every run that must stay transparent. It applies only with exactly one reference image that already carries an alpha channel, and is ignored otherwise: a text-only run, a flattened JPEG reference, or two references all come back opaque without an error. So restyle or recolor an existing cutout (a sprite, an icon, a prop) on Flash with the PNG as the one reference, and check the result's alpha on the downloaded file before shipping it, since asset_display composites transparency away: with Pillow (uv run --with pillow when it is missing), Image.open(path).getchannel("A").getextrema() should start at 0 (fully transparent pixels exist), and an image with no A channel was flattened. To get a cutout in the first place, generate on a plain field and run background removal (the scenario-image-editing skill), or split the image with Layerize.

Write the exact copy into the prompt

Pro renders legible in-image text, multi-line layouts and non-Latin scripts included. Quote the exact strings in the prompt instead of paraphrasing them, give each a position and a size rank (headline across the top, date line small at the foot), and keep to a few elements at one or two sizes: letters are drawn, not typeset, so paragraphs and many small labels turn to shapes, and copy past that budget (tour dates, credits) is composited in post from the start. Proofread with asset_display; a word that garbles is spelled out letter by letter after the quoted string on the rerun, and one that still garbles goes to post. To swap copy on a reference, quote the new string, pin its position, and require the original typeface, size and color with everything else unchanged.