Image Generator API v3.0.0

Endpoints

GET/health - Health check

GET/fonts - List available fonts NEW

POST/generate - Generate image

What's New in v3.0.0

14+ Google Fonts: Script, serif, sans-serif, and display fonts
Font Weight Control: light, regular, bold, italic per text item
Configurable Overlay: opacity (0.0-1.0) and color
Text Alignment: Independent left/center/right per item
Line Height: Configurable spacing per text item
Manual Line Breaks: Support \n in text content
Output Formats: PNG, JPEG (with quality), or base64 JSON
Solid Color Backgrounds: Hex or CSS color names
Vertical Offset: Fine-tune text Y position per item

Available Fonts

arial, helvetica, times, courier, georgia, verdana, impact, comic-sans, dancing-script, great-vibes, pacifico, sacramento, playfair, playfair-display, cormorant, cormorant-garamond, lora, montserrat, poppins, raleway, oswald, bebas, bebas-neue, abril, abril-fatface

Parameters

Parameter	Type	Default	Description
`imageUrl`	string	-	Background image URL
`imageData`	string	-	Base64 background image
`textItems`	array	[]	Array of text objects
`text`	string	-	Legacy single text mode
`width`	number	1080	Canvas width
`height`	number	1080	Canvas height
`overlayOpacity`	number	0.4	Background overlay opacity (0.0-1.0) NEW
`overlayColor`	string	"0,0,0"	Overlay RGB color NEW
`backgroundColor`	string	"linear-gradient"	Solid color or "linear-gradient" NEW
`gradientColors`	object	{start:'#5b2c87',end:'#66cc00'}	Gradient start/end colors
`outputFormat`	string	"png"	"png", "jpeg", or "base64" NEW
`jpegQuality`	number	0.92	JPEG quality (0.0-1.0) NEW

Text Item Object

{
  "text": "Your text here",
  "position": "middle-center",
  "fontSize": 48,
  "fontColor": "white",
  "fontFamily": "playfair",
  "fontWeight": "regular",
  "textAlign": "center",
  "lineHeight": 1.4,
  "maxWidth": 900,
  "verticalOffset": 0,
  "textShadow": { "color": "rgba(0,0,0,0.8)", "blur": 20, "offsetX": 3, "offsetY": 3 }
}

Font Weight Options NEW

light (300), regular (400), bold (700), italic

Example: Quote Image

{
  "imageUrl": "https://example.com/sunset.jpg",
  "width": 1080,
  "height": 1080,
  "overlayOpacity": 0.35,
  "textItems": [
    {
      "text": "Good morning.",
      "position": "top-center",
      "fontSize": 72,
      "fontFamily": "playfair",
      "fontWeight": "bold",
      "fontColor": "white",
      "textShadow": true
    },
    {
      "text": "The reality of life is that your perceptions — right or wrong — influence everything else you do.",
      "position": "middle-center",
      "fontSize": 38,
      "fontFamily": "lora",
      "fontWeight": "regular",
      "fontColor": "white",
      "maxWidth": 900,
      "lineHeight": 1.6,
      "textShadow": { "color": "rgba(0,0,0,0.6)", "blur": 15 }
    },
    {
      "text": "Powered by Kwata Team",
      "position": "bottom-center",
      "fontSize": 22,
      "fontFamily": "montserrat",
      "fontWeight": "light",
      "fontColor": "rgba(255,255,255,0.6)",
      "textShadow": false
    }
  ]
}