AI Banner Generator

---

✨ Features

🎨 Multiple AI Models Native/Canvas ⭐ FREE - No API required! Google Gemini Pro - AI-powered design OpenAI DALL-E 3 - Photorealistic quality Stable Diffusion XL - Open-source generation Midjourney - Artistic styles

⚡ Key Capabilities ✅ Automated design generation 🎭 7 style templates available 🎨 Custom colors & branding 📊 Generate up to 5 variations 🔄 Banner revision mode 📐 Flexible dimensions (300x200 to 3000x2000) 🖼️ Multiple formats (PNG, JPEG, WebP)

🎯 Perfect For

💰 Pricing

Note: External API costs apply when using AI models (DALL-E, Stable Diffusion, etc.). Use Native/Canvas mode for completely free generation!

🚀 Quick Start

Step 1: Choose Your AI Model

// No API key needed!
"aiModel": "native"  // ⭐ Recommended for beginners

// Or use advanced AI models:
"aiModel": "dall-e-3"        // Requires OpenAI API key
"aiModel": "stable-diffusion" // Requires Replicate API key

Step 2: Configure Your Banner

{
  "aiModel": "native",
  "bannerText": "Summer Sale - 50% Off!",
  "bannerWidth": 1200,
  "bannerHeight": 628,
  "primaryColor": "#FF6B6B",
  "outputFormat": "png"
}

Step 3: Run & Download

Your banners will be available in:

• 📊 Dataset - Metadata and URLs
• 🖼️ Key-Value Store - Image files

---

📖 Configuration

Required Parameters

Parameter	Type	Description	Example
aiModel	string	AI model to use	"native"
bannerText	string	Main headline text	"Summer Sale"

Optional Parameters

🔑 API Keys Setup

💡 Usage Examples

Example 1: Generate Banner with Native/Canvas (No API Required!)

{
  "mode": "generate",
  "aiModel": "native",
  "bannerText": "Summer Sale - 50% Off!",
  "subText": "Limited Time Offer",
  "bannerStyle": "vibrant",
  "bannerWidth": 1200,
  "bannerHeight": 628,
  "primaryColor": "#FF6B6B",
  "secondaryColor": "#FFA500",
  "industry": "ecommerce",
  "includeCallToAction": true,
  "callToActionText": "Shop Now",
  "numberOfVariations": 3,
  "outputFormat": "png"
}

Example 2: Generate E-commerce Banner with DALL-E

{
  "mode": "generate",
  "aiModel": "dall-e-3",
  "apiKey": "your-openai-api-key",
  "bannerText": "Summer Sale - 50% Off!",
  "subText": "Limited Time Offer",
  "bannerStyle": "vibrant",
  "bannerWidth": 1200,
  "bannerHeight": 628,
  "primaryColor": "#FF6B6B",
  "secondaryColor": "#FFA500",
  "industry": "ecommerce",
  "includeCallToAction": true,
  "callToActionText": "Shop Now",
  "numberOfVariations": 3,
  "outputFormat": "png"
}

Example 3: Generate Social Media Banner

{
  "mode": "generate",
  "aiModel": "stable-diffusion",
  "apiKey": "your-replicate-api-key",
  "bannerText": "Join Our Community",
  "subText": "Connect with thousands of creators",
  "bannerStyle": "modern",
  "bannerWidth": 1080,
  "bannerHeight": 1080,
  "primaryColor": "#4A90E2",
  "secondaryColor": "#7B68EE",
  "industry": "technology",
  "includeCallToAction": true,
  "callToActionText": "Sign Up Free",
  "outputFormat": "webp"
}

Example 4: Custom AI Prompt (Advanced)

{
  "mode": "generate",
  "aiModel": "dall-e-3",
  "apiKey": "your-openai-api-key",
  "bannerText": "Summer Vacation",
  "customPrompt": "Create a stunning tropical beach scene at sunset with palm trees, turquoise water, and golden sand. Vibrant colors, photorealistic style, no text or typography. Leave center space clear for text overlay. 1200x628 pixels.",
  "bannerWidth": 1200,
  "bannerHeight": 628,
  "outputFormat": "png"
}

