API Documentation
Get API Key

FlyerGen AI API

Integrate AI-powered flyer generation into your applications with our simple REST API.

REST API
JSON
HTTPS
Quick Start
Get up and running in minutes
1

Get your API key

Create an account and generate an API key from your settings.

2

Make your first request

Use the examples below to generate your first flyer.

3

Integrate into your app

Use the generated image URL in your application.

Authentication

All API requests require authentication using an API key passed in the header.

X-API-Key: your_api_key_here
Generate Flyer
POST
/api/flyers

Request Body

title
required
string
topics
required
string[]
style
optional
"modern" | "minimal" | "vibrant" | "professional" | "creative" | "elegant"
model
optional
string
aspectRatio
optional
"1:1" | "3:4" | "4:3" | "9:16" | "16:9"
description
optional
string - Event details to include on the flyer

Examples

curl -X POST https://your-domain.com/api/flyers \
  -H "Content-Type: application/json" \
  -H "X-API-Key: your_api_key_here" \
  -d '{
    "title": "Summer Music Festival",
    "topics": ["music", "summer", "festival"],
    "style": "vibrant",
    "aspectRatio": "9:16"
  }'

Response

{
  "success": true,
  "flyer": {
    "title": "Summer Music Festival",
    "topics": ["music", "summer", "festival"],
    "style": "vibrant",
    "aspectRatio": "9:16",
    "prompt": "A vibrant summer music festival flyer...",
    "imageUrl": "https://...",
    "metadata": {
      "model": "imagen-4.0",
      "generationTime": 5200,
      "provider": "gemini"
    }
  }
}
Rate Limits
Business Plan1000 requests/day

Rate limit headers are included in all responses:

  • X-RateLimit-Limit: Maximum requests allowed
  • X-RateLimit-Remaining: Requests remaining
  • X-RateLimit-Reset: Time when limit resets (Unix timestamp)
Error Codes
400Bad Request - Invalid parameters
401Unauthorized - Invalid API key
429Too Many Requests - Rate limit exceeded
500Internal Server Error