Model API

Seedream 5 Pro

Seedream 5.0 Pro is grounded, region-precise image editing model that changes one element while keeping the rest of the frame intact with layer separation, sketch completion, and up to 10 reference images.

Model id

Use this in every request

bytedance/seedream/v5/pro/edit

This model has other modes with their own ids: bytedance/seedream/v5/pro/text-to-image.

Run it

Quote the input, start the generation with the quote, then poll the job. Set RAYWAKE_API_KEY first; see Authentication.

# 1. Price the exact input (quotes are valid for up to 10 minutes)
curl -s https://api.raywake.com/v1/quotes \
  -H "Authorization: Bearer $RAYWAKE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "bytedance/seedream/v5/pro/edit",
  "input": {
    "prompt": "A red ceramic cup on a wooden table, soft morning light",
    "image_urls": [
      "https://example.com/input.png"
    ]
  }
}'

# 2. Start the generation with the quote_id from step 1
curl -s https://api.raywake.com/v1/generate \
  -H "Authorization: Bearer $RAYWAKE_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"model": "bytedance/seedream/v5/pro/edit", "quote_id": "QUOTE_ID", "input": {"prompt":"A red ceramic cup on a wooden table, soft morning light","image_urls":["https://example.com/input.png"]}}'

# 3. Poll until the status is terminal
curl -s https://api.raywake.com/v1/jobs/JOB_ID \
  -H "Authorization: Bearer $RAYWAKE_API_KEY"

Input

Input fields for bytedance/seedream/v5/pro/edit
Name	Type	Description
`prompt`required	string	The text prompt used to edit the image.
`image_size`	string (enum)	The size of the generated image. Total pixels must be between 921600 and 4624220, with aspect ratio between 1/16 and 16. Default: `auto_2K` One of: `square_hd`, `square`, `portrait_4_3`, `portrait_16_9`, `landscape_4_3`, `landscape_16_9`, `auto_1K`, `auto_1.5K`, `auto_2K`
`num_images`	integer	Number of separate model generations to run with the prompt. Default: `1`
`output_format`	string (enum)	The file format of the generated image. Default: `jpeg` One of: `jpeg`, `png`
`watermark`	boolean	Whether to add the provider's visible watermark. Default: `false`
`sync_mode`	boolean	If `True`, the media will be returned as a data URI and the output data won't be available in the request history. Default: `false`
`background`	string (enum)	Use `transparent` with exactly one alpha-channel reference and PNG output to preserve transparency. Default: `opaque` One of: `opaque`
`enhance_prompt_mode`	string (enum)	Prompt optimization mode. `standard` prioritizes image quality; `fast` reduces generation time. Default: `standard` One of: `standard`, `fast`
`image_urls`required	array of image URLs	List of URLs of input reference images. Up to 10 images are supported; if more are sent, only the last 10 are used.

Output

A succeeded job lists its results under outputs, stored on our side. See Jobs for every field.

Job excerpt

"outputs": [
  { "type": "image", "url": "https://…", "mime_type": "image/png", "thumbnail_url": "https://…" }
]

Pricing

up to, default options$0.32/ run

The exact charge for your input comes from a quote. How charges settle