Skip to main content
POST
AI Background

Authorizations

Authorization
string
header
required

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

Headers

Idempotency-Key
string
required

Stable key for safely retrying one logical create request.

Required string length: 8 - 160
Pattern: ^[A-Za-z0-9._:-]+$
X-Request-Id
string

Optional client correlation id. AI Gen Studio also returns request_id.

Maximum string length: 160

Body

application/json
object
object
required
scene
object
required
aspect_ratio
enum<string>
default:1:1
Available options:
1:1,
4:5,
9:16,
16:9,
3:2,
2:3
placement_type
enum<string>
default:product
Available options:
product,
person,
object
preference
object
output
object
webhook_url
string<uri>

Response

Existing idempotent job returned.

job
object
required
remaining_paid_credits
integer
required
request_id
string
required