> ## Documentation Index
> Fetch the complete documentation index at: https://docs.creatify.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# Overview
> API that generates IAB-compliant advertising banner images in multiple standard sizes from a single input image.
## 🚀 Introduction
The **Image Ad API** allows you to generate **IAB-compliant advertising banner images**
from a single input image. The API automatically produces multiple standard banner sizes
suitable for display and mobile ad placements.
This endpoint is ideal for creating ready-to-use ad creatives that comply with
industry-standard IAB specifications, without manual resizing or design work.
***
## ⚙️ Quickstart Guide
### ✅ Prerequisites
Before you begin, ensure you have:
* A [Creatify](https://app.creatify.ai) account with **API access**
* Your **API credentials** (see [Quickstart](/quickstart))
***
## 📝 Step 1: Submit an IAB Image Generation Request
Use this endpoint to generate IAB-compliant advertising banner images from a single input image.
[`POST /api/iab_images/`](/api-reference/iab-images/post-iab-images)
```bash Example Request theme={null}
curl --request POST \
--url https://api.creatify.ai/api/iab_images/ \
--header 'Content-Type: application/json' \
--header 'X-API-ID: your-api-id' \
--header 'X-API-KEY: your-api-key' \
--data '{
"image": "https://d35ghwdno3nak3.cloudfront.net/content-understanding/brand/the_doers_way/1204242384972303.jpg",
"webhook_url": "https://webhook.site/ea6d0ccb-9a41-4a05-bdaa-08664c5f9f84"
}'
```
```json Example Response theme={null}
{
"id": "0418ad79-405d-45e4-9794-3e4adeb809cf",
"created_at": "2025-12-30T05:16:04.084406-08:00",
"updated_at": "2025-12-30T05:16:04.084443-08:00",
"image": "https://d35ghwdno3nak3.cloudfront.net/content-understanding/brand/the_doers_way/1204242384972303.jpg",
"output": [],
"status": "running",
"failed_reason": null,
"webhook_url": "https://webhook.site/ea6d0ccb-9a41-4a05-bdaa-08664c5f9f84"
}
```
> 🎬 The response includes a unique image generation ID. Save it to check status.
***
## ⏳ Step 2: Check IAB Image Generation Status
You can monitor the image generation progress by **polling the status endpoint** using the returned ID until the status changes to `done`.
[`GET /api/iab_images/`](/api-reference/iab-images/get-iab-images-)
```bash Example Request theme={null}
curl --request GET \
--url https://api.creatify.ai/api/iab_images/0418ad79-405d-45e4-9794-3e4adeb809cf/ \
--header 'X-API-ID: your-api-id' \
--header 'X-API-KEY: your-api-key'
```
```json Example Response [expandable] theme={null}
{
"id": "0418ad79-405d-45e4-9794-3e4adeb809cf",
"created_at": "2025-12-30T05:16:04.084406-08:00",
"updated_at": "2025-12-30T05:16:41.584501-08:00",
"image": "https://d35ghwdno3nak3.cloudfront.net/content-understanding/brand/the_doers_way/1204242384972303.jpg",
"output": [
{
"name": "Mobile Leaderboard",
"size": "320x50",
"url": "https://d35ghwdno3nak3.cloudfront.net/image_ads/banner_generation/1/20251230/36476dbf-6369-414c-bb7d-1e19446ea111_mobile_320x50.png",
"type": "Mobile"
},
{
"name": "Medium Rectangle (MPU)",
"size": "300x250",
"url": "https://d35ghwdno3nak3.cloudfront.net/image_ads/banner_generation/1/20251230/36476dbf-6369-414c-bb7d-1e19446ea111_mobile_300x250.png",
"type": "Mobile"
},
{
"name": "Large Mobile Banner",
"size": "320x100",
"url": "https://d35ghwdno3nak3.cloudfront.net/image_ads/banner_generation/1/20251230/36476dbf-6369-414c-bb7d-1e19446ea111_mobile_320x100.png",
"type": "Mobile"
},
{
"name": "Square / Small Square",
"size": "250x250",
"url": "https://d35ghwdno3nak3.cloudfront.net/image_ads/banner_generation/1/20251230/36476dbf-6369-414c-bb7d-1e19446ea111_mobile_250x250.png",
"type": "Mobile"
},
{
"name": "Medium Rectangle (MPU)",
"size": "300x250",
"url": "https://d35ghwdno3nak3.cloudfront.net/image_ads/banner_generation/1/20251230/36476dbf-6369-414c-bb7d-1e19446ea111_desktop_300x250.png",
"type": "Desktop"
},
{
"name": "Leaderboard",
"size": "728x90",
"url": "https://d35ghwdno3nak3.cloudfront.net/image_ads/banner_generation/1/20251230/36476dbf-6369-414c-bb7d-1e19446ea111_desktop_728x90.png",
"type": "Desktop"
},
{
"name": "Wide Skyscraper",
"size": "160x600",
"url": "https://d35ghwdno3nak3.cloudfront.net/image_ads/banner_generation/1/20251230/36476dbf-6369-414c-bb7d-1e19446ea111_desktop_160x600.png",
"type": "Desktop"
},
{
"name": "Half Page / Large Skyscraper",
"size": "300x600",
"url": "https://d35ghwdno3nak3.cloudfront.net/image_ads/banner_generation/1/20251230/36476dbf-6369-414c-bb7d-1e19446ea111_desktop_300x600.png",
"type": "Desktop"
},
{
"name": "Billboard",
"size": "970x250",
"url": "https://d35ghwdno3nak3.cloudfront.net/image_ads/banner_generation/1/20251230/36476dbf-6369-414c-bb7d-1e19446ea111_desktop_970x250.png",
"type": "Desktop"
},
{
"name": "Large Leaderboard",
"size": "970x90",
"url": "https://d35ghwdno3nak3.cloudfront.net/image_ads/banner_generation/1/20251230/36476dbf-6369-414c-bb7d-1e19446ea111_desktop_970x90.png",
"type": "Desktop"
},
{
"name": "Banner",
"size": "468x60",
"url": "https://d35ghwdno3nak3.cloudfront.net/image_ads/banner_generation/1/20251230/36476dbf-6369-414c-bb7d-1e19446ea111_desktop_468x60.png",
"type": "Desktop"
},
{
"name": "Square Pop-Up / Small Square",
"size": "250x250",
"url": "https://d35ghwdno3nak3.cloudfront.net/image_ads/banner_generation/1/20251230/36476dbf-6369-414c-bb7d-1e19446ea111_desktop_250x250.png",
"type": "Desktop"
}
],
"status": "done",
"failed_reason": null,
"webhook_url": "https://webhook.site/ea6d0ccb-9a41-4a05-bdaa-08664c5f9f84"
}
```
> ✅ When `status` is `done`, retrieve your generated banners from the `outptut` field.
### 🔔 Webhook Option
Instead of polling, you can provide a `webhook_url` in the request to receive the result automatically when the images are ready.\
When processing completes, the API will send a POST request to your webhook with a payload like this:
```json [expandable] theme={null}
{
"id": "0418ad79-405d-45e4-9794-3e4adeb809cf",
"status": "done",
"failed_reason": "",
"output": [
{
"name": "Mobile Leaderboard",
"size": "320x50",
"url": "https://d35ghwdno3nak3.cloudfront.net/image_ads/banner_generation/1/20251230/36476dbf-6369-414c-bb7d-1e19446ea111_mobile_320x50.png",
"type": "Mobile"
},
{
"name": "Medium Rectangle (MPU)",
"size": "300x250",
"url": "https://d35ghwdno3nak3.cloudfront.net/image_ads/banner_generation/1/20251230/36476dbf-6369-414c-bb7d-1e19446ea111_mobile_300x250.png",
"type": "Mobile"
},
{
"name": "Large Mobile Banner",
"size": "320x100",
"url": "https://d35ghwdno3nak3.cloudfront.net/image_ads/banner_generation/1/20251230/36476dbf-6369-414c-bb7d-1e19446ea111_mobile_320x100.png",
"type": "Mobile"
},
{
"name": "Square / Small Square",
"size": "250x250",
"url": "https://d35ghwdno3nak3.cloudfront.net/image_ads/banner_generation/1/20251230/36476dbf-6369-414c-bb7d-1e19446ea111_mobile_250x250.png",
"type": "Mobile"
},
{
"name": "Medium Rectangle (MPU)",
"size": "300x250",
"url": "https://d35ghwdno3nak3.cloudfront.net/image_ads/banner_generation/1/20251230/36476dbf-6369-414c-bb7d-1e19446ea111_desktop_300x250.png",
"type": "Desktop"
},
{
"name": "Leaderboard",
"size": "728x90",
"url": "https://d35ghwdno3nak3.cloudfront.net/image_ads/banner_generation/1/20251230/36476dbf-6369-414c-bb7d-1e19446ea111_desktop_728x90.png",
"type": "Desktop"
},
{
"name": "Wide Skyscraper",
"size": "160x600",
"url": "https://d35ghwdno3nak3.cloudfront.net/image_ads/banner_generation/1/20251230/36476dbf-6369-414c-bb7d-1e19446ea111_desktop_160x600.png",
"type": "Desktop"
},
{
"name": "Half Page / Large Skyscraper",
"size": "300x600",
"url": "https://d35ghwdno3nak3.cloudfront.net/image_ads/banner_generation/1/20251230/36476dbf-6369-414c-bb7d-1e19446ea111_desktop_300x600.png",
"type": "Desktop"
},
{
"name": "Billboard",
"size": "970x250",
"url": "https://d35ghwdno3nak3.cloudfront.net/image_ads/banner_generation/1/20251230/36476dbf-6369-414c-bb7d-1e19446ea111_desktop_970x250.png",
"type": "Desktop"
},
{
"name": "Large Leaderboard",
"size": "970x90",
"url": "https://d35ghwdno3nak3.cloudfront.net/image_ads/banner_generation/1/20251230/36476dbf-6369-414c-bb7d-1e19446ea111_desktop_970x90.png",
"type": "Desktop"
},
{
"name": "Banner",
"size": "468x60",
"url": "https://d35ghwdno3nak3.cloudfront.net/image_ads/banner_generation/1/20251230/36476dbf-6369-414c-bb7d-1e19446ea111_desktop_468x60.png",
"type": "Desktop"
},
{
"name": "Square Pop-Up / Small Square",
"size": "250x250",
"url": "https://d35ghwdno3nak3.cloudfront.net/image_ads/banner_generation/1/20251230/36476dbf-6369-414c-bb7d-1e19446ea111_desktop_250x250.png",
"type": "Desktop"
}
]
}
```
***
## 🎯 Summary
| Step | Endpoint |
| ------------- | ----------------------------------------------------------------- |
| Create Task | `POST /api/iab_images/` |
| Check Status | `GET /api/iab_images/{id}/` |
| API Reference | [IAB Images Reference](/api-reference/iab-images/post-iab-images) |
***
## 💳 Pricing
Generating IAB images through this endpoint costs **2 credits per request**.
***
## 🤝 Need Help?
If you run into any issues, check out our [API Reference](/api-reference) or contact [api@creatify.ai](mailto:api@creatify.ai).