Generations (Jimeng Image Generation)

POST

/doubao/images/generations

The newly released API format by Jimeng adopts an OpenAI-compatible image generation format and supports higher concurrency.
Supported model only: doubao-seedream-3-0-t2i-250415

Price: 0.05 PTC/image

Request

Header Params

Authorization

string

optional

Example:

Bearer {{YOUR_API_KEY}}

Content-Type

string

optional

Example:

application/json

Body Params application/json

model

string

required

doubao-seedream-3-0-t2i-250415

prompt

string

required

Prompt words for generating images.

response_format

string

optional

Specify the return format for generated images. The following two values are supported:
"url": Returns a downloadable JPEG image link;
"b64_json": Returns image data in JSON format as a Base64 encoded string.

size

string

optional

The width and height of the generated image should be between [512 x 512, 2048 x 2048] pixels.
Recommended width and height options:
1024x1024 (1:1)
864x1152 (3:4)
1152x864 (4:3)
1280x720 (16:9)
720x1280 (9:16)
832x1248 (2:3)
1248x832 (3:2)
1512x648 (21:9)

seed

integer

optional

Random number seed, used to control the randomness of the model's generated content. The value range is [-1, 2147483647]. If not provided, the algorithm will automatically generate a random number as the seed. If you want the generated content to remain consistent, you can use the same seed parameter value.

guidance_scale

number

optional

The degree of consistency between the model's output and the prompt, i.e., the freedom of image generation; the larger the value, the lower the model's freedom and the stronger the correlation with the user's input prompt. Value range: floating-point number between [1, 10].

watermark

boolean

optional

Whether to add a watermark to the generated image.
false: Do not add a watermark.
true: Add a watermark labeled "AI Generated" in the bottom right corner of the image.

Example

{
    "model": "doubao-seedream-3-0-t2i-250415",
    "prompt": "鱼眼镜头，一只猫咪的头部，画面呈现出猫咪的五官因为拍摄方式扭曲的效果。",
    "response_format": "url",
    "size": "1024x1024",
    "seed": 12,
    "guidance_scale": 2.5,
    "watermark": false
}

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api.302.ai/doubao/images/generations' \
--header 'Authorization: Bearer sk-jls4AaVBGoe1GwZD64qZA1qyKTN1MPHa4NmvH1cT68z7K1Zz' \
--header 'Content-Type: application/json' \
--data-raw '{
    "model": "doubao-seedream-3-0-t2i-250415",
    "prompt": "鱼眼镜头，一只猫咪的头部，画面呈现出猫咪的五官因为拍摄方式扭曲的效果。",
    "response_format": "url",
    "size": "1024x1024",
    "seed": 12,
    "guidance_scale": 2.5,
    "watermark": false
}'

Responses

🟢200成功

application/json

Response Parameter Description

Field List

Field Name	Type	Description
model	string	The model ID used for this request (model name-version).
created	integer	The Unix timestamp (in seconds) when this request was created.
data	list	Information about the output images, including the image download URL or Base64. - When the return format is specified as url, the field is `url` - When the return format is specified as b64_json, the field is `b64_json` Note: To ensure information security, the url link will expire within 24 hours after generation. Please be sure to save the image in time.
usage	object	Information related to image generation. - `usage.generated_images` (integer): Number of images generated by the model.
error	object	Error information (optional). - `error.code` (string): Error code - `error.message` (string): Error message

data Field Description

When response_format is url, each element in the data array contains the field:

url: Image download address

When response_format is b64_json, each element in the data array contains the field:

b64_json: Base64 encoded string of the image

usage Field Description

usage.generated_images: Number of images generated by the model (integer)

error Field Description (Optional)

error.code: Error code (string)

error.message: Error message (string)

Body

model

string

required

created

integer

required

data

array [object {1}]

required

url

string

optional

usage

object

required

generated_images

integer

required

Example

{
    "model": "doubao-seedream-3-0-t2i-250415",
    "created": 1749720737,
    "data": [
        {
            "url": "https://file.302.ai/gpt/imgs/1788db737a9b475c0f30aeca66a26af6.jpg"
        }
    ],
    "usage": {
        "generated_images": 1
    }
}

Modified at 2025-07-07 05:36:39

Luma-Photon-Flash（Fast image generation）

Drawing（Doubao image generation）