Model API

Seedream 4

A new-generation image creation model ByteDance, Seedream 4.0 integrates image generation and image editing capabilities into a single, unified architecture.

Model id

Use this in every request
bytedance/seedream/v4/text-to-image

This model has other modes with their own ids: bytedance/seedream/v4/edit.

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/v4/text-to-image",
  "input": {
    "prompt": "A red ceramic cup on a wooden table, soft morning light"
  }
}'

# 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/v4/text-to-image", "quote_id": "QUOTE_ID", "input": {"prompt":"A red ceramic cup on a wooden table, soft morning light"}}'

# 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/v4/text-to-image
NameTypeDescription
promptrequiredstring
The text prompt used to generate the image
image_sizeenum
The size of the generated image. Total pixels must be between 960x960 and 4096x4096.

Default: {"width":2048,"height":2048}

One of: {"width":2048,"height":2048}, square_hd, square, portrait_4_3, portrait_16_9, landscape_4_3, landscape_16_9, auto, auto_2K, auto_4K

num_imagesinteger
Number of separate model generations to be run with the prompt.

Default: 1

max_imagesnumber (enum)
If set to a number greater than one, enables multi-image generation. The model will potentially return up to `max_images` images every generation, and in total, `num_images` generations will be carried out. In total, the number of images generated will be between `num_images` and `max_images*num_images`.

Default: 1

One of: 1

seedinteger
Random seed to control the stochasticity of image generation.
sync_modeboolean
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

enhance_prompt_modestring (enum)
The mode to use for enhancing prompt enhancement. Standard mode provides higher quality results but takes longer to generate. Fast mode provides average quality results but takes less time to generate.

Default: standard

One of: standard, fast

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

  • 1 image$0.05/ image

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