Seedream 4 API
Seedream 4 is ByteDance Seed's image model that unifies generation and editing, prioritizes reference consistency, and supports up to 4K output.
A beautiful landscape with mountains and a lake, golden hour lighting, photorealistic style

Upload reference images
Click to upload or drag and drop
Supported formats: JPG, JPEG, PNG, WEBP
Maximum file size: 10MB; Maximum files: 10

History
Max 20 items0 running · 0 completed
Seedream 4 API for high‑consistency image generation and editing
Seedream 4 is a next‑generation image creation model from ByteDance’s Seed team that unifies image generation and editing in a single architecture. It emphasizes reference consistency and can produce high‑definition images up to 4K.

What can you build with Seedream 4 API?
Batch image generation for campaigns
Generate multiple variants in one request using the `n` parameter (1–15). This is ideal for ad sets, hero images, and product variants where you want controlled diversity without rebuilding prompts for each version.

Multi-reference image editing
Upload multiple reference images via `image_urls` to guide image-to-image edits and preserve key identity elements such as logos, materials, or subjects. This is useful for product catalogs, brand assets, and batch edits.

Resolution control for production output
Seedream 4 API supports simplified sizing (1K/2K/4K) and explicit pixel sizes within the documented range. Use this to match ad specs, landing pages, and marketplace requirements without manual resizing.

Why developers choose Seedream 4 API
A unified, async image API that balances batch productivity, reference-guided consistency, and predictable sizing.
Unified generation and editing
Run text-to-image, image-to-image, and image editing through one endpoint and the same authentication flow.
Reference‑guided consistency
Use multi-reference inputs to keep identity, branding, or composition stable across outputs and variations.
Async workflows built for scale
Tasks return a task ID and can trigger a callback URL when complete, enabling reliable pipelines and queue-based processing.
How to integrate Seedream 4 API
A simple, async workflow designed for production automation.
Step 1 — Create an API key
Generate your evolink.ai API key in the dashboard and use Bearer token authentication for all requests.
Step 2 — Call /v1/images/generations
Send `model: "doubao-seedream-4.0"`, your prompt, and optional parameters such as `n`, `size`, `image_urls`, `prompt_priority`, and `callback_url`.
Step 3 — Retrieve results
Poll the task status endpoint or receive a webhook callback. Save returned image URLs promptly (links are valid for 24 hours).
Seedream 4 API capabilities
Documented behavior and limits that matter for production teams.
Text-to-image + image-to-image
One endpoint supports generation from text and edits based on reference images.
Batch outputs up to 15
Use `n` to request multiple candidates per call, with total reference + output images capped at 15.
Multi-reference inputs
Provide up to 14 reference images via `image_urls` to guide edits and preserve identity.
Flexible sizing
Pick simplified sizes (1K/2K/4K) or explicit pixel dimensions within the supported range.
Async task workflow
Each request creates a task ID, enabling queue-based processing and optional callbacks.
Broad input formats
Reference images can use common formats like JPG, PNG, WebP, BMP, TIFF, and GIF.
Seedream 4 FAQs
Everything you need to know about the product and billing.
API Reference
Select endpoint
Authentication
All APIs require Bearer Token authentication.
Authorization:
Bearer YOUR_API_KEY/v1/images/generationsGenerate Image
Create an image generation task using text prompts or reference images. Supports text-to-image, image-to-image, and image editing modes.
Asynchronous processing mode, use the returned task ID to .
Generated image links are valid for 24 hours, please save them promptly.
Request Parameters
modelstringRequiredDefault: doubao-seedream-4.0Image generation model name.
doubao-seedream-4.0promptstringRequiredPrompt describing the image to be generated or how to edit the input image.
Notes
- Limited to 2000 tokens
A cat playing in the grasssizestringOptionalSize of generated images. Supports simplified format or pixel format.
| Value | Description |
|---|---|
| 1K | Standard quality |
| 2K | High quality |
| 4K | Ultra quality |
Notes
- Pixel format: 1280x720 to 4096x4096
- Aspect ratio range: [1/16, 16]
2048x2048nintegerOptionalDefault: 1Number of images to generate.
| Value | Description |
|---|---|
| 1-15 | Batch generation supported |
1image_urlsarrayOptionalReference image URL list for image-to-image and image editing functions.
Notes
- Max 10 images per request
- Max size: 10MB per image
- Formats: .jpeg, .jpg, .png
- Aspect ratio range: [1/3, 3]
- Total pixels: ≤6000×6000
- URLs must be directly accessible by the server
https://example.com/image1.pngprompt_priorityenum<string>OptionalDefault: standardPrompt optimization strategy for setting the prompt optimization mode.
| Value | Description |
|---|---|
| standard | Standard mode, higher quality, slower |
| fast | Fast mode, faster speed, normal quality |
standardcallback_urlstringOptionalHTTPS callback address after task completion.
Notes
- Triggered on completion, failure, or cancellation
- Sent after billing confirmation
- HTTPS only, no internal IPs
- Max length: 2048 chars
- Timeout: 10s, Max 3 retries
https://your-domain.com/webhooks/image-task-completed