Seedream 4.0

ByteDance's Seedream 4.0. Low-cost AI image generation and editing, 2K by default.

POST/v1/media/queue

from $0.06/image

Overview

ByteDance's Seedream 4.0 — the earlier Seedream generation and the lowest-priced in the family, for text-to-image and reference-image editing at 1K to 4K (2K by default). Async operation — submit a job, poll for completion.

Property	Value
Model ID	`bytedance-seed/seedream-4.0`
Provider	ByteDance
Alias	`seedream-4`, `seedream-4-0`
Aspect Ratios	1:1, 4:3, 3:4, 16:9, 9:16, 3:2, 2:3, 21:9
Resolutions	1K, 2K (default), 3K, 4K
Output Formats	jpeg
Reference Images	Supported
Billing	Flat $0.06 per image
Typical Cost	$0.06 per image

Usage

All media models use the async job queue. Submit a job, then poll for the result.

Step 1: Submit Job

Text-to-Image

const res = await fetch('https://api.yepapi.com/v1/media/queue', {
  method: 'POST',
  headers: {
    'x-api-key': 'YOUR_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    model: 'bytedance-seed/seedream-4.0',
    prompt: 'A flat-lay product photo of a ceramic coffee cup and a croissant on a marble table',
    options: { aspectRatio: '1:1' },
  }),
});
const { data } = await res.json();
// data.jobId — use this to poll for results

curl -X POST https://api.yepapi.com/v1/media/queue \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "bytedance-seed/seedream-4.0", "prompt": "A flat-lay product photo of a ceramic coffee cup and a croissant on a marble table", "options": {"aspectRatio": "1:1"}}'

Image-to-Image (Edit / Transform)

Pass a reference image via imageData alongside your prompt to edit or transform an existing image.

const res = await fetch('https://api.yepapi.com/v1/media/queue', {
  method: 'POST',
  headers: {
    'x-api-key': 'YOUR_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    model: 'bytedance-seed/seedream-4.0',
    prompt: 'Make the sky purple and add northern lights',
    options: { aspectRatio: '1:1' },
    imageData: {
      mimeType: 'image/png',
      base64: '...', // Base64-encoded image
    },
  }),
});

Step 2: Poll for Result

const status = await fetch(`https://api.yepapi.com/v1/media/status/${data.jobId}`, {
  headers: { 'x-api-key': 'YOUR_API_KEY' },
});
const { data: job } = await status.json();
// job.status — "pending" | "processing" | "completed" | "failed"
// job.result.image — { mimeType, base64 } when completed

curl https://api.yepapi.com/v1/media/status/JOB_ID \
  -H "x-api-key: YOUR_API_KEY"

Request Body

Parameter	Type	Required	Description	Default
`model`	`string`	Yes	`bytedance-seed/seedream-4.0` or aliases `seedream-4`, `seedream-4-0`	—
`prompt`	`string`	Yes	Text description of the image to generate or edit	—
`options.aspectRatio`	`string`	No	One of: 1:1, 4:3, 3:4, 16:9, 9:16, 3:2, 2:3, 21:9	`1:1`
`options.resolution`	`string`	No	`1K`, `2K`, `3K` or `4K`	`2K`
`imageData.mimeType`	`string`	No	MIME type of input image (image/png, image/jpeg, image/webp)	—
`imageData.base64`	`string`	No	Base64-encoded input image for image-to-image editing	—

Pricing

Billing is flat: $0.06 per image at any supported resolution.

Metric	Cost
Cost per image	$0.06

Info

Image jobs typically complete in 5–60 seconds. Results retained for 1 hour.

Under the Hood

Seedream 4.0

On this page