Skip to content

Latest commit

 

History

1 Commit

Folders and files

Repository files navigation

Seedream 5.5 API — Python wrapper

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 Try in browser

Quick start

pip install git+https://github.com/WaveSpeedAI/seedream-5.5-api.git
export WAVESPEED_API_KEY="your-api-key"   # https://wavespeed.ai/accesskey
import 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.

Endpoints

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.

Parameters

text_to_image

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.

edit

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.

layer_decomposition

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.

REST and CLI

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"

Related

Notes

  • 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.

Releases

Packages

Used by

Contributors

Languages