Skip to main content
POST
Seedream 5.5

Headers

Authorization
string

Body

application/json
model
enum<string>
required

Model name. Must be seedream-5-5.

Available options:
seedream-5-5
prompt
string
required

Text prompt describing the image.

Required string length: 1 - 4000
ratio
enum<string>
default:auto

Output aspect ratio. Defaults to auto, which lets the model choose the framing from your prompt.

Available options:
auto,
1:1,
2:3,
3:2,
3:4,
4:3,
4:5,
5:4,
9:16,
16:9,
21:9,
9:21
image_size
enum<string>
default:2K

Output quality tier. 1K and 1.5K cost the same; 2K costs more. Defaults to 2K.

Available options:
1K,
1.5K,
2K
image_list
object[]

Optional reference images for image-to-image or editing, [{"url": "https://..."}]. Up to 10 images, each up to 30MB. Each reference image adds an input fee.

Required array length: 1 - 10 elements
background
enum<string>
default:opaque

opaque (default) gives a solid background. transparent gives a real alpha channel, with or without input images. auto lets the model decide, and the result reports background as transparent or opaque. transparent and auto output png; combining them with output_format: jpeg is rejected.

Available options:
opaque,
transparent,
auto
output_format
enum<string>
default:jpeg

Output file format. Defaults to png when background is transparent or auto.

Available options:
png,
jpeg
custom_callback_url
string<uri>

Optional. A publicly accessible HTTPS URL. When the task status changes (processing / success / failed), GoEnhance sends a POST request to this URL. The request body is identical to the response of GET /api/v1/jobs/detail. If your server does not respond with HTTP 200, the notification is retried up to 3 times, with a 3-second timeout per attempt.

Example:

"https://your-server.com/goenhance/callback"

Response

code
integer
required
msg
string
required
data
object
required