Seedream 4.0 API

Introduction

Seedream 4.0 Image Editing revises supplied imagery with a written change request. Use it for controlled series work when character, composition or visual language should remain recognisable while one deliberate decision changes.

Choose a Seedream 4.0 mode by starting material

Key features

Image creation and source-led revision

Seedream 4.0 supports both starting from a written visual brief and revising supplied imagery. Keep those jobs separate: creation establishes a new composition, while editing is judged against the source elements it should retain.

Design work needs a reviewable hierarchy

For a graphic or campaign concept, provide checked copy and define the visual hierarchy before styling details. Review legibility, placement and factual accuracy at the intended delivery format.

A visual result is not a factual source

Use generated imagery to discuss a design direction. Do not treat an attractive result as proof of product details, dimensions or real-world claims that were not independently verified.

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 5 credits per image ($0.05).

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

Use cases

Refine a supplied visual

Seedream 4.0 Image to Image takes one to ten reference images plus an instruction and returns a single frame at the size you name. That makes it useful for series work: the same character, restyled, delivered at the same pixel dimensions every time. Name what each reference contributes and what must stay, and pick the preset that matches the source's shape so nothing is recomposed.

Consistent characters from references

Send a face reference, a wardrobe reference and a background plate to the editing endpoint, name what each contributes, and get one frame back at the preset you chose.

Continuing work started on 4.0

Campaigns and character sets first made with Seedream 4.0 can stay on the same model instead of switching generations halfway and re-matching the style.

Prompt guide & pro tips

Write the brief, or name the references

Send one to ten image URLs in the order your prompt refers to them, and say what each contributes and what must stay.

Poll the task and keep the brief

There is no seed, so keep the references and the instruction together with any frame you want to build a series on.

Adapt the included example

Start with the published example using size: 1728*2304. Replace the subject and creative direction while keeping the input contract for this mode intact.

Keep the face, body and pose of the woman in Image 1 exactly as they are. Move her to a sunlit Mediterranean terrace with whitewashed walls and bougainvillea, relight her with warm late-afternoon sun from the left, and regrade the whole frame to soft golden tones.

One image in: the instruction protects face, body and pose, then replaces the location and the light. Name the short list that stays and the rest is open. Delivered at the tall 1728*2304 preset to keep the source's portrait shape.

Check the result before iterating

One to ten references, each needing a role named in the prompt; unnamed sources get blended. size still applies, so a reference of a different shape is recomposed into the preset you choose. Long edit chains drift, so go back to the original frame rather than re-editing an edit.

API quick start

Call the Seedream 4.0 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-4.0/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-4.0/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"
    ],
    "size": "2048*2048"
  }
}'

# 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 4.0 API questions

All Seedream models

Seedream 5.0 Pro and Lite are the newer generation with finer material detail; 4.0 keeps its own look and the largest sizes.

• 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 4.0

Try it

Seedream 4.0 AI Image Generator onlineCreate images with Seedream 4.0 in PopNow

Docs

Seedream 4.0 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 4.0 results without polling