Call Seedream 5.5 from Python with one function per endpoint: text-to-image, image editing, image tools. Built on the official wavespeed SDK and the WaveSpeedAI hosted API — no GPU, pay per generation.
- Seedream 5.5 API guide, live pricing and playground: wavespeed.ai/seedream-5-5-api
- No code: generate in the browser with the AI Image Generator on WaveSpeedAI
pip install git+https://github.com/WaveSpeedAI/seedream-5.5-api.git
export WAVESPEED_API_KEY="your-api-key" # https://wavespeed.ai/accesskeyimport seedream_api
urls = seedream_api.text_to_image(
prompt="A lighthouse on a rocky coast at dawn, soft golden light, long exposure",
)
print(urls[0])Every function waits for the generation to finish and returns a list of output URLs. Optional arguments you leave out are not sent, so the API defaults apply. Inputs such as images, videos and audio are passed as URLs; use seedream_api.upload("local-file") to get a URL for a local file.
| Function | Model | Type |
|---|---|---|
text_to_image() |
bytedance/seedream-v5.5 | text-to-image |
edit() |
bytedance/seedream-v5.5/edit | image-to-image |
layer_decomposition() |
bytedance/seedream-v5.5/layer-decomposition | image-tools |
Each model page has a playground, live pricing and copy-paste API snippets. Prices are per generation and depend on the settings you choose; check a request before running it with wavespeed price <model> from the CLI.
bytedance/seedream-v5.5 — Seedream 5.5 Text to Image by ByteDance generates images from text prompts with improved photographic realism and aesthetics, native transparent-background output, aspect ratio selection, and 1K, 1.5K and 2K output tiers.
| Parameter | Type | Required | Default | Allowed | Description |
|---|---|---|---|---|---|
prompt |
str | yes | The positive prompt for the generation. | ||
aspect_ratio |
str | "1:1" |
1:1, 1:2, 2:1, 1:3, 3:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 9:21, 21:9 |
The aspect ratio of the generated image. Defaults to 1:1. | |
resolution |
str | "1k" |
1k, 1.5k, 2k |
The output resolution tier. 1k and 1.5k cost the same; 2k is the highest. | |
output_format |
str | "png" |
jpeg, png |
The format of the output image. PNG is the default; a transparent background is always returned as PNG. | |
background |
str | "auto" |
auto, transparent, opaque |
Whether the image has a transparent background. 'auto' lets the model decide from your prompt and output format; 'transparent' returns a PNG with an alpha channel, whatever output_format is; 'opaque' always returns a solid background. |
bytedance/seedream-v5.5/edit — Seedream 5.5 Edit by ByteDance edits and generates images from single-image or multi-reference inputs, supporting up to 10 reference images, consistent multi-turn edits, native transparent-background output, and 1K, 1.5K and 2K output tiers.
| Parameter | Type | Required | Default | Allowed | Description |
|---|---|---|---|---|---|
prompt |
str | yes | The positive prompt for the generation. | ||
images |
List[str] | yes | up to 10 items | The images to edit. A maximum of 10 reference images can be uploaded. | |
aspect_ratio |
str | 1:1, 1:2, 2:1, 1:3, 3:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 9:21, 21:9 |
The aspect ratio of the generated image. If not specified, it is determined automatically from the input image. | ||
resolution |
str | "1k" |
1k, 1.5k, 2k |
The output resolution tier. 1k and 1.5k cost the same; 2k is the highest. | |
output_format |
str | "png" |
jpeg, png |
The format of the output image. PNG is the default; a transparent background is always returned as PNG. | |
background |
str | "auto" |
auto, transparent, opaque |
Whether the image has a transparent background. 'auto' lets the model decide from your prompt and output format; 'transparent' returns a PNG with an alpha channel, whatever output_format is; 'opaque' always returns a solid background. |
bytedance/seedream-v5.5/layer-decomposition — Seedream 5.5 Layer Decomposition separates a single image into a base image and transparent layers, enabling flexible compositing, image editing, asset extraction, and layered design workflows.
| Parameter | Type | Required | Default | Allowed | Description |
|---|---|---|---|---|---|
image |
str | yes | The image to decompose into layers. | ||
prompt |
str | The positive prompt for the generation. | |||
resolution |
str | "1k" |
1k, 1.5k, 2k |
The output resolution tier: 1k, 1.5k, or 2k. Defaults to 1k. | |
max_images |
int | 30 |
2–100 | The maximum number of images to return: the base image plus its layers (2-100). The model plans the layers within this limit, and a larger value usually gives a finer split. Billing is per image, so the price is this number times the per-image price of the selected resolution. | |
output_format |
str | "png" |
jpeg, png |
The format of the base image. Every layer is returned as a PNG with transparency. |
The wrapper is a thin layer over the REST API: submit, then poll for the result.
curl -s -X POST "https://api.wavespeed.ai/api/v3/bytedance/seedream-v5.5" \
-H "Authorization: Bearer $WAVESPEED_API_KEY" -H "Content-Type: application/json" \
-d '{"prompt": "A lighthouse on a rocky coast at dawn, soft golden light, long exposure"}'
# -> {"data": {"id": "<prediction_id>"}}
curl -s "https://api.wavespeed.ai/api/v3/predictions/<prediction_id>/result" \
-H "Authorization: Bearer $WAVESPEED_API_KEY"
# -> status: completed, outputs: ["<url>"]npm i -g @wavespeed/cli && wavespeed login
wavespeed run bytedance/seedream-v5.5 -p "your prompt"- awesome-seedream-api — prompt library and variant guide
- More model wrappers: Seedance 2.5 · Wan 3.0 · Kling 4.0 · Veo 3.1 · MiniMax H3 · HappyHorse 1.1 · FLUX 3 · GPT Image 2.6 · Nano Banana 2.1
- SDKs and tools: Python · JavaScript · CLI · MCP server · ComfyUI nodes
- Full model catalog
- Seedream 5.5 is a model by ByteDance. This repository is maintained by WaveSpeedAI and wraps the WaveSpeedAI hosted API for it.
- Function signatures and the tables above are generated from the live model schemas (last generated 2026-11-22). The model pages are the source of truth if an endpoint changes.
- Issues and pull requests are welcome. License: MIT.