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/edit

This model has other modes with their own ids: bytedance/seedream/v4/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/v4/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/v4/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/v4/edit
NameTypeDescription
promptrequiredstring
The text prompt used to edit the image
image_sizeenum
The size of the generated image. The minimum total image area is 921600 pixels. Failing this, the image size will be adjusted to by scaling it up, while maintaining the aspect ratio.

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`. The total number of images (image inputs + image outputs) must not exceed 15

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

image_urlsrequiredarray of image URLs
List of URLs of input images for editing. Presently, up to 10 image inputs are allowed. If over 10 images are sent, only the last 10 will be 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

  • 1 image$0.05/ image

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