Seedream V5.0 Pro Edit API
doubao/seedream-v5.0-pro/image-to-image
Seedream V5.0 Pro Edit by ByteDance edits and generates images from single-image or multi-reference inputs, supporting up to 10 reference images, aspect ratio selection, and 1K / 2K output tiers. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
Examples
Parameters
| Name | Type | Default | Constraints | Description |
|---|---|---|---|---|
| prompt *Prompt | textarea | — | ≤ 5000 chars | The positive prompt for the generation. |
| images *Images | image_upload | — | image/* · 1–10 items | The images to edit. A maximum of 10 reference images can be uploaded. |
| resolutionResolution | select | 1k | 1k | 2k | The output resolution tier used for billing. 1k is the lower-cost tier; 2k is the higher-cost tier. |
| aspect_ratioAspect Ratio | select | — | 1:1 | 1:2 | 2:1 | 1:3 | 3:1 | 2:3 | 3:2 | 3:4 | … | The aspect ratio of the generated image. Leave empty to automatically use the closest supported aspect ratio based on the first input image. |
| output_formatOutput Format | select | jpeg | jpeg | png | The format of the output image. |
API
Call this model through one unified REST API. Get a key on the API Keys page.
cURL
# 1) Submit — returns { "task_uuid": "..." }
curl -X POST "https://www.namifusion.com/api/v1/marketplace/run/doubao/seedream-v5.0-pro/image-to-image" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"input": {
"prompt": "Transform the input product photo into a polished premium e-commerce image with clean studio lighting, subtle realistic shadows, enhanced colors, sharper details, and a minimalist light gray background. Preserve the original product shape, materials, branding, and overall composition while improving clarity and visual appeal.",
"images": [
"https://kaito-1328216764.cos.ap-tokyo.myqcloud.com/uploads/images/2026-07-09/23c18ba5cb9d.png"
],
"resolution": "1k",
"aspect_ratio": "1:1",
"output_format": "jpeg"
}
}'
# 2) Poll until status is "completed", then read the output URLs
curl "https://www.namifusion.com/api/v1/marketplace/run/tasks/TASK_UUID" \
-H "Authorization: Bearer YOUR_API_KEY"Python
import time, requests
API_KEY = "YOUR_API_KEY"
HEADERS = {"Authorization": f"Bearer {API_KEY}"}
# 1) Submit
resp = requests.post(
"https://www.namifusion.com/api/v1/marketplace/run/doubao/seedream-v5.0-pro/image-to-image",
headers=HEADERS,
json={
"input": {
"prompt": "Transform the input product photo into a polished premium e-commerce image with clean studio lighting, subtle realistic shadows, enhanced colors, sharper details, and a minimalist light gray background. Preserve the original product shape, materials, branding, and overall composition while improving clarity and visual appeal.",
"images": [
"https://kaito-1328216764.cos.ap-tokyo.myqcloud.com/uploads/images/2026-07-09/23c18ba5cb9d.png"
],
"resolution": "1k",
"aspect_ratio": "1:1",
"output_format": "jpeg"
}
},
)
resp.raise_for_status() # 401/402/429/5xx stop here instead of polling a bad task
task = resp.json()
# 2) Poll until a terminal state (completed / failed / cancelled).
# This model is allowed up to 300s server-side.
deadline = time.time() + 360
while task.get("status") not in ("completed", "failed", "cancelled"):
if time.time() > deadline:
raise TimeoutError(f"still {task.get('status')} — keep the task_uuid and poll later")
time.sleep(3)
poll = requests.get(f"https://www.namifusion.com/api/v1/marketplace/run/tasks/{task['task_uuid']}", headers=HEADERS)
poll.raise_for_status()
task = poll.json()
print(task["status"], task.get("output"))JavaScript
const API_KEY = "YOUR_API_KEY";
const HEADERS = { Authorization: `Bearer ${API_KEY}` };
// 1) Submit
const resp = await fetch("https://www.namifusion.com/api/v1/marketplace/run/doubao/seedream-v5.0-pro/image-to-image", {
method: "POST",
headers: { ...HEADERS, "Content-Type": "application/json" },
body: JSON.stringify({
"input": {
"prompt": "Transform the input product photo into a polished premium e-commerce image with clean studio lighting, subtle realistic shadows, enhanced colors, sharper details, and a minimalist light gray background. Preserve the original product shape, materials, branding, and overall composition while improving clarity and visual appeal.",
"images": [
"https://kaito-1328216764.cos.ap-tokyo.myqcloud.com/uploads/images/2026-07-09/23c18ba5cb9d.png"
],
"resolution": "1k",
"aspect_ratio": "1:1",
"output_format": "jpeg"
}
}),
});
if (!resp.ok) throw new Error(`submit failed: ${resp.status} ${await resp.text()}`);
let task = await resp.json();
// 2) Poll until a terminal state (completed / failed / cancelled).
// This model is allowed up to 300s server-side.
const deadline = Date.now() + 360 * 1000;
while (!["completed", "failed", "cancelled"].includes(task.status)) {
if (Date.now() > deadline) throw new Error(`still ${task.status} — keep the task_uuid and poll later`);
await new Promise((r) => setTimeout(r, 3000));
const poll = await fetch(`https://www.namifusion.com/api/v1/marketplace/run/tasks/${task.task_uuid}`, { headers: HEADERS });
if (!poll.ok) throw new Error(`poll failed: ${poll.status}`);
task = await poll.json();
}
console.log(task.status, task.output);Documentation
Seedream V5.0 Pro Edit API
High-quality image editing from single or multi-reference inputs, with up to 10 reference images and 2K output.
Seedream V5.0 Pro Edit is ByteDance’s advanced image editing model for controlled generation from one or more reference images. It combines strong prompt adherence, flexible aspect ratio support, and production-ready performance with no cold starts, making it well suited for creative workflows, e-commerce pipelines, and iterative visual development.
🚀 Key Features
- Multi-reference image editing: Use up to 10 reference images for complex compositions, identity preservation, product detail control, and style guidance.
- Natural language editing: Describe what should change and what should remain intact using a simple prompt.
- Professional image quality: Designed for polished visual output with strong prompt following and reliable editing performance.
- Flexible aspect ratios: Supports square, portrait, landscape, tall, and wide formats for a broad range of publishing needs.
- 1K and 2K output tiers: Choose lower-cost 1K for fast iteration or 2K for higher-resolution final assets.
- No cold starts: Delivers a more consistent production experience for real-time and batch image workflows.
🛠️ Technical Specifications
| Item | Details |
|---|---|
| Model architecture | Image editing / multi-reference conditional image generation model |
| Task type | text-to-image(image-guided editing generation) |
| Input | Prompt + 1 to 10 reference images |
| Output | 1 edited image |
| Max reference images | 10 |
| Aspect Ratio | 1:1, 1:2, 2:1, 1:3, 3:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 9:21, 21:9 |
| Aspect Ratio behavior | If left empty, the model automatically uses the closest supported ratio based on the first input image |
| Resolution | 1k, 2k |
| Output Format | jpeg, png |
| Quality profile | Professional-grade image editing with multi-image guidance |
| Latency | No cold start; actual inference time varies by input complexity and output tier |
Sample Prompts
- Keep the subject’s facial features unchanged, replace the background with a modern minimalist cafe, natural lighting, realistic photography style.
- Use the reference product images to generate a clean e-commerce hero shot with a white background, consistent lighting, and premium material detail.
- Preserve the outfit design and colors, change the model pose to a side-standing position, optimized for a 9:16 poster composition.
💰 Pricing
| Item | Price |
|---|---|
| 1k output | $0.045 |
| 2k output | $0.090 |
| Additional reference image cost | $0.003 per extra input image |
Note: The first input image is included in the base price.
💡 Best Use Cases
- E-commerce image editing: Refine product shots, replace backgrounds, standardize presentation, and create campaign-ready assets.
- Brand and marketing creative: Generate polished visuals aligned with brand references and campaign direction.
- Character and identity consistency: Maintain subject identity, outfit details, mood, or style across multiple iterations.
- Social media content production: Create platform-ready visuals in different aspect ratios for ads, covers, and promotional posts.
🔗 Related Models
- Seedream V5.0 Pro: Best suited for text-to-image generation without reference image inputs.
- Seedream V5.0 Lite Edit: A lighter-weight image editing model for more cost- and speed-sensitive workflows.
Related models
xAI Grok Imagine Image v2.0 Edit
xAI Grok Imagine Image V2.0 Edit transforms input images with text prompts, with configurable resolution and quality for precise image editing, visual refinements, creative variations, social content, marketing assets, and production workflows. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
Qwen Image 3.0 Pro Edit | Fast Image Editing
Qwen Image 3.0 Pro Edit is a professional-grade image editing model with superior quality and advanced instruction understanding. Up to 2k. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
Head Swap (Image)
Swap the head in a photo with the head from a reference image. Upload the target photo first, then the head reference.
Nami Qwen I2I Spicy
Edit a reference image with natural-language instructions while preserving the parts you do not ask to change.
Nano Banana Image Edit
Fast & Affordable Editing. Intuitive object replacement and style transfer without manual masking.
Nano Banana Pro Image Edit
4K Semantic Editing.Modifies existing images via natural language with context awareness and multilingual text editing.
Nano Banana 2 Image Edit
4K Semantic Editing.Modifies existing images via natural language with context awareness and multilingual text editing.
Seedream 5.0 Lite Edit Sequential
Seedream 5.0 Lite Edit Sequential performs multi-image editing while locking character and object identity across shots. It detects main subjects, preserves continuity, and applies controlled edits with up to 4K output. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.