Introduction
Seedream 5.0 Lite Text-to-Image turns a written brief into a new, reviewable image. It is the text-led route for exploring composition, visual hierarchy and art direction before an approved source image needs to control the result.
Choose a Seedream 5.0 Lite mode by starting material
| Starting material | Mode |
|---|---|
| A written art direction or design brief | Seedream 5.0 Lite Text to Image |
| An approved source image to revise | Seedream 5.0 Lite Image Editing |
Key features & highlights
Layout-aware design exploration
Seedream 5.0 Lite is useful for testing a visual hierarchy across posters, feeds, banners and illustrative layouts. Start with the intended placement and message, then judge the result for readability before adding decorative complexity.
Illustration and graphic treatments
The model can support both graphic and illustrative directions alongside photographic concepts. Name the desired treatment and the elements that must remain legible so review does not collapse into a vague preference.
Create from a brief or revise a source on purpose
Text-to-image begins with an original composition. Image editing begins with supplied material; use it when the task is a targeted visual change rather than another attempt to describe the source from memory.
Request parameters
| Parameter | Required | Description |
|---|---|---|
prompt | Yes | 3 to 3,000 characters. Write it for the frame you chose — the wide preset wants a composition staged across a strip, not a portrait pushed sideways. at least 3 characters · at most 3000 characters |
size | No | A named 2K preset, eight options from 20482048 square to 31361344 ultra-wide. |
output_format | No | jpeg by default, or png. png is lossless and the safer handoff into flatting, retouching or overpainting; it changes the delivered file, not the image that was generated. |
Pricing
$0.035 / image
Use cases
Start from a written brief
Seedream 5.0 Lite Text to Image renders a brief into a single image at a preset you name. Instead of a free ratio, size is a named widthheight string, and every preset is a 2K frame. Choose one of the eight presets before you write, from the 20482048 square to the 3136*1344 strip, and describe the subject, composition and light for that shape.
Costume character illustration sets
Costume-led anime and illustration work — leotards, tights, ears and tails — produced at 20482048 or 17282304 so a whole set shares one frame shape and needs no cropping before it goes into a gallery or a card layout.
Print comps and layout mocks
23041728 is a landscape print-comp shape and 17282304 its portrait counterpart. Generate the layout at the preset the comp will use and judge legibility and spacing at that size, not from a thumbnail.
Ultra-wide banners and key art
3136*1344 is already the shape of a site hero or a storefront banner. Generating at that preset composes the subject for the strip instead of leaving you to crop a landscape frame and lose the staging.
Prompt guide & pro tips
Write the brief for that frame
Subject, wardrobe, palette, line quality, lighting — one pass, up to 3,000 characters. The illustration for this endpoint came from: "Anime illustration, an adult bunny-girl croupier at a velvet casino table, black satin leotard with a white collar and cuffs, sheer black tights and bunny-ear headband, fanning a deck of cards with a confident smirk, chandelier bokeh and stacked chips, rich crimson and gold palette, crisp cel shading, cinematic rim light, detailed linework."
Poll the task and keep the brief
Create the task, poll for a terminal state, fetch the image from platform storage. There is no seed field, so store the prompt with any frame you intend to reproduce or extend into a series.
Adapt the included example
Start with the published example using output_format: png, size: 2048*2048. Replace the subject and creative direction while keeping the input contract for this mode intact.
Anime illustration, an adult bunny-girl croupier at a velvet casino table, black satin leotard with a white collar and cuffs, sheer black tights and bunny-ear headband, fanning a deck of cards with a confident smirk, chandelier bokeh and stacked chips, rich crimson and gold palette, crisp cel shading, cinematic rim light, detailed linework.
The exact request behind the illustration for this endpoint: a square preset delivered as png, with palette, line quality and rim light all named in the brief.
Check the result before iterating
size is the whole framing control — there is no aspect_ratio and no seed, so a frame you like cannot be redrawn exactly and the brief has to be stored with the asset. The eight 2K presets are the complete list; anything outside them is rejected before the request leaves the platform, and the delivered pixels can come in slightly under the named size. A wide preset such as 3136*1344 rewards a composition written for a strip; a portrait brief squeezed into one comes back with dead space.
API quick start
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "bytedance/seedream-5.0-lite/text-to-image",
"input": {
"size": "2048*2048",
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"output_format": "jpeg"
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
See the API reference for authentication, the complete schema, polling, and error handling.












