Skip to main content
POST
https://aigenstudio.app
/
api
/
v1
/
product-image-enhancements
curl --request POST \ --url https://aigenstudio.app/api/v1/product-image-enhancements \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --header 'Idempotency-Key: <idempotency-key>' \ --data ' { "images": [ { "source_url": "https://client.example/images/yogurt-001.jpg", "external_id": "yogurt-001" } ] } '
{
  "enhancement": {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "total_items": 123,
    "credits_reserved": 123,
    "sandbox": true
  },
  "remaining_paid_credits": 123
}

Authorizations

​
Authorization
string
header
required

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

Headers

​
Idempotency-Key
string
required

Same user and same key returns the same enhancement instead of creating a duplicate.

Required string length: 8 - 160
Example:

"client_batch_2026_06_20_001"

​
X-Request-Id
string

Optional client request id. AI Gen Studio also returns an X-Request-Id header.

Body

application/json
​
images
object[]
required
Required array length: 1 - 20 elements
​
preset
enum<string>
Available options:
single_product_white_background,
marketplace_clean_catalog,
clean_catalog_group
​
preservation_level
enum<string>
default:strict
Available options:
strict,
balanced,
creative
​
instructions
string
Required string length: 1 - 4000
​
webhook_url
string<uri>

Optional HTTPS webhook endpoint. AI Gen Studio signs outgoing webhook requests.

Maximum string length: 2048

Response

Existing idempotent enhancement returned.

​
enhancement
object
required
​
remaining_paid_credits
integer
required