img_uuid, then poll or use an HTTPS callback for the 2K result.Seedream 4.0 API for Image Generation
Access Seedream 4.0 through the independent GoEnhance Open API. Submit a text prompt alone or add up to 14 reference images, receive an
Create an API Key
Choose the Seedream 4.0 Input Mode
Text-to-Image from a Focused Prompt
Send a required prompt from 1 to 2,000 characters. Omit image_list for pure text-to-image generation.
Reference-Guided Image Generation
Add 1–14 public image URLs in image_list when your workflow needs image-to-image guidance.
One Asynchronous REST Workflow
Use one endpoint for both input modes. A successful submission returns a task identifier instead of blocking until the image is ready.
Validate request shape before submission and track every image as an asynchronous task.
Seedream 4.0 API Capabilities and Limits
Prompt validation
<code>prompt</code> is required and accepts 1–2,000 characters.
Seven documented aspect ratios
Set <code>ratio</code> to <code>1:1</code>, <code>4:3</code>, <code>3:4</code>, <code>16:9</code>, <code>9:16</code>, <code>3:2</code>, or <code>2:3</code>. Omit it to use the model default.
Optional reference images
Pass 1–14 objects in <code>image_list</code>, each containing a public image URL, or omit the field for text-to-image.
2K output
The documented Seedream 4.0 route returns generated images at 2K resolution.
Bearer authentication
Send your GoEnhance API key in the <code>Authorization</code> header and keep it out of client-side code and logs.
Polling or callback completion
Persist the returned <code>img_uuid</code>, then poll job detail or receive task-state updates at a public HTTPS callback URL.
The current GoEnhance API reference lists one token per Seedream 4.0 image.
Seedream API Pricing
$0.02 per generated image
GoEnhance lists Seedream 4.0 at 1 token per image, with 1 token equal to $0.02.
Simple request-level budgeting
Estimate cost as the number of submitted image tasks multiplied by $0.02; no per-second calculation is involved for this image endpoint.
Check current billing before production runs
Review the live GoEnhance billing page before large batches because account terms and platform pricing can change.
Integrate the Seedream 4.0 API
1
1. Create and protect an API key
Create a key at /keys and send it with the request. Do not expose it in browser code or public repositories.
2
2. Build and validate the request
Add the required prompt, choose an optional ratio, and include
image_list only when you have 1–14 accessible reference URLs. 3
3. Submit and persist img_uuid
POST to
https://api.goenhance.ai/api/v1/seedream-4-0. Save the returned img_uuid with your internal job record. 4
4. Poll or receive callbacks
Poll
GET https://api.goenhance.ai/api/v1/jobs/detail?img_uuid=..., or provide custom_callback_url for HTTPS state notifications. 5
5. Handle terminal results idempotently
Check both HTTP status and response
code/msg. Correct invalid requests before resubmitting, and prevent duplicate downstream processing.Connect prompt generation, references, async job tracking, storage, and human review in one image pipeline.
What Developers Build with Seedream 4.0
Product creative pipelines
Generate product-scene concepts from structured prompts and route selected outputs into review and campaign workflows.
Reference-guided brand exploration
Use approved reference images to guide composition or visual direction without building a separate image-editing endpoint.
Localized campaign variants
Programmatically adapt prompt details for markets, formats, and channels while keeping task tracking consistent.
Concept art and previsualization
Create 2K stills for mood exploration, storyboards, environment studies, and early creative decisions.
Pricing, inputs, ratios, output, job handling, and platform relationship.