AI Greeting Card MakerAPI

Say it your way: turn your own words into a designer greeting card for love, sorry, miss you, thank you, birthdays, anniversaries, proposals, congratulations or just because. Write in English, Hindi or Hinglish. A free writer can polish your words without changing your voice, and your text is printed exactly as written. Pick one of 12 designs, or describe your own and get new artwork made for your card. Download the card and a phone story.

design tools~15 credits/callv1.0.0

Schema

LLMs

Open Markdown content Open in ChatGPT Open in Claude

Endpoint

endpoint

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

Authentication

header

Authorization: Bearer YOUR_API_KEY

Parameters

Required

templateIdstringrequired

A design id from GET /api/ai/greeting-card-maker/templates (public), or 'custom' to have new artwork made from designStyle, designMotif, designPalette and designDescription (costs more).

Values: love-rose-watercolorlove-starry-heartsorry-bloom-againsorry-after-rainmissyou-across-milesthanks-botanical-jadethanks-sunflowersbirthday-confettibirthday-balloon-skyanniversary-golden-decoproposal-ring-noirjustbecause-wildflowerscustom

Example: love-rose-watercolor

senderNamestringrequired

Who the card is from, printed exactly as written.

Example: Ilario

Optional

messagestring

The message, printed exactly as written, in English or Hindi (Devanagari; Hinglish in Roman letters is fine). Hearts print as a heart; other emoji are left out (listed in data.wording.removed), and an emoji that stands for a word is refused. Give this or rawMessage.

rawMessagestring

Your own words, however they come. When message is empty the server writes the card message from them, keeping your voice and facts, and prints the closest version (returned in data.wording). Cards print English and Hindi: for words in another language, set language to en, hi or hinglish. Give this or message.

occasionstring

Sets the default headline and sign-off. Defaults to the design's first occasion.

Values: lovesorrymiss-youthank-youbirthdayanniversaryproposalcongratulationsjust-because

recipientNamestring

Printed as 'Dear <name>,' above the message ('प्रिय <name>,' on a Hindi card).

relationshipstring

Who the card is for; guides the writer when rawMessage is used.

Values: partnerspousecrushexmotherfatherparentssisterbrothersondaughtergrandparentfriendbest-friendteacherbosscolleagueteamclientother

headlinestring

Replaces the occasion's headline (for example 'I'm Sorry').

signOffstring

Line above your name. Defaults to the occasion's (for example 'With love,').

languagestring

For rawMessage: auto (same as your words), en, hi (Devanagari) or hinglish (Hindi in Roman letters).

Values: autoenhihinglish

Default: auto

tonestring

For rawMessage. Defaults to the occasion's tone.

Values: romanticheartfeltfunnypoeticformalsimple

designStylestring

With templateId 'custom' (required there): the artwork style.

Values: watercolorline-artbotanicalvintagemodern-geometriccute-illustratedelegant-goldretro

designMotifstring

With templateId 'custom' (required there): what the artwork shows, as a picture only. No words, names, numbers or signs in it (your words go in the message), and no characters or brands owned by others.

designPalettestring

With templateId 'custom': the colours. Defaults to the style's palette.

Values: blush-goldsage-creamnavy-goldterracotta-sandlavender-mistsunshine-coralmint-peachblack-champagneocean-bluerose-burgundy

designDescriptionstring

With templateId 'custom': optional extra detail for the artwork, again with no words in it.

formatsarray

Extra formats besides the card: ['story'] adds a 1080x1920 phone story (in data.formats.story).

output_formatstring

Image format of the card (the story is always JPEG).

Values: pngjpegwebp

Default: png

Example Request

cURL

curl -X POST https://backend.aaddyy.com/api/ai/greeting-card-maker \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "templateId": "love-rose-watercolor",
    "senderName": "Ilario",
    "tone": "romantic"
  }'

Request Body

json

{
  "templateId": "love-rose-watercolor",
  "senderName": "Ilario",
  "tone": "romantic"
}

Example Response

json

{
  "success": true,
  "message": "AI Greeting Card Maker completed successfully",
  "timestamp": "2026-11-03T23:30:06.170Z",
  "requestId": "req_iyfatc2d4",
  "data": {
    "cost": 0.15,
    "remainingCredits": 9.95
  }
}

SDK

javascript

import { AADDYY } from 'aaddyy'

const client = new AADDYY()
const result = await client._request('POST', '/api/ai/greeting-card-maker', {
  "templateId": "love-rose-watercolor",
  "senderName": "Ilario",
  "tone": "romantic"
})

Install: npm install aaddyy

Pricing

~15 credits (~$0.15) per request

Feature pricing:

customDesign: +30 credits

Rate Limits

20 requests per 1m

Burst: 5

← Back to all endpoints