Sign in

v1

latestOpenAPI 3.1.02026-07-267724480.0 KB

Create Seedream images

post/v1/images/generations

Request body

modelstring required

Seedream model ID to use. Query /v1/models or open the Models page for available model IDs.

promptstring required

Text prompt describing the image or edit goal. Use a concrete visual request, such as a blue ceramic mug on a white table, soft studio lighting.

response_format'url' | 'b64_json'

Response image format. Use url for a temporary signed image URL, or b64_json when you need base64 image data in the response.

sizestring

Output resolution. Use a model-supported tier such as 2K or a model-supported WIDTHxHEIGHT value such as 2048x2048. Not every model ID accepts every tier.

imagestring[]

Optional reference images for image-to-image generation. Each item can be a public HTTPS URL or a data URI such as data:image/png;base64,YOUR_BASE64_IMAGE. Use an array even for one image. Reference images plus generated images must not exceed the provider limit.

watermarkboolean

When true, requests a visible AI-generated watermark on the output image. Set false when your workflow handles disclosure separately.

asyncboolean

CometAPI asynchronous task mode. Set this to true to return immediately with data.task_id, then poll the Seedream image task endpoint GET /v1/images/generations/{task_id} for the final image data.

output_format'png' | 'jpeg'

Output image file format. Use png when you need lossless output, or jpeg for smaller files.

guidance_scalenumber

Optional prompt-adherence control for model versions that support it. Higher values can follow the prompt more closely but may reduce naturalness. Omit this field when you do not need model-specific tuning.

seedinteger

Optional random seed for reproducible attempts on model versions that support seeding. Use -1 or omit the field for a random seed.

sequential_image_generation'auto' | 'disabled'

Controls sequential prompt handling. Use auto to let the model return a sequence when the prompt calls for one. Use disabled for ordinary single-image requests.

Response

Image generation response. Synchronous requests return completed image data. Async requests return a task response with data.task_id.

OR

Example response

{
  "code": "success",
  "message": "",
  "data": {
    "task_id": "<task_id>",
    "status": "pending",
    "data": []
  }
}