Skip to main content
POST
cURL

Request body

multipart/form-data (recommended when sending images)
  • instructions (string, required): Between 3 and 10,000 characters
  • aspect_ratio (validAspectRatios, optional)
  • effort ("high" | "low", optional): Defaults to "high"
  • images (file | file[], optional): Single image or up to 10 images, each max 30MB

Validation rules

  • images accepts either:
    • a single image
    • an array of images (max 10)
  • Input is normalized to an array internally when provided

Authorizations

Authorization
string
header
required

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

Body

multipart/form-data
instructions
string
required
Required string length: 3 - 10000
aspect_ratio
enum<string>
Available options:
9:16,
2:3,
3:4,
4:5,
1:1,
5:4,
4:3,
3:2,
16:9
effort
enum<string>
default:high
Available options:
high,
low
images

Response

Job accepted

data
object
required
errors
unknown