Skip to main content
POST
cURL
This is the Seedream Image Generation API image-to-image endpoint. Style transfer or content editing based on single reference image. Supports transparent background (background: transparent) mode. Submit async task and return id, use query endpoint to get results.

Authorizations

TT-API-KEY
string
header
required

Get your API key from the TTAPI Dashboard.

Body

application/json

Image-to-Image request parameters

model
enum<string>
required

Model name.

Available options:
doubao-seedream-5-0-pro-260628,
doubao-seedream-5-0-flash-260915
Example:

"doubao-seedream-5-0-pro-260628"

prompt
string
required

Text prompt describing the editing intent.

image
string
required

Reference image URL. Supports jpeg/png/webp/bmp/tiff/gif/heic/heif formats, aspect ratio [1/16, 16], max size 30MB.

size
enum<string>
default:2K

Image size. 5.0 pro/flash options: 1K, 1.5K, 2K (default 2K), or pixel values like 2048x1024.

Available options:
1K,
1.5K,
2K
output_format
enum<string>
default:jpeg

Output image format.

Available options:
png,
jpeg
response_format
enum<string>
default:url

Return format. url returns image download link, b64_json returns Base64 encoded data.

Available options:
url,
b64_json
background
enum<string>
default:opaque

Image alpha channel setting. transparent generates transparent background, opaque generates opaque background.

Available options:
transparent,
opaque
watermark
enum<boolean>
default:true

Whether to add watermark. true=Display "AI Generated" in bottom-right, false=Do not add.

Available options:
true,
false
Example:

false

optimize_prompt_options
object

Prompt optimization config

execution_expires_after
integer
default:172800

Task timeout threshold (seconds). Range [3600, 259200] (1-72 hours), default 172800 (48 hours)

priority
integer
default:0

Execution priority. Range [0, 9], higher value = higher priority, default 0 (FIFO)

safety_identifier
string

End user unique identifier, max 64 characters. Recommend passing a hashed string

Response

200 - application/json

Task submitted successfully

status
string
required

Task status

Example:

"PENDING_QUEUE"

message
string
required
Example:

"success"

id
string
required

Task ID

Example:

"30d9b07d-7349-4cbc-8e11-9ba302c6d165"

Last modified on October 23, 2026