Skip to main content

​
🚀 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:

​
📝 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/ 
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"
}'
🎬 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/ 
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'
✅ 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

StepEndpoint
Create TaskPOST /api/iab_images/
Check StatusGET /api/iab_images/{id}/
API ReferenceIAB 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 api@creatify.ai.