Seedream 5.0 Pro API

Introduction

Seedream 5.0 Pro Image Editing changes a supplied image according to a written instruction. Use it to replace a material, revise text or combine visual references while using an existing picture as the basis of the result.

ByteDance introduced the model in its July 8, 2026 launch article. In this mode, the brief should distinguish the requested change from the elements you want retained.

Choose a Seedream 5.0 Pro mode by starting material

Key features

Information-rich image design

Its layout capabilities address infographics, posters and other designs where the organization of information matters as much as the image itself.

Localized editing and spatial understanding

The model can interpret where a change belongs and which object it concerns. This supports regional replacements, color and material changes, and sketch-guided edits without requiring a new visual brief for the whole composition.

Photographic materials and lighting

Image creation emphasizes surface texture, reflections, lighting and portrait detail. These capabilities serve both photographic treatments and rendered scenes, with attention to how materials interact with the surrounding light.

Multilingual visual content

The model supports multilingual prompts and text rendering, including languages with different scripts and reading directions. This enables localized graphics with language-specific copy and typography.

Multi-image composition

Separate images can supply subjects, materials, style or layout for a combined result. Layer separation is available as its own endpoint, Seedream 5.0 Pro Layer Decomposition; ordinary image generation and editing do not export layers.

Request parameters

Pricing

Prices are in credits, the same credits you use on the website (1 credit = $0.01). The hold is taken when the task is accepted and settled to the actual charge when it finishes; failed tasks are refunded.

Each task is rounded up to whole credits, so one run at the lowest tier costs 6 credits per image ($0.06).

For an exact number before you run, send the same body to POST /jobs/quote.

Use cases

Explore finishes on a photographed product

Use an authorized product photo as the base and a finish swatch as a reference. Ask to change the surface without redesigning the object. Review silhouette, hardware, reflections and printed details.

Update a campaign graphic without starting over

Upload the existing design and supply a new headline or event line. Specify which text to replace and which visual elements to retain. Check for accidental changes outside the text area.

Assemble a scene from separate visual assets

Provide a base scene and an object reference, then describe placement, scale and lighting. Review contact shadows and boundaries so the added object belongs visually in the scene.

Prompt guide & pro tips

How to make a localized edit in Seedream 5.0 Pro

Identify the source image, locate the target, describe the change and state what should remain. With multiple images, assign each a role rather than letting the model guess which is the base.

1. Put the base photograph first in image_urls.
2. Add a material or appearance reference only if it helps define the change.
3. Name the exact object or region to modify.
4. Describe the replacement and the surrounding details to preserve.

For a desk-lamp photograph and a brushed-metal swatch:

Image 1 is the base photograph. Image 2 supplies only the brushed-metal finish.
Change the outer surface of the desk lamp's shade in image 1 to that finish.
Keep the shade's shape, lamp stem, switch, cable and desk arrangement unchanged.
Match the new surface to the direction and softness of the existing window light.
Do not transfer the swatch's background or add new objects.

How to identify a region when words are ambiguous

In the outlined area of image 1, change only the small lamp's shade to matte terracotta.
Keep the larger lamp, desk and wall unchanged.
Remove the outline from the finished image and retain the original composition.

The outline is part of the prepared input image, not a separate API mask parameter. Check that guide marks have disappeared and that adjacent objects remain intact.

How to replace text without redesigning the graphic

Name the text to replace, provide the new wording in quotation marks, and state the layout and styling to retain.

For a translation, provide the approved translated copy. Allow enough space for a longer line instead of asking the model to squeeze a different language into an unchanged word shape.

Review the changed region and its edges

Compare the replacement's perspective, texture and lighting with the source. If the wrong object changes, tighten the target description or mark the region. If a reference contributes unwanted surroundings, narrow its role to the specific color, material or subject you intended to borrow.

API quick start

Call the Seedream 5.0 Pro API in three steps

1. Create an API key. Sign in to PopNow and create a key in the API console. Keys start with sk-popnow- and use the same credits as the website.
2. Send the request. POST /jobs/createTask with model bytedance/seedream-5.0-pro/edit and an input object that follows the parameter table. The response returns a task ID straight away.
3. Get the result. Poll GET /jobs/recordInfo with the task ID, or pass a callBackUrl and we post the result to it. Download the output links when the task succeeds.

# 1. Create the task. Keep the Idempotency-Key if you retry after a network error.
export IDEMPOTENCY_KEY="$(uuidgen)"
curl -X POST https://api.popnow.ai/api/v1/jobs/createTask \
  -H "Authorization: Bearer $POPNOW_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $IDEMPOTENCY_KEY" \
  -d '{
  "model": "bytedance/seedream-5.0-pro/edit",
  "input": {
    "prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
    "image_urls": [
      "https://media.popnow.ai/influencer/examples/marco.webp"
    ],
    "aspect_ratio": "auto",
    "resolution": "2k",
    "output_format": "jpeg",
    "background": "opaque"
  }
}'

# 2. Copy data.taskId from the response, then poll until state is succeeded, failed, canceled or expired.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
  -H "Authorization: Bearer $POPNOW_API_KEY"

Replace the prompt and any links with your own. The API tab has the response, polling and callback reference.

Seedream 5.0 Pro API questions

All Seedream models

Seedream 5.0 Lite works in fixed 2K frame sizes, which keeps a series consistent, and Seedream 5.0 Flash is the faster, cheaper sibling. Pro is the one for the final, most detailed frame.

• Seedream 5.0 Pro APIHigh-detail images and edits from up to ten referencesFrom 6 credits per image
• Seedream 5.0 Flash APIQuick Seedream images, edits and layer splits up to 2KFrom 4 credits per image
• Seedream 5.0 Lite APIFixed-size 2K frames that keep a series consistentFrom 6 credits per image
• Seedream 4.0 APIExact sizes up to 4096×2304 and ten-reference editsFrom 5 credits per image

Other image APIs

• Nano Banana 2.1 APIGoogle's newest Nano Banana, sharp text and 4K outputFrom 8 credits per image
• Nano Banana Pro APIPlans the layout first: dense text, diagrams and 4K editsFrom 17 credits per image
• GPT Image 2.5 Sunburst APIOpenAI's quality-first model, up to 4K with clean textFrom 1 credit per image
• FLUX.2 Max APITop-tier FLUX: photoreal light and exact brand colorsFrom 11 credits per image
• Qwen Image 2.1 Pro APIUp to six detailed 2K images from one promptFrom 6 credits per image
• Qwen Image 2.1 Turbo APIFast 8-step renders, up to six per promptFrom 3 credits per image

More about Seedream 5.0 Pro

Try it

Seedream 5.0 Pro AI Image Generator onlineCreate images with Seedream 5.0 Pro in PopNow

Compare

Seedream 5.0 Pro vs Nano Banana 2.1

Docs

Seedream 5.0 Pro model ID and input schema in the API docsPopNow API quickstart: your first request in five minutesImage generation guide for the PopNow APIWebhooks: get Seedream 5.0 Pro results without polling