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

Seedream V5.0 Pro Edit API Examples 1

Parameters

NameTypeDefaultConstraintsDescription
prompt *Prompttextarea—≤ 5000 charsThe positive prompt for the generation.
images *Imagesimage_upload—image/* · 1–10 itemsThe images to edit. A maximum of 10 reference images can be uploaded.
resolutionResolutionselect1k1k | 2kThe output resolution tier used for billing. 1k is the lower-cost tier; 2k is the higher-cost tier.
aspect_ratioAspect Ratioselect—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 Formatselectjpegjpeg | pngThe format of the output image.

Output fields

FieldTypeDescription
imagesarray<string>Generated image URL(s).

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

ItemDetails
Model architectureImage editing / multi-reference conditional image generation model
Task typetext-to-image(image-guided editing generation)
InputPrompt + 1 to 10 reference images
Output1 edited image
Max reference images10
Aspect Ratio1: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 behaviorIf left empty, the model automatically uses the closest supported ratio based on the first input image
Resolution1k, 2k
Output Formatjpeg, png
Quality profileProfessional-grade image editing with multi-image guidance
LatencyNo 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

ItemPrice
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
Image to ImageX Ai

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.

from $0.090 / per run
qwen-image-edit-spicy
Image to Image

qwen-image-edit-spicy

Precisely edit images with text instructions. Add, remove, or modify visual elements, transfer styles, and replace backgrounds for photo retouching and visual design.

from $0.034 / per run
Qwen Image 3.0 Pro Edit | Fast Image Editing
Image to ImageQwen Image 3.0 Pro

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.

from $0.0663 / per run
OpenAI GPT Image 2.5 Sunburst Edit
Image to ImageOpenAI

OpenAI GPT Image 2.5 Sunburst Edit

High-fidelity image editing for precise transformations using up to 16 reference images.

from $0.220 / per run
OpenAI GPT Image 2.5 Flare Edit
Image to ImageOpenAI

OpenAI GPT Image 2.5 Flare Edit

Fast, balanced image editing from natural-language instructions and up to 16 reference images.

from $0.220 / per run
Image to Image
Image to ImageNamiFusion

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.

from $0.220 / per run
Nano Banana Image Edit
Image to ImageGoogle

Nano Banana Image Edit

Fast & Affordable Editing. Intuitive object replacement and style transfer without manual masking.

from $0.038 / per run
Nano Banana Pro Image Edit
Image to ImageGoogle

Nano Banana Pro Image Edit

4K Semantic Editing.Modifies existing images via natural language with context awareness and multilingual text editing.

from $0.140 / per run