Imagine API ReferenceLight Mode
AI Backgrounds API
POST/image/generations/ai-backgroundThe AI Background API allows users to add AI-generated backgrounds to transparent images. By providing a descriptive prompt and style preferences, the API generates a contextually appropriate background, making it ideal for product photos, marketing materials, and creative projects.
Request
Header Params
Authorization
string
required
A bearer token that authenticates the user for making the request.
Example:
Bearer {{API Token}}
Body Params multipart/form-data
prompt
string
required
A descriptive text that guides the AI in generating the desired background.
Example:
A lush green forest with sunlight filtering through the trees
image
file
required
The transparent image file to which the background will be added.
style
enum<string>
optional
Specifies the style of the background.
Allowed value:
product-shoot
Default:
product-shoot
Example:
product-shoot
seed
integer
optional
The seed parameter serves as the initial value for the random number generator. By setting a specific seed value, you can ensure that the AI generates the same image or outcome each time you use that exact seed.
>= 1
Example:
12
Request samples
Responses
Success(200)
HTTP Code: 200
Content Type : Binaryapplication/octet-stream
Example
The response for 200 code is bytes.Last modified: 4 days ago