ByteDance Seedream V4 Edit
doubao/seedream-4.0/image-to-image
Seedream V4 Edit is ByteDance's state-of-the-art image editing model that outperforms Nano Banana in fidelity and edit quality. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
Examples
Parameters
| Name | Type | Default | Constraints | Description |
|---|---|---|---|---|
| images *Images | image_upload | — | image/* · 1–10 items | The images to edit. A maximum of 10 reference images can be uploaded. |
| prompt *Prompt | textarea | — | ≤ 5000 chars | The positive prompt for the generation. |
| sizeSize | text | — | ≤ 500 chars | The size of the generated media, supporting up to 4K resolution for images. If you need to match the size of an existing image, you must explicitly specify the dimensions, as automatic resizing to match the image is not supported. |
Output fields
| Field | Type | Description |
|---|---|---|
| images | array<string> | Generated image URLs |
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-4.0/image-to-image" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"input": {
"images": [
"https://assets-public.namifusion.com/uploads/images/2026-03-05/2ba652e30b82.png"
],
"prompt": "Transform the image into a surrealistic artwork with a dream-like atmosphere, incorporating elements of fantasy such as floating islands and mythical creatures.",
"size": "3840x2160"
}
}'
# 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-4.0/image-to-image",
headers=HEADERS,
json={
"input": {
"images": [
"https://assets-public.namifusion.com/uploads/images/2026-03-05/2ba652e30b82.png"
],
"prompt": "Transform the image into a surrealistic artwork with a dream-like atmosphere, incorporating elements of fantasy such as floating islands and mythical creatures.",
"size": "3840x2160"
}
},
)
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-4.0/image-to-image", {
method: "POST",
headers: { ...HEADERS, "Content-Type": "application/json" },
body: JSON.stringify({
"input": {
"images": [
"https://assets-public.namifusion.com/uploads/images/2026-03-05/2ba652e30b82.png"
],
"prompt": "Transform the image into a surrealistic artwork with a dream-like atmosphere, incorporating elements of fantasy such as floating islands and mythical creatures.",
"size": "3840x2160"
}
}),
});
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
ByteDance Seedream V4 Edit
State-of-the-Art Image Editing Model
ByteDance Seedream V4 Edit is a cutting-edge image-to-image model designed for precise and high-quality image edits. It surpasses competitors like Nano Banana in fidelity and edit quality, offering a ready-to-use REST inference API with no cold starts and competitive pricing.
🚀 Key Features
- High Fidelity Edits: Maintains reliable skin tones, fabric details, and fine edges for both people and products.
- Production-Friendly Consistency: Quickly generate multiple variants with consistent camera angles and brand color grading.
- Structured Prompt Support: Optimized for clear objectives, ensuring accurate and scalable edits.
- Versatile Image Editing: Capable of swapping outfits, adjusting hair and makeup, recoloring products, and replacing interior finishes while preserving the original composition.
🛠️ Technical Specifications
| Specification | Details |
|---|---|
| Model Architecture | Image-to-Image |
| Input Format | Array of Images (up to 10) |
| Output Format | Edited Image |
| Resolution | Up to 8192x8192 (4K supported) |
| Sample Prompt | "Change outfit to {OUTFIT_DESC}, keep pose" |
💰 Pricing
| Resolution | Price per Image |
|---|---|
| Any | $0.03 |
💡 Best Use Cases
- Portrait & Influencer Workflows: Ideal for outfit, makeup, and hair changes, creating branded series and campaign variants.
- E-commerce & Product Teams: Perfect for colorway adjustments, material swaps, and packaging updates.
- Interior Design & Architecture Visualization: Suitable for wall and floor finish replacements, and lighting-aware set dressing.
- Marketing & Growth: Enables fast A/B testing with consistent brand color and camera setup.
🔗 Related Models
- ByteDance Seedream V4: Explore other versions for different editing capabilities.
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 V5.0 Pro Edit API
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.