Seedream 4 API
imageImage generation by bytedance
Unified generation and editing, knowledge-based visuals.
Call Seedream 4 from Node.js, Python, or any HTTP client. No GPU provisioning, no cold starts, no Docker images — just an API key and a prompt.
Pay per request. Powering 1M+ generations daily.
Start in 60 seconds
Install the official SDK for Node.js or Python, drop in your API key, and generate your first image.
npm install getimg-ai
import GetimgAI from "getimg-ai";
const client = new GetimgAI();
const result = await client.images.generate({
model: "seedream-4",
prompt: "3D saturn figure made out of tiny dust-like voxels, looking to the left, smoothly desintegrating into background, medium portrait shot, purple monochrome",
aspect_ratio: "1:1",
resolution: "1K",
output_format: "jpeg"
});
console.log(result.data[0].url);How Seedream 4 API works
Send a prompt, get an image URL back — one synchronous call.
Get your API key
Create a key in the Developer Dashboard. Add credit and start calling — you are billed per request.
Send a request
POST to /v2/images/generations with your prompt and output format.
Get your image
The response includes the image URL plus a usage object with the exact cost.
What you can build with Seedream 4
Every example uses the same authentication and works with the official getimg-ai and getimg SDKs, or plain HTTP.
Text to image
Generate an image using just a text prompt.
import GetimgAI from "getimg-ai";
const client = new GetimgAI();
const result = await client.images.generate({
model: "seedream-4",
prompt: "3D saturn figure made out of tiny dust-like voxels, looking to the left, smoothly desintegrating into background, medium portrait shot, purple monochrome",
aspect_ratio: "1:1",
resolution: "1K",
output_format: "jpeg"
});
console.log(result.data[0].url);Image editing
Edit or restyle an existing image with an instruction-based prompt.
import GetimgAI from "getimg-ai";
const client = new GetimgAI();
const result = await client.images.generate({
model: "seedream-4",
prompt: "Restyle the subject in warm cinematic studio lighting.",
aspect_ratio: "1:1",
resolution: "1K",
output_format: "jpeg",
images: [
{
url: "https://your-bucket.s3.amazonaws.com/source.png"
}
]
});
console.log(result.data[0].url);Multi-reference generation
Combine up to 10 reference images for character consistency, style, or composition guidance.
import GetimgAI from "getimg-ai";
const client = new GetimgAI();
const result = await client.images.generate({
model: "seedream-4",
prompt: "A product hero shot blending the style of the reference images.",
aspect_ratio: "1:1",
resolution: "1K",
output_format: "jpeg",
images: [
{
url: "https://your-bucket.s3.amazonaws.com/reference-1.png"
},
{
url: "https://your-bucket.s3.amazonaws.com/reference-2.png"
}
]
});
console.log(result.data[0].url);Seedream 4 pricing
Pay per image. No subscriptions, no minimums, no idle GPU costs.
Seedream 4
$0.03 /image
/v2/images/generationsUnified generation and editing, knowledge-based visuals.
| Resolution | Price | Images for $10 |
|---|---|---|
| 4K | $0.03 /image | 333 |
| 2K | $0.03 /image | 333 |
| 1K | $0.03 /image | 333 |
More from bytedance
Other bytedance models available through the same API.
Seedream 5.0 Pro
High-precision Seedream image generation with text, single-image, and multi-reference guidance.
Seedream 5.0 Lite
Unified multimodal image model with deep reasoning and online search, delivering strong prompt alignment and precise generation/editing control.
Seedance 1.5 Pro
Cinematic camera control, dynamic scenes, expressive characters.
Seedream 4.5
Studio-quality lighting, fast generation, good for commercial photography.
Seedance 1.0 Pro Fast
Quick generation, balanced quality and speed.
Seedream 4 API — frequently asked questions
How do I use the Seedream 4 API?
Install the official Node.js (npm install getimg-ai) or Python (pip install getimg) SDK, or call the endpoint directly over HTTP from any client.
Make a POST request to /v2/images/generations with your API key and a JSON body containing the model ID (seedream-4) and a prompt. The response includes the generated image URL.
See the API documentation for the full parameter reference.
Which SDK should I use?
Use getimg-ai for Node.js and TypeScript projects, and getimg for Python. Both wrap the same REST API with typed inputs, retries, and built-in polling for video generations.
For other languages — Go, Rust, Java, Ruby, PHP — call the HTTP endpoints directly. Every example on this page includes a cURL snippet you can port to any HTTP client.
What resolutions does Seedream 4 support?
Seedream 4 supports the following resolutions: 1K, 2K, 4K across 8 aspect ratios (1:1, 2:3, 3:2, 4:3, 3:4, 16:9, 9:16, 21:9).
How much does Seedream 4 cost?
Seedream 4 uses pay-per-image pricing with no subscriptions or minimum commitments. Rates vary by resolution. See the pricing table above for exact rates per image.
Does Seedream 4 support reference images?
Yes. Seedream 4 accepts up to 10 reference images. Reference images guide the generation toward a specific style, composition, or subject. See the example above.
Start building with Seedream 4
Grab an API key, install the SDK, ship image generation today.
Looking for other models? View all available models