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 account with API access
• Your API credentials (see 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/

Example Request

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"
}'

{
    "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/

Example Request

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'

{
    "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:

{
  "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

---

💳 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 or contact [e-mail].