Skip to main content
POST
Seedream 5.0 Pro Text-to-Image

Authorizations

Authorization
string
header
required

Pass Authorization: Bearer <token> in the request header.

Body

application/json
model
enum<string>
required

Image generation model name. Supported models include dola-seedream-5-0-pro-260628 (Seedream 5.0 pro, supports interactive editing, does not support sequential image generation).

Available options:
dola-seedream-5-0-pro-260628
prompt
string
required

Prompt for image generation, supports Chinese and English. It is recommended not to exceed 300 Chinese characters or 600 English words. Too many words may disperse information, causing the model to ignore details and focus only on key points, resulting in missing elements in the image.

Example:

"Dynamic close-up editorial portrait with sharp gaze, sculptural hat, rich color blocking."

size
string
default:2K

Specifies the dimensions of the generated image. Supports the following two methods, which cannot be used at the same time:

  • Method 1 (Recommended): Specify the resolution level of the generated image, and describe its aspect ratio, shape, or purpose in the prompt using natural language. The model determines the final image size.

    • Default: 2K
    • Available values: 1K, 1.5K, 2K
    • Pricing note: 1.5K has the same price as 1K while providing better image generation quality.
  • Method 2: Specify the width and height of the generated image in pixels (widthxheight):

    • Total pixels range: [1280x720 (921,600), 2048x2048x1.1025 (4,624,220)]
    • Aspect ratio range: [1/16, 16]
    • Note: When using Method 2, both the total pixel range and aspect ratio range must be satisfied. The total pixel limit applies to the product of width and height, rather than to either dimension individually.
      • Valid example: 2048x1024 (Total pixel count: 2048x1024=2,097,152; aspect ratio: 2048/1024=2)
      • Invalid example: 512x512 (Total pixel count: 512x512=262,144, below 921,600 minimum)

Resolution to Pixel Reference Values (Method 1):

Example:

"2K"

response_format
enum<string>
default:url

Specifies how generated images are returned. Supported options:

  • url: Returns a download URL for the image; valid for 24 hours after generation.
  • b64_json: Returns image data as a Base64-encoded string in JSON.
Available options:
url,
b64_json
watermark
boolean
default:true

Controls whether to add a watermark to the generated image.

  • false: Does not add a watermark.
  • true: Adds an "AI-generated" watermark in the lower-right corner of the image.

Response

Success, returns the image generation result.

model
string

Model ID (model name-version) used for this request.

created
integer<int64>

Unix timestamp (seconds) of creation.

data
object[]

List of generated images.

usage
object

Usage information for this request.