Skip to main content
POST
Submit Seedream 5.0 Pro task

Submit task

prompt is required. Omit image_urls for generation, or provide exactly one HTTP(S) URL or base64 data URI (JPEG, PNG, or WebP) for editing. resolution accepts 1K (default), 1.5K, or 2K; output_format accepts jpeg (default) or png. Each accepted request produces one image.
The gateway charges per image by resolution: 1K = 44, 1.5K = 44, 2K = 89 credits. aspect_ratio, output_format, and the reference image do not change the price. Read /pricing for the current amount.

Authorizations

Authorization
string
header
required

Wizzx API key. This is not a JWT.

Body

application/json

Omit image_urls for text-to-image or provide exactly one reference image for editing. One image per request. Billed per image by resolution; 1.5K costs the same as 1K. aspect_ratio, output_format, and the reference image do not change the price.

prompt
string
required

Required prompt, at most 4000 Unicode characters.

Required string length: 1 - 4000
image_urls
string[]
Maximum array length: 1

HTTP(S) URL or base64 data URI. JPEG, PNG, or WebP only.

Pattern: ^(https?://|data:image/(jpeg|png|webp);base64,)
aspect_ratio
enum<string>
default:auto
Available options:
auto,
1:1,
4:3,
3:4,
16:9,
9:16,
3:2,
2:3,
2:1,
1:2,
21:9
resolution
enum<string>
default:1K

Case-insensitive. Billed per image: 1K = 44, 1.5K = 44, 2K = 89 credits.

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

Response

Task accepted

code
enum<integer>
required
Available options:
0
message
string
required
Example:

"success"

data
object
required
request_id
string<uuid>
required