Seedream 4.0 Text-to-Image

curl --request POST \
  --url https://api.powertokens.ai/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "seedream-4-0-250828",
  "prompt": "A cute corgi running on the grass, sunny day, realistic style",
  "size": "2048x2048",
  "response_format": "url"
}
'

{
  "created": 123,
  "data": [
    {
      "url": "<string>",
      "b64_json": "<string>",
      "size": "<string>"
    }
  ]
}

{
  "error": {
    "message": "Invalid request body format or field value",
    "type": "invalid_request_error",
    "code": "bad_request_body",
    "param": ""
  }
}

{
  "error": {
    "message": "Invalid token",
    "type": "api_error",
    "code": "access_denied",
    "param": ""
  }
}

{
  "error": {
    "message": "Insufficient account quota, please try again later",
    "type": "api_error",
    "code": "insufficient_user_quota",
    "param": ""
  }
}

{
  "error": {
    "message": "Internal service processing failure, please try again later",
    "type": "api_error",
    "code": "gen_relay_info_failed",
    "param": ""
  }
}

POST

images

generations

curl --request POST \
  --url https://api.powertokens.ai/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "seedream-4-0-250828",
  "prompt": "A cute corgi running on the grass, sunny day, realistic style",
  "size": "2048x2048",
  "response_format": "url"
}
'

{
  "created": 123,
  "data": [
    {
      "url": "<string>",
      "b64_json": "<string>",
      "size": "<string>"
    }
  ]
}

{
  "error": {
    "message": "Invalid request body format or field value",
    "type": "invalid_request_error",
    "code": "bad_request_body",
    "param": ""
  }
}

{
  "error": {
    "message": "Invalid token",
    "type": "api_error",
    "code": "access_denied",
    "param": ""
  }
}

{
  "error": {
    "message": "Insufficient account quota, please try again later",
    "type": "api_error",
    "code": "insufficient_user_quota",
    "param": ""
  }
}

{
  "error": {
    "message": "Internal service processing failure, please try again later",
    "type": "api_error",
    "code": "gen_relay_info_failed",
    "param": ""
  }
}

Authorizations

Authorization

string

header

required

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

Body

application/json

model

enum<string>

required

The name of the image generation model. Supported models include seedream-4-0-250828.

Available options:

seedream-4-0-250828

prompt

string

required

The prompt for generating images. Supports both Chinese and English. It is recommended not to exceed 300 Chinese characters or 600 English words. If the prompt is too long, the information may be diluted, causing the model to ignore details and focus only on key points, resulting in missing elements in the image.

Example:

"Vibrant close-up editorial portrait, model with sharp eyes, wearing a sculptural hat, rich color blocking."

size

string

default:2K

Specifies the size information of the generated image. Different models support different size configuration methods.

seedream-4-0-250828: Specifies the size information of the generated image. Supports the following two methods, which cannot be mixed.

Method 1 | Specify the pixel width and height of the generated image:
- Default value: 2048x2048
- Total pixel value range: [1280x720 (921600), 4096x4096 (16777216)]
- Aspect ratio range: [1/16, 16]
Note: When using Method 1, both the total pixel value range and the aspect ratio range must be satisfied simultaneously. The total pixel value is the product of the width and height pixels of a single image, not a restriction on individual width or height values.
- Valid example: 1600x600 Total pixel value 1600x600=960000, which meets the [921600, 16777216] range requirement; aspect ratio 1600/600=8/3, which meets the [1/16, 16] range requirement, so the example value is valid.
- Invalid example: 800x800 Total pixel value 800x800=640000, which does not meet the minimum requirement of 921600; aspect ratio 800/800=1, although it meets the [1/16, 16] range requirement, the two restrictions are not satisfied simultaneously, so the example value is invalid.

Method 2 | Specify the resolution of the generated image, and describe the image aspect ratio, shape, or purpose in natural language within the prompt, allowing the model to determine the size of the generated image.

Available values: 1K, 2K, 4K

Note: When using Method 2 and describing a specific aspect ratio in the prompt, the reference pixel dimensions actually mapped by the model are:

Resolution	Aspect Ratio	Pixel Dimensions
1K	1:1	1024x1024
	4:3	1152x864
	3:4	864x1152
	16:9	1280x720
	9:16	720x1280
	3:2	1248x832
	2:3	832x1248
	21:9	1512x648
2K	1:1	2048x2048
	4:3	2304x1728
	3:4	1728x2304
	16:9	2848x1600
	9:16	1600x2848
	3:2	2496x1664
	2:3	1664x2496
	21:9	3136x1344
4K	1:1	4096x4096
	4:3	4704x3520
	3:4	3520x4704
	16:9	5504x3040
	9:16	3040x5504
	3:2	4992x3328
	2:3	3328x4992
	21:9	6240x2656

Example:

"2K"

response_format

enum<string>

default:url

Specifies the return format of the generated image. Supports the following two return methods:

url: Returns an image download link; the link is valid for 24 hours after image generation, please download the image promptly.
b64_json: Returns image data in JSON format as a Base64-encoded string.

Available options:

url,

b64_json

seed

integer

default:-1

Random seed. Supported by some Seedream models. Value range: [-1, 2147483647].

Required range: -1 <= x <= 2147483647

sequential_image_generation

enum<string>

default:disabled

Controls whether to disable the sequential image generation feature.

auto: Automatic determination mode. The model will autonomously decide whether to return a set of images and the number of images based on the user's prompt.
disabled: Disable the sequential image generation feature. The model will only generate one image.

Only seedream 5.0/4.5/4.0 support this parameter.

Available options:

auto,

disabled

sequential_image_generation_options

object

Configuration for the sequential image generation feature. Only takes effect when sequential_image_generation is set to auto.

Only seedream 5.0/4.5/4.0 support this parameter.

Show child attributes

watermark

boolean

default:true

Whether to add a watermark to the generated image.

false: No watermark added.
true: Adds an "AIGeneration" watermark in the bottom right corner of the image.

Response

Success, returns the image generation result.

created

integer<int64>

Unix timestamp (seconds) of the creation time.

data

object[]

List of generated images. May contain multiple images in sequential image generation scenarios.

Show child attributes

Wan2.7 image generation and edit

Seedream 4.0 Image-to-Image

Chat Models

Image Models

Video Models

Audio Models

asset library

Authorizations

Body

Response