Example 5: Revise Existing Banner

{
  "mode": "revise",
  "aiModel": "dall-e-3",
  "apiKey": "your-openai-api-key",
  "existingBannerUrl": "https://example.com/banner.jpg",
  "revisionInstructions": "Change the background to a gradient from blue to purple, and make the text more prominent",
  "bannerText": "New Year Sale",
  "primaryColor": "#4169E1",
  "secondaryColor": "#9370DB",
  "outputFormat": "png"
}

📤 Output

Output Structure

The Actor provides two outputs:

1. 📊 Banner Results - Dataset containing metadata and URLs
2. 🖼️ Banner Files - Key-value store with image files

Dataset Structure

{
  "mode": "generate",
  "aiModel": "dall-e-3",
  "timestamp": "2024-01-15T10:30:00.000Z",
  "banners": [
    {
      "url": "https://api.apify.com/v2/key-value-stores/.../banner_1234567890_v1.png",
      "fileName": "banner_1234567890_v1.png",
      "dimensions": {
        "width": 1200,
        "height": 628
      },
      "format": "png",
      "generationMethod": "dall-e",
      "variationNumber": 1,
      "prompt": "..."
    }
  ],
  "metadata": {
    "bannerText": "Summer Sale - 50% Off!",
    "subText": "Limited Time Offer",
    "style": "vibrant",
    "dimensions": "1200x628",
    "colors": {
      "primary": "#FF6B6B",
      "secondary": "#FFA500"
    },
    "industry": "ecommerce",
    "numberOfVariations": 1
  }
}

📐 Common Banner Sizes

📱 Social Media Platform Size Dimensions Facebook Cover 820 × 312 px 820, 312 Facebook Post 1200 × 630 px 1200, 630 Instagram Post 1080 × 1080 px 1080, 1080 Instagram Story 1080 × 1920 px 1080, 1920 Twitter Header 1500 × 500 px 1500, 500 LinkedIn Banner 1584 × 396 px 1584, 396

🌐 Web Banners Type Size Dimensions Leaderboard 728 × 90 px 728, 90 Large Rectangle 336 × 280 px 336, 280 Medium Rectangle 300 × 250 px 300, 250 Wide Skyscraper 160 × 600 px 160, 600 Billboard 970 × 250 px 970, 250 Hero Banner 1920 × 600 px 1920, 600

💡 Best Practices

✅ Do's ✓ Start with Native/Canvas - Free and fast ✓ Use brand colors - Maintain consistency ✓ Generate variations - Test multiple designs ✓ Match platform sizes - Use recommended dimensions ✓ Be specific - Clear text = better results ✓ Use revision mode - Refine existing banners

❌ Don'ts ✗ Don't use vague text ✗ Don't ignore brand guidelines ✗ Don't use unsupported sizes ✗ Don't skip A/B testing ✗ Don't forget API costs ✗ Don't use low-quality source images

🎯 Model Selection Guide

Model	Best For	Speed	Cost	Quality
Native/Canvas ⭐	Quick banners, gradients	⚡⚡⚡	💰 FREE	⭐⭐⭐⭐
DALL-E 3	Photorealistic designs	⚡⚡	💰💰💰	⭐⭐⭐⭐⭐
Stable Diffusion	Artistic styles	⚡⚡	💰💰	⭐⭐⭐⭐
Midjourney	Stylized art	⚡⚡	💰💰	⭐⭐⭐⭐⭐
Gemini Pro	Design guidance	⚡⚡⚡	💰	⭐⭐⭐

---

⚠️ Limitations

📚 Additional Resources

• 📖 ./OVERVIEW.md
• 💰 ./PRICING.md
• 🚀 ./QUICKSTART.md
• 📋 ./API_REFERENCE.md
• ✅ ./CHECKLIST.md

---

🆘 Support

📖 Documentation Check the Apify Docs

🔑 API Issues Review provider docs: OpenAI Replicate Google AI

✅ Troubleshooting Verify API keys Check account credits Review error logs

---

📄 License

This Actor is provided as-is for use on the Apify platform.

---