Image Official partner

Seedream 4 API

ByteDance's unified image generation and editing model (Sep 2025), built for ultra-fast output, strong bilingual text rendering, and generating consistent sets of images at once.

Get API key Read the docs

~12s
Avg. generation: 4 credits
From

Seedream 4 concert poster reading 'THE SOUND OF FRACTALS' with a shattered glass sphere refracting rainbow light

Playground

Try Seedream 4 right here.

model: seedream-4

Prompt

Aspect ratio

Media inputs

Reference image

Advanced settings

Output format Guidance Pre-LLM Pre-process the prompt with an LLM. Enhance prompt Seed

Estimated cost 4 credits · $0.04 Generate in Studio

Output

Your output lands here. Hit generate to run this request in Studio.

Pricing

Simple per-generation pricing.

4 credits per generation ≈ $0.04

You only pay for successful generations. Failed jobs are refunded automatically.
One credit balance across every model on Apiframe, no per-model plans.
Start with free credits. No subscription required.
Volume discounts on larger plans.

See plans and credit packs

Specs

At a glance.

Provider ByteDance

Model ID seedream-4

Aspect ratios 1:1, 3:4, 4:3, 9:16, 16:9

Image input Supported

Avg. time ~12s

Quickstart

How to call the Seedream 4 API.

Send one POST /v2/images/generate request with your API key. The call returns a jobId you can poll, or pass a webhook_url and the result is pushed to you the moment it's ready.

Swap seedream-4 for any other model and nothing else changes.

Get API key Read the docs

generate.js

const response = await fetch("https://api.apiframe.ai/v2/images/generate", {
  method: "POST",
  headers: {
    "X-API-Key": "afk_your_api_key_here",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "prompt": "a sleek silver sports car on a coastal highway at sunset, hyper-realistic",
    "model": "seedream-4",
    "seedreamParams": {
      "image_input": "https://example.com/input.jpg",
      "output_format": "jpg",
      "guidance_scale": 3,
      "use_pre_llm": false
    }
  }),
});
const { jobId } = await response.json();
console.log(jobId);

import requests

response = requests.post(
    "https://api.apiframe.ai/v2/images/generate",
    headers={
        "X-API-Key": "afk_your_api_key_here",
        "Content-Type": "application/json",
    },
    json={
        "prompt": "a sleek silver sports car on a coastal highway at sunset, hyper-realistic",
        "model": "seedream-4",
        "seedreamParams": {
            "image_input": "https://example.com/input.jpg",
            "output_format": "jpg",
            "guidance_scale": 3,
            "use_pre_llm": False
        }
    },
)
print(response.json())  # { "jobId": "...", "status": "QUEUED" }

curl -X POST https://api.apiframe.ai/v2/images/generate \
  -H "X-API-Key: afk_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
        "prompt": "a sleek silver sports car on a coastal highway at sunset, hyper-realistic",
        "model": "seedream-4",
        "seedreamParams": {
            "image_input": "https://example.com/input.jpg",
            "output_format": "jpg",
            "guidance_scale": 3,
            "use_pre_llm": false
        }
    }'

let job;
do {
  await new Promise((r) => setTimeout(r, 2000));
  job = await fetch("https://api.apiframe.ai/v2/jobs/JOB_ID", {
    headers: { "X-API-Key": "afk_your_api_key_here" },
  }).then((r) => r.json());
} while (job.status !== "COMPLETED" && job.status !== "FAILED");
console.log(job.result);

import requests, time

while True:
    job = requests.get(
        "https://api.apiframe.ai/v2/jobs/JOB_ID",
        headers={"X-API-Key": "afk_your_api_key_here"},
    ).json()
    if job["status"] in ("COMPLETED", "FAILED"):
        break
    time.sleep(2)
print(job["result"])

curl https://api.apiframe.ai/v2/jobs/JOB_ID \
  -H "X-API-Key: afk_your_api_key_here"

Input schema

Every field Seedream 4 accepts, with types and defaults. The full reference lives in the docs.

Field	Type	Description
prompt required	string	Text description of what to generate.
model required	string	The model identifier for this endpoint. Default:"seedream-4" · "seedream-4"
seedreamParams.image_input	string (URL)	Reference image (URL)
seedreamParams.output_format	string	Output format Default:"jpg" · "jpg", "png"
seedreamParams.guidance_scale	number	Guidance Default:3 · min 1, max 10, step 0.5
seedreamParams.use_pre_llm	boolean	Pre-process the prompt with an LLM. Default:false
seedreamParams.enhance_prompt	boolean	Enhance prompt Default:false
seedreamParams.seed	number	Reuse a number to reproduce the same result. step 1