Seedream V4

seedream-v4-image-to-image

post

A new-generation image creation model ByteDance, Seedream 4.0 integrates image generation and image editing capabilities into a single, unified architecture.

Header parameters

AuthorizationstringRequiredExample: sk-Qp03mnjjNqXKxpnw5qQ4IqVABNfad5YOk1axUhp7pJbokFmu

Body

application/json

modelstringRequired

The model name

Example: bytedance-seedream-v4-image-to-image

promptstringRequired

The text prompt used to generate the image

Example: Please place the animal in the lady's arms.

sizestring · enumOptional

The size of the generated image. The minimum total image area is 921600 pixels. Failing this, the image size will be adjusted to by scaling it up, while maintaining the aspect ratio.

Possible enum values: square_hd, square, portrait_4_3, portrait_16_9, landscape_4_3, landscape_16_9, auto, auto_2K, auto_4K

Note: For custom image sizes, you can pass the width and height as an object:

"image_size": {
  "width": 1280,
  "height": 720
}

Default: autoExample: autoPossible values:

seedintegerOptional

Random seed to control the stochasticity of image generation.

enable_safety_checkerbooleanOptional

If set to true, the safety checker will be enabled. Default value: false

Default: false

enhance_prompt_modestring · enumOptional

The mode to use for enhancing prompt enhancement. Standard mode provides higher quality results but takes longer to generate. Fast mode provides average quality results but takes less time to generate. Default value: "standard"

Possible enum values: standard, fast

Default: standardExample: standardPossible values:

image_urlsstring[]Required

List of URLs of input images for editing. Presently, up to 10 image inputs are allowed. If over 10 images are sent, only the last 10 will be used.

ninteger · min: 1Optional

n is the number of images to generate, default value is 1.

Default: 1Example: 1

output_formatstring · enumOptional

output_format indicate the output format, default value is url.

Default: urlExample: urlPossible values:

Responses

200Success

application/json

post

/v1/images/edits

HTTPcURLJavaScriptPython

POST /v1/images/edits HTTP/1.1
Host: image.onerouter.pro
Authorization: sk-Qp03mnjjNqXKxpnw5qQ4IqVABNfad5YOk1axUhp7pJbokFmu
Content-Type: application/json
Accept: */*
Content-Length: 431

{
  "model": "bytedance-seedream-v4-image-to-image",
  "prompt": "Please place the animal in the lady's arms.",
  "size": "auto",
  "seed": 35,
  "enable_safety_checker": false,
  "enhance_prompt_mode": "standard",
  "image_urls": [
    "https://resource.trustai.sg/image/generated%2Fonerouter_05a6cb3d-3d73-4a62-a9c4-71cdb6c59351.png",
    "https://resource.trustai.sg/image/generated%2Fonerouter_05efb43f-e2cf-4f1a-8b87-189de685aeb5.png"
  ],
  "n": 1,
  "output_format": "url"
}

200Success

{
  "data": [
    {
      "url": "https://resource.onerouter.pro/image/generated%2Fonerouter_6edd1863-3e68-4318-ac56-87e8bd5bb7d8.png",
      "b64_json": "",
      "revised_prompt": ""
    }
  ],
  "created": 1762951603
}