AI Festival Greeting Card MakerAPI

Create a personalised festival greeting card in seconds. Pick one of 42 ready-made designs for 30 festivals, including Diwali, Christmas, New Year, Holi, Eid, Raksha Bandhan and Navratri. Add your name, family or business and AI puts your wishes on the card while keeping the artwork; add a phone number or website for shop and company greetings. Download a phone-ready PNG for WhatsApp and Instagram.

design tools~20 credits/callv1.0.0

Schema

LLMs

Open Markdown content Open in ChatGPT Open in Claude

Endpoint

endpoint

POST https://backend.aaddyy.com/api/ai/festival-greeting-card-maker

Authentication

header

Authorization: Bearer YOUR_API_KEY

Parameters

Required

templateIdstringrequired

Design to personalise; each design belongs to one festival. GET /api/ai/festival-greeting-card-maker/templates (public, no auth) lists the available designs with their festival, name and preview images; only ids listed there are accepted.

Values: diwali-diyas-rangolidiwali-marigold-lanternsdiwali-gold-minimaldiwali-modern-geometricbhai-dooj-tilak-thalichhath-rising-sungurpurab-golden-glowthanksgiving-harvest-wreathhanukkah-silver-menorahchristmas-classic-wreathchristmas-bows-baubleschristmas-nordic-minimalnew-year-gold-fireworksnew-year-champagne-toastnew-year-silver-starslohri-bonfiresankranti-kitespongal-harvest-potrepublic-day-tricolourlunar-red-lanternsramadan-crescent-lanternseid-emerald-gold-archeid-lilac-lanternsholi-colour-splashholi-pichkari-playholi-pastel-cloudseaster-spring-eggsgudi-padwa-gudiugadi-mango-neembaisakhi-golden-harvesteid-adha-crescent-nightindependence-tricolour-kitesrakhi-thread-sweetsrakhi-pastel-modernjanmashtami-flute-peacockganesh-modak-marigoldonam-pookalamnavratri-dandiya-nightsnavratri-nine-coloursdurga-puja-dhak-shiulidussehra-bow-arrowkarva-chauth-moonlit

Example: diwali-diyas-rangoli

senderNamestringrequired

Who the card is from: a name, family or business, printed exactly as written.

Example: The Sharma Family

Optional

greetingstring

Headline greeting. Omit to keep the design's own (e.g. 'Happy Diwali').

messagestring

Wish text under the greeting. Omit to keep the design's own message.

signOffstring

Line above the sender. Omit to keep the design's own.

contactLinestring

Optional line under the sender for business greetings: phone, website or address.

output_formatstring

Image format of the generated card.

Values: pngjpegwebp

Default: png

Example Request

cURL

curl -X POST https://backend.aaddyy.com/api/ai/festival-greeting-card-maker \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "templateId": "diwali-diyas-rangoli",
    "senderName": "The Sharma Family"
  }'

Request Body

json

{
  "templateId": "diwali-diyas-rangoli",
  "senderName": "The Sharma Family"
}

Example Response

json

{
  "success": true,
  "message": "AI Festival Greeting Card Maker completed successfully",
  "timestamp": "2026-11-02T19:06:54.602Z",
  "requestId": "req_9lh83iac1",
  "data": {
    "cost": 0.2,
    "remainingCredits": 9.95
  }
}

SDK

javascript

import { AADDYY } from 'aaddyy'

const client = new AADDYY()
const result = await client._request('POST', '/api/ai/festival-greeting-card-maker', {
  "templateId": "diwali-diyas-rangoli",
  "senderName": "The Sharma Family"
})

Install: npm install aaddyy

Pricing

~20 credits (~$0.20) per request

Rate Limits

15 requests per 1m

Burst: 5

← Back to all endpoints