Developer API

Welcome to the aeImgAI API reference. Our API allows developers to programmatically generate fashion model images from clothing photos or custom text prompts. By using our API keys, you can connect your existing applications, servers, or workflows directly to our state-of-the-art AI image studio.

Getting Started

Integrate image generation into your application in three simple steps:

1

Generate Key

Navigate to API Keys in your dashboard user profile dropdown and create a new key.

2

Integrate API

Make HTTP POST requests to our generate-image endpoint including the key in your headers.

3

Receive Updates

Provide a webhook URL to receive asynchronous image updates once AI generation completes.

Authentication

Authenticate your API requests by passing your secret key in the x-api-key HTTP header.

Security Warning: Server-Side Execution Required
This API is strictly designed for **server-side use only**. You must never execute these API calls directly from client-side frontend applications (such as React, Vue, Next.js client components, or mobile apps). Exposing your secret API key (x-api-key) in client-side code allows malicious actors to extract the key from browser network inspection and drain your image generation credits.
curl -X POST https://api.aeimgai.com/api/v1/external/generate-image \
  -H "x-api-key: im_key_your_actual_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{ "type": "custom", "prompt": "a beautiful dress" }'