Skip to main content
Each enhancement item must include a public source_url that AI Gen Studio can download from the server. The API validates URLs before processing to protect the platform and avoid wasting credits on invalid inputs.

​
Accepted image types

Source images must be one of: 
image/jpeg
image/png
image/webp
The response Content-Type and the file signature must match. For example, a URL returning HTML with an image-like extension is rejected.

​
Size and download limits

Maximum source image size: 10 MB
Maximum redirects: 3
Download timeout: 10 seconds
If a source image is too large, unreachable, or too slow to download, the item fails before provider processing.

​
URL requirements

Source URLs must be public HTTP or HTTPS URLs. AI Gen Studio validates the resolved target, redirects, MIME type, file signature, and size. The API rejects URLs that target private or local network resources, including localhost, private IP ranges, internal hostnames, and redirects to blocked targets. For reliable processing, serve source images from a stable CDN or object storage URL. Good source URLs should:
  • be reachable without authentication;
  • return the image directly, not an HTML preview page;
  • include a correct Content-Type header;
  • remain valid long enough for the batch to be processed;
  • avoid short-lived signed URLs unless their expiration window is safely long.

​
Mapping results to your catalog

Use external_id to connect AI Gen Studio results back to your own product, SKU, or catalog item. 
{
  "external_id": "sku_123",
  "source_url": "https://cdn.example.com/products/sku_123.jpg"
}
external_id is returned in status responses and webhook events. It is optional, but production catalog integrations should send it for every image.