Skip to main content
POST
Submit Seedream 4.0 task

Submit task

  • Header: Authorization: Bearer <your_api_key>.
  • Required: prompt. Optional: image_urls (max 14), aspect_ratio, resolution (1K/2K/4K), batch_size (1-15, total images ≤15), seed, watermark.
  • Breaking: size deprecated; use resolution and aspect_ratio.
  • Returns task_id, credits_deducted; poll /api/v1/task/status.
Seedream 4.0 reserves 30 credits per requested output image. Resolution and input image count do not add credits. image_urls supports up to 14 items, and input count + batch_size must be at most 15. Read /pricing before submission for the current tier.

Authorizations

Authorization
string
header
required

Wizzx API key. This is not a JWT.

Body

application/json

Seedream 4.0 and 4.5 share this request schema. input image count + effective batch_size must be at most 15.

prompt
string
required
Minimum string length: 1
image_urls
string<uri>[]
Maximum array length: 14

Publicly reachable HTTP(S) URL.

Pattern: ^https?://
aspect_ratio
enum<string>
Available options:
1:1,
4:3,
3:4,
16:9,
9:16,
3:2,
2:3,
21:9
resolution
enum<string>
default:2K
Available options:
1K,
2K,
4K
batch_size
integer
default:1
Required range: 1 <= x <= 15
seed
integer
watermark
boolean
default:false

Response

Task accepted

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

"success"

data
object
required
request_id
string<uuid>
required