Text to image
Create original campaign, editorial, or concept images from a written brief.
All API models
ImageByteDancePlanned
MODEL API
Seedream 4.0 API
Seedream 4.0 image generation covering text-to-image and editing for production visuals.
- Text to image
- Image editing
- Multi-reference
- High resolution
This route is published for integration planning and is not accepting requests yet.
LIVE REQUEST BUILDER
Try the API in the playground
Configure a request, inspect the exact JSON, then run it with your account.
Playground opens when this route becomes available.
Response
The API response will appear here.
API PRICING
Programmatic pricing, separate from Studio
Compare the complete API billing table for this route. Token models separate input, output, cache-read, cache-write, and long-context rates; media models vary by configuration.
Pricing coming soon
CAPABILITIES
What this route supports
Use one stable PixMind model ID while keeping provider-specific setup out of your application.
Image editing
Revise an existing image with direct natural-language instructions.
Multi-reference
Carry subjects, products, or visual direction across reference-led outputs.
High resolution
Produce larger delivery assets without adding a separate upscaling step.
TECHNICAL SPECS
Supported parameters
Resolution, aspect ratios, and inputs the Seedream 4.0 API route accepts.
- Resolution tiers
- 1K · 2K · 4K
- Aspect ratios
- 1:1 · 16:9 · 9:16 · 4:3 · 3:4 · 3:2 · 2:3 · 5:6 · 6:5 · 2:1
- Reference images
- 10 images
- Images per request
- 10
- Prompt length
- 20,000 characters
- Reference formats
- JPEG · JPG · PNG
MODEL WORKFLOWS
What to build with Seedream 4.0
Choose a task that matches the live route capabilities, then adapt one of these prompt starters.
Best-fit tasks
- Create original campaign, editorial, or concept images from a written brief.
- Revise an existing image with direct natural-language instructions.
- Carry subjects, products, or visual direction across reference-led outputs.
- Produce larger delivery assets without adding a separate upscaling step.
Prompt starters
Replace the bracketsStarter
Use the reference images to keep [person/product] consistent. Create a coordinated [number]-image campaign across [scenes] in one visual direction.
Starter
Using the supplied image, change only [target element] to [requested change]. Preserve the subject, composition, lighting, and all other details.
Starter
Create a premium product hero image for [product], [camera angle], [lighting], [background], [brand palette], clean commercial composition.
MODEL SELECTION
Choose Seedream 4.0 when the job fits
Compare nearby live routes by task, supported capability, and current entry price before you lock a model ID into production.
| Model | Best for | Key capabilities | Entry price | Availability | Action |
|---|---|---|---|---|---|
Seedream 4.0 ByteDance · current page | Create original campaign, editorial, or concept images from a written brief. | Text to image · Image editing · Multi-reference | Pricing coming soon | Planned | Selected |
Seedream 4.5 ByteDance | Create original campaign, editorial, or concept images from a written brief. | Text to image · Image editing · Multi-reference | Pricing coming soon | Planned | View route |
Seedream 5.0 ByteDance | Create original campaign, editorial, or concept images from a written brief. | Text to image · Image editing · Multi-reference | Pricing coming soon | Planned | View route |
Seedream 5.0 Pro ByteDance | Create original campaign, editorial, or concept images from a written brief. | Text to image · Image editing · Multi-reference | $0.060 / image | Available | View route |
Capabilities and starting prices are a current PixMind route snapshot. The accepted request contains the final configuration and billing quote.
GET STARTED
From playground to production
Create a scoped key
Create an API key for the image or video permission this route needs.
Send the request
Use the model ID and endpoint shown above from your backend service.
Track the task
Store the returned task ID and query its status until it reaches a terminal state.
FAQ
Seedream 4.0 API questions
What model ID should I use for the Seedream 4.0 API?+
Use seedream-4.0 in the model field. This is the stable PixMind route identifier shown in the playground request JSON.
Which endpoint does the Seedream 4.0 API use?+
Send POST requests to /v1/generations. Keep your API key on your server and pass it as a Bearer token.
Is the playground using a real API request?+
Yes. When you click Run model, PixMind forwards the displayed payload with the API key you entered. A successful request may create a paid task.
Does PixMind save the API key entered here?+
No. The playground keeps the key only in component memory and sends it for the current request; it is not written to browser storage.
Is API pricing the same as PixMind Studio pricing?+
No. API usage resolves through the apiPlatform pricing role and a separate pay-as-you-go ledger. Studio pricing includes the creation interface and product workflow services.
Why can the final price differ from the starting price?+
The entry price reflects the configuration displayed on this page. Resolution, duration, quality, audio, references, and output count can affect the final task price.
How do I receive a finished image or video?+
Generation routes can return an asynchronous task. Save its ID and query the task endpoint until the status is succeeded, failed, or cancelled.
Can I use the same integration for other PixMind models?+
Yes. Models in the same workload family share the generation contract, so switching usually means changing the model ID and supported parameters.
RELATED MODELS
Compare other API routes
ByteDance
Seedream 4.5
Seedream 4.5 balanced image generation with reliable quality for everyday creative work.
View APIByteDance
Seedream 5.0
ByteDance Seedream 5.0 commercial-grade image generation with strong composition and detail.
View APIByteDance
Seedream 5.0 Pro
Commercial-grade visuals with strong composition, detail, reference consistency, and high-resolution output.
View APISTART WITH THE CONTROL PLANE
Turn your first Seedream 4.0 prompt into a real API request
Test the exact payload in the playground, then create a scoped key and move the same model ID into your application.