> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aigenstudio.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Overview

> Integrate AI Gen Studio image automation into ecommerce and marketplace workflows.

AI Gen Studio provides focused image APIs for product visuals, catalog cleanup, generated scenes, and ad creatives.

Base URL:

```txt theme={"theme":{"light":"github-light","dark":"github-light"}}
https://aigenstudio.app/api/v1
```

## What you can build

Use the API when your backend needs to:

* clean, resize, crop, relight, upscale, or polish existing product images;
* apply natural-language AI edits to image inputs;
* place a product into generated commerce scenes;
* generate new images from prompts;
* produce premium ad-oriented visuals from product images.

## Core workflow

1. Create a sandbox API key in the AI Gen Studio dashboard.
2. Call `GET /tools` to discover available tools and public credit costs.
3. Create a job with one of the five create endpoints and an `Idempotency-Key`.
4. Save `job.id` from the response.
5. Poll `GET /jobs/{jobId}` or listen for webhooks.
6. Switch to a live key when you are ready to reserve paid credits and process production images.

## Main resources

| Endpoint               | Purpose                                         |
| ---------------------- | ----------------------------------------------- |
| `GET /tools`           | Discover image tools and public credit costs.   |
| `POST /image/edit`     | Run structured image cleanup operations.        |
| `POST /image/ai-edit`  | Edit images with natural-language instructions. |
| `POST /scene/create`   | Place a product into a generated scene.         |
| `POST /image/generate` | Generate images from a text prompt.             |
| `POST /ad/create`      | Produce premium ad-oriented visuals.            |
| `GET /jobs`            | List jobs for the current API key.              |
| `GET /jobs/{jobId}`    | Read job status and results.                    |

## Sandbox behavior

Sandbox requests use the same request and response format as live requests. They validate payloads, idempotency, authentication, and job polling without consuming paid credits or calling paid providers.