Skip to main content
POST
Create an asynchronous image edit job
Accepts a public HTTPS image or ready private media ID and returns an asynchronous image-edit job.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

idempotency-key
string
Required string length: 1 - 200

Body

application/json
model
enum<string>
required
Available options:
qwen-image-edit-spicy
image
required
Required string length: 1 - 2048
prompt
string
required
Required string length: 1 - 20000
seed
integer | null
Required range: 0 <= x <= 2147483647
webhook_url
string
Required string length: 1 - 2048

Response

Default Response

id
string
required
Pattern: ^job_[A-Za-z0-9_-]{20,64}$
object
enum<string>
required
Available options:
generation.job
created
integer
required
status
enum<string>
required
Available options:
queued,
submitted,
processing,
succeeded,
failed,
cancelled,
expired,
reconciliation_required
model
string
required
poll_url
string
required
completed
integer | null
reserved_amount
string
Pattern: ^[0-9]+\.[0-9]{4}$
currency
enum<string>
Available options:
USD
data
object[]
error
object | null
webhook_signing_secret
string
Pattern: ^whsec_[A-Za-z0-9_-]{43}$
Last modified on September 17, 2026