Skip to content

Bytedance Seedream V4 Edit

Integrate

Model id bytedance/seedream/v4/edit
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/v1/run/bytedance/seedream/v4/edit?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field",
    "images": [
      "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
    ]
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

This request: $0.03 30 API credits Run it on this page

Get API key
ByteDance Image Editing 4K output #stylized#transform#editing

Prompt-based editing of up to 10 input images, with multi-image output and fast or standard prompt enhancement

ByteDance · Image

Your first result goes here

Build a request below and run it with your API key. Outputs are copied to our storage, kept forever or 7 days for free.

Build a request

Controls are generated from the model schema. The code and the price update as you change them.

•required

Text instructions for editing the image.

•required image_urls
Drop a file, or

Editing image URLs, processed from the last 10 entries if a longer list is submitted; the current input limit is 10 images.

default {"height":2048,"width...

Choose the generated image's dimensions. If they yield an area below 921600 pixels, they are increased proportionally to meet that minimum without altering the aspect ratio.

num_images default 1

Count of independent model generation runs using the prompt.

default 1

Set the per-generation image ceiling with `max_images`; values above one enable multi-image generation. Across `num_images` generations, each may return up to `max_images` images, giving a total output count from `num_images` through `max_images*num_images`. No more than 15 images may be used across inputs and outputs combined.

Advanced enhance_prompt_mode · seed · enable_safety_checker
enhance_prompt_mode default standard

Choose the prompt enhancement mode according to the quality/time trade-off: Fast takes less time but yields average quality; Standard takes longer but yields higher quality.

Random seed governing randomness during image generation.

POST /run/bytedance/seedream/v4/edit?wait=20 quote → $0.03
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/v1/run/bytedance/seedream/v4/edit?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field",
    "images": [
      "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
    ]
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Run this request

Your key stays in this browser: it is sent only to the Doitong API and saved (localStorage) only if you tick Remember. Get an API key

About Bytedance Seedream V4 Edit

Edits existing images from a text prompt. `image_urls` accepts up to 10 images; if more are sent, only the last 10 are used. Output size can be a preset such as square_hd, portrait_16_9, auto_2K or auto_4K, or a custom width and height. `num_images` and `max_images` each go up to 6 for multiple results, and `enhance_prompt_mode` switches between standard and fast.

Parameters

Send either the canonical name or the native name, not both. Canonical names

NameType DefaultAllowed Description
promptrequired
Typestring
Text instructions for editing the image.
image_sizeoptional
Typeobject
Default{"height":2048,"width":2048}
square_hdsquareportrait_4_3portrait_16_9landscape_4_3landscape_16_9autoauto_2Kauto_4K
Choose the generated image's dimensions. If they yield an area below 921600 pixels, they are increased proportionally to meet that minimum without altering the aspect ratio.
num_imagesoptional num_outputs
Typeinteger
Default1
1 – 6
Count of independent model generation runs using the prompt.
max_imagesoptional
Typeinteger
Default1
1 – 6
Set the per-generation image ceiling with `max_images`; values above one enable multi-image generation. Across `num_images` generations, each may return up to `max_images` images, giving a total output count from `num_images` through `max_images*num_images`. No more than 15 images may be used across inputs and outputs combined.
seedoptional
Typeinteger | null
Random seed governing randomness during image generation.
enable_safety_checkeroptional
Typeboolean
Defaulttrue
Safety-checking switch whose off setting requires account authorization. Without that authorization, every request is checked regardless of the setting; true enables the checker.
enhance_prompt_modeoptional
Typeenum
Defaultstandard
standardfast
Choose the prompt enhancement mode according to the quality/time trade-off: Fast takes less time but yields average quality; Standard takes longer but yields higher quality.
image_urlsrequired images
Typeurl[] · image
Editing image URLs, processed from the last 10 entries if a longer list is submitted; the current input limit is 10 images.
required Canonical name, also accepted

File parameters take a public https:// URL, a data: URI up to 10 MB, or the file_url of an upload. Files

Output

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "bytedance/seedream/v4/edit",
  "status": "succeeded",
  "created_at": "2026-10-20T12:00:00Z",
  "started_at": "2026-10-20T12:00:02Z",
  "completed_at": "2026-10-20T12:00:09Z",
  "queue_position": null,
  "cost": {
    "credits": 30,
    "usd": "0.03",
    "charged": 30,
    "refunded": 0
  },
  "input": {
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field",
    "image_urls": [
      "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
    ]
  },
  "output": {
    "images": [
      {
        "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
        "content_type": "image/jpeg",
        "file_name": "0-output.jpeg",
        "file_size": 1843200,
        "width": 1024,
        "height": 768
      }
    ],
    "seed": 42
  },
  "outputs": [
    {
      "type": "image",
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
      "content_type": "image/jpeg",
      "file_size": 1843200,
      "width": 1024,
      "height": 768,
      "stored": true
    }
  ],
  "error": null,
  "metrics": {
    "inference_seconds": 6.8
  },
  "urls": {
    "self": "https://api.doitong.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
Your files, your choiceEvery outputs[].url is a copy on our storage: kept forever (paid per GB-month) or 7 days for free, by your account setting or ?storage=.
Same shape on every modeltype, url, content_type, width, height and duration, for images, video and audio alike. output is the model’s own result object.
Fields of output
images
array of object {url, content_type, file_name, file_size, width, height}Images produced by the model.
seed
integerSeed value used during generation.

More models: Image Editing

For AI agents: this page as Markdown is at https://doitong.com/developers/models/bytedance/seedream/v4/edit.md. All models and guides: https://doitong.com/developers/llms.txt