# AADDYY API Reference

> 55 AI tools via one REST API. Pay-per-use (1 credit = $0.01). No subscriptions. Outcome-level tools: one call returns a finished deliverable (article, logo, resume, SEO report) — no model choice, no prompt engineering, no multi-call pipelines.

Base URL: https://backend.aaddyy.com/api
Auth: Authorization: Bearer YOUR_API_KEY   (keys start with aip_)
OpenAPI Spec: https://backend.aaddyy.com/openapi.json
Tool Catalog (JSON): https://backend.aaddyy.com/api/documentation/tools
Complete per-tool reference: https://backend.aaddyy.com/llms-full.txt
Error codes + fixes: https://backend.aaddyy.com/docs/errors
Swagger UI: https://backend.aaddyy.com/api-docs/
Human portal: https://www.aaddyy.com/developer
Agent onboarding guide: https://backend.aaddyy.com/docs/ai-onboarding
A2A AgentCard: https://backend.aaddyy.com/.well-known/agent-card.json (JSON-RPC endpoint at https://backend.aaddyy.com/a2a)
Remote MCP server (Streamable HTTP): https://backend.aaddyy.com/mcp — keyless discovery + create_account tool; connect with ?apiKey=aip_YOUR_KEY for full access
Local MCP (Cursor/Claude Code): npx @aaddyy/mcp-server (env AADDYY_API_KEY) — https://www.npmjs.com/package/@aaddyy/mcp-server
NPM SDK: npm install aaddyy — https://www.npmjs.com/package/aaddyy

## Instructions for AI Agents

- NEVER guess endpoints or tool ids. List tools via GET https://backend.aaddyy.com/api/documentation/tools and use the `toolId` and `endpoint` fields verbatim (the toolId is NOT always derivable from the endpoint slug).
- Prefer the V2 async pattern for image/video/long-running tools: POST https://backend.aaddyy.com/api/v2/ai/{same-path} → 202 {jobId, pollUrl} → poll GET https://backend.aaddyy.com/api/v2/ai/jobs/{jobId} every 2s.
- Send an `Idempotency-Key` header (any unique string ≤256 chars) on every paid POST. A retry with the same key on the SAME endpoint replays the original response instead of charging twice (replay window: 30 minutes; the key is scoped to your account + method + path).
- On 402 INSUFFICIENT_CREDITS: the error's `details.topup` tells you exactly how to recover — POST /api/payments/checkout-session {"amountUsd": 10} → hand the returned url to your human (one click), poll GET /api/users/balance, retry.
- On 403 EMAIL_NOT_VERIFIED: verification needs one human touch — either a click on the emailed link, or POST /api/auth/send-otp then have your human relay the 6-digit code to POST /api/auth/verify-otp. Poll GET /api/auth/check-verification.
- Every error carries a stable `error.code` and a `docs` link (https://backend.aaddyy.com/docs/errors). Branch on the code, not the English message.
- Every successful tool response includes `cost` and `remainingCredits` — track your budget from responses; GET /api/users/balance also works (even unverified).
- Rate limit headers are IETF draft style: `ratelimit-limit`, `ratelimit-remaining`, `ratelimit-reset`. Globals: 600 req/15min unauthenticated, 6000 req/15min with a credential. Back off until `ratelimit-reset` (seconds) on 429.

## Quick Start — zero to first result in 3 calls (no human needed)

# 1. Create an account (free credits included, no card, no CAPTCHA)
curl -X POST https://backend.aaddyy.com/api/auth/quick-register \
  -H "Content-Type: application/json" \
  -d '{"email": "owner@example.com"}'
# → 201 {token (JWT), credentials {email, password — shown once}, user.credits, nextSteps}

# 2. Create an API key — works IMMEDIATELY, even before email verification
#    (unverified keys are bounded: 7-day expiry, small spend cap, 10 req/min —
#     one human click on the verification email lifts all bounds)
curl -X POST https://backend.aaddyy.com/api/users/api-keys \
  -H "Authorization: Bearer YOUR_JWT" \
  -H "Content-Type: application/json" \
  -d '{"name": "my-agent"}'
# → 201 {key: "aip_..." — shown once, store it}

# 3. Call any tool
curl -X POST https://backend.aaddyy.com/api/ai/article-title \
  -H "Authorization: Bearer aip_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: my-first-call-1" \
  -d '{"topic": "AI agents"}'

# Async (V2) variant of any tool — required for video, recommended for images:
curl -X POST https://backend.aaddyy.com/api/v2/ai/article-title -H "Authorization: Bearer aip_YOUR_KEY" \
  -H "Content-Type: application/json" -d '{"topic": "AI agents"}'
# → 202 {jobId, pollUrl} → GET https://backend.aaddyy.com/api/v2/ai/jobs/{jobId} until status "completed"

# The ONLY human steps, ever: (1) one click on the verification email to lift
# key bounds; (2) one click on a Stripe checkout link when you top up credits.

---
## Business Tools

### AI CV Resume Creator
toolId: ai-cv-resume-creator
POST https://backend.aaddyy.com/api/ai/cv-resume-creator — $0.10 per use (~10 credits); flat price per CV
Create ATS-optimized resumes with 6 professional templates. Achievement-anchored bullets, JD keyword tailoring, ATS match score, PDF and DOCX download.
Required: full_name (string), email (string), job_title_target (string), experience (array): One entry per role: company, title and start_date (up to 100, 100 and 20 characters) and achievement (10-500 characters) are required; end_date (20) and responsibilities (1000) are optional.
Optional: phone (string), location (string), linkedin (string), job_description (string): The job ad to tailor the resume to., skills (string), education (array): Up to 3 entries: institution and degree (up to 100 characters each) and year (10)., ...

### AI Cover Letter Creator
toolId: ai-cover-letter-creator
POST https://backend.aaddyy.com/api/ai/cover-letter-creator — $0.05 per use (~5 credits); flat price per cover letter
Generate personalized, recruiter-approved cover letters. Paste your resume, job description, and one real achievement. Guaranteed AI-fingerprint free. Download as .docx or .pdf.
Required: job_description (string), resume (string), achievement (string)
Optional: tone (string) [professional|confident|conversational], length (string) [concise|standard], your_name (string), company_name (string)

### AI Job Email Creator
toolId: ai-job-email-creator
POST https://backend.aaddyy.com/api/ai/job-email-creator — from $0.10 per email (~10 credits); per email; +$0.02 per extra variation (up to 5)
Generate professional, context-aware job-related emails including job applications, follow-ups, interview scheduling, thank you notes, and more. Tailored specifically for career and recruitment communication.
Required: emailType (string) [job_application|follow_up|interview_scheduling|interview_thank_you|job_inquiry|offer_negotiation|rejection_response|generic_professional]: Type of job email to generate, jobTitle (string): The job title you are applying for, companyName (string): Name of the company, userName (string): Your full name
Optional: recipientName (string), userRole (string): Your current role., portfolioUrl (string), customContext (string): Anything else the email should mention., tone (string) [formal|neutral|friendly|enthusiastic|confident|humble]: Tone of the email, formalityLevel (integer): Formality level (1=casual, 5=very formal), ...

## Content Creation

### AI Article Generator
toolId: ai-article-generator
POST https://backend.aaddyy.com/api/ai/article — $0.05 per use (~5 credits); flat price per article
Generate comprehensive, well-researched articles with SEO optimization
Required: topic (string)
Optional: length (string) [short|medium|long], tone (string) [professional|casual|friendly|formal|creative|authoritative|conversational], audience (string) [general|technical|business|academic|beginner|expert], includeImages (boolean), includeReferences (boolean), keywords (string), ...

### AI Article Title Generator
toolId: ai-title-generator
POST https://backend.aaddyy.com/api/ai/article-title — $0.01 per use (~1 credit); flat price per set of title ideas
Generate compelling, SEO-optimized article titles that drive clicks and engagement
Required: topic (string)
Optional: titleType (string) [clickbait|seo|professional|listicle|how-to|question|news|review], tone (string) [professional|casual|urgent|friendly|authoritative|conversational|dramatic], audience (string) [general|technical|business|academic|beginner|expert|consumer], keywords (string), quantity (integer), maxLength (integer), ...

### AI Content Curator
toolId: ai-content-curator
POST https://backend.aaddyy.com/api/ai/content-curator/analyze — $2.50 per use (~250 credits); flat price per document
Upload raw text and transform it into a beautifully structured, editable document with rich formatting. Edit with bold, italic, colors, images and more, then download as a polished PDF.
Optional: content (string): The text to lay out as a document. Give this or file., style (object): Optional look: primaryColor, secondaryColor, backgroundColor and textColor as hex codes, fontFamily and headingFontFamily, and theme (professional, modern, academic, minimal or creative)., file (file): A plain-text (.txt) file (multipart upload) whose text is used in place of content; up to 50,000 characters. Give this or content.

### AI Detector
toolId: ai-detector
POST https://backend.aaddyy.com/api/ai/ai-detector — $0.05 per use (~5 credits); flat price per text checked
Detect AI-generated content using dual-signal analysis: Raidar rewrite-distance method + classifier. Returns 4-tier classification with per-sentence analysis and detected signals.
Required: text (string)
Optional: esl_mode (boolean)

### AI Email Writer
toolId: ai-email-writer
POST https://backend.aaddyy.com/api/ai/email-writer — from $0.03 per email (~3 credits); per email; +$0.01 per extra version (up to 5)
Generate professional, personalized, and context-aware emails for any purpose using AI. Supports multiple tones, styles, and customization options.
Required: emailType (string) [business|sales_outreach|marketing|newsletter|customer_support|follow_up|networking|job_application|personal|announcement|apology]: Type of email to generate, topic (string): Topic or subject of the email
Optional: recipientName (string), recipientRole (string) [client|manager|hr|colleague|friend|prospect|customer], recipientRelationship (string) [new_contact|existing_client|internal|personal], goal (string) [get_reply|schedule_meeting|share_information|persuade_sell|apologize|announce], tone (string) [formal|semi_formal|friendly|persuasive|polite|enthusiastic|confident|empathetic|direct]: Tone of the email, length (string) [short|medium|detailed]: Length of the email, ...

### AI Essay Writer
toolId: ai-essay-writer
POST https://backend.aaddyy.com/api/ai/essay-writer — $0.04 per use (~4 credits); flat price per essay
Generate comprehensive, well-structured essays on any topic with customizable academic levels
Required: topic (string), wordCount (integer)
Optional: essayType (string) [argumentative|expository|narrative|descriptive|analytical|persuasive|compare_contrast|cause_effect|research], academicLevel (string) [high_school|undergraduate|graduate|professional], tone (string) [formal|informal|academic|conversational|professional], citations (boolean), outline (boolean)

### AI Grammar Checker
toolId: ai-grammar-checker
POST https://backend.aaddyy.com/api/ai/grammar-checker — $0.01 per use (~1 credit); flat price per text
Check and fix grammar, spelling, punctuation, and style errors. See exactly what changed with a track-changes diff view. Two modes: fix errors only, or improve clarity and style.
Required: text (string)
Optional: mode (string) [fix_errors|improve_clarity]

### AI Humanizer
toolId: ai-humanizer
POST https://backend.aaddyy.com/api/ai/humanizer — $0.01 per use (~1 credit); flat price per text
Transform AI-generated text into natural, human-sounding writing. Choose readability level, purpose, and humanization strength to bypass AI detectors while preserving your original meaning.
Required: text (string)
Optional: readability (string) [high_school|university|doctorate|journalist|marketing], purpose (string) [general|essay|article|marketing|story|cover_letter|report|business|legal], strength (string) [lite|standard|aggressive], tone (string) [formal|casual|creative]

### AI Instagram Post Generator
toolId: ai-instagram-post-generator
POST https://backend.aaddyy.com/api/ai/instagram-post-generator — $0.50 per use (~50 credits); flat price per post
Generate professional Instagram posts with intelligent theme matching and stunning images. Analyze your brand and create scroll-stopping content that engages your audience.
Required: postAbout (string)
Optional: manualImages (file): Up to 6 reference posts whose look and voice to follow. Give these, websiteUrl or both., manualImageCaptions (array): The captions of the manualImages, in the same order (up to 2000 characters each)., companyName (string), brandDescription (string), websiteUrl (string): Website to read the brand from. Give this, manualImages or both., websiteWeight (integer): How much the website shapes the post, against the reference posts (0-100)., ...

### AI LinkedIn Post Generator
toolId: ai-linkedin-post-generator
POST https://backend.aaddyy.com/api/ai/linkedin-post-generator — $0.50 per use (~50 credits); flat price per post
Generate professional LinkedIn posts with brand-aware content and eye-catching images. Perfect for building your professional presence and engaging your network.
Optional: websiteUrl (string): Website to read the brand from. Give this, postIdea or both., postIdea (string): What the post is about. Give this, websiteUrl or both., postGoal (enum) [Engagement|Awareness|Promotion|Thought Leadership|Education], logoFile (file): Logo to place on the post image, a PNG or JPEG file (multipart upload)., logoPosition (enum) [top-left|top-right|top-center|bottom-left|bottom-right|bottom-center|center-left|center-right|center], productImages (file): Product photos to feature in the post (multipart upload); the first 5 are used.

### AI Paraphraser
toolId: ai-paraphraser
POST https://backend.aaddyy.com/api/ai/paraphraser — $0.01 per use (~1 credit); flat price per text
Rewrite any text in 8 modes — Word Changer, Fluency, Formal, Academic, Simple, Creative, Expand, or Shorten. Supports 18 languages. Track-changes diff shows exactly what changed.
Required: text (string)
Optional: mode (string) [word_changer|fluency|formal|academic|simple|creative|expand|shorten], language (string) [English|Spanish|French|German|Italian|Portuguese|Dutch|Russian|Chinese|Japanese|Korean|Arabic|Hindi|Turkish|Polish|Swedish|Danish|Norwegian]

### AI Prompt Maker
toolId: ai-prompt-maker
POST https://backend.aaddyy.com/api/ai/prompt-maker — $0.03 per use (~3 credits); flat price per prompt
Convert your natural language (any language) into a clean, precise English prompt for image creation or image editing.
Required: text (string), mode (string) [image_creation|image_editing]

### AI Research Blog Writer
toolId: ai-research-blog-writer
POST https://backend.aaddyy.com/api/ai/research-blog-writer — from $0.05 per use (~5 credits); per post without web research; $0.07 with research, which is on by default; +$0.01 for a cover image
Generate research-based blog articles with SERP data, content aggregation, and embedded source links
Required: topic (string)
Optional: articleType (string) [Feature Article|How-to Guide|Product Review|Technical Guide|Buying Guide|Comparison Article|Educational Article|Opinion Piece|News Article|Case Study], autoDetectType (boolean): Without articleType, picks the article type from the topic., sampleArticle (string): An article whose format the new one follows., includeResearch (boolean): Research the topic on the web first. false writes without research., includeImage (boolean): Also find a stock photo that fits the article (data.imageUrl)., depth (integer)

### AI Thread Generator
toolId: ai-thread-generator
POST https://backend.aaddyy.com/api/ai/thread-generator — $0.05 per use (~5 credits); flat price per thread
Generate engaging Twitter/X threads from an article or topic. Each tweet enforces the 280-character limit.
Required: article (string)
Optional: topic (string), tone (enum) [engaging|professional|casual|witty|educational|persuasive|inspirational], threadLength (integer), language (enum) [english|spanish|french|german|hindi|portuguese|italian], includeHashtags (boolean), cta (string)

## Design Tools

### AI Album Cover Generator
toolId: ai-album-cover-generator
POST https://backend.aaddyy.com/api/ai/album-cover-generator — $0.10 per image (~10 credits); per cover image; up to 4 per request
Create unique, high-quality album covers using AI with extensive customization options for genre, mood, style, and reference images
Required: prompt (string)
Optional: album_type (string) [Album|Single|EP|Remix], album_title (string), artist_name (string), genre (string) [Pop|Rock|Hip-Hop|EDM|Jazz|Classical|R&B|Metal|Indie|Lo-Fi|Ambient|Experimental], mood (string) [Energetic|Chill|Dark|Dreamy|Emotional|Mysterious|Uplifting|Retro|Futuristic|Sad|Romantic|Angry], art_style (string) [Realistic|Abstract|Minimalist|Retro|Cyberpunk|Anime|Hand-Drawn|3D Render|Surrealism|Watercolor], ...

### AI Baby Card Maker
toolId: ai-baby-card-maker
POST https://backend.aaddyy.com/api/ai/baby-card-maker — $0.15 per image (~15 credits); flat price per baby card
Make a new baby wishes card or a birth announcement in seconds. Pick one of 10 designs for girls, boys, twins and Indian families, add the baby's name and birth details or your wishes, and get a print-ready card plus a phone story. Your words are typeset exactly as written, in English or Hindi, so names and dates are always spelled right.
Required: templateId (string) [wishes-peony-blush|wishes-paper-boats|wishes-moon-lullaby|wishes-two-little-birds|wishes-marigold-cradle|wishes-peacock-blessings|announce-wildflower-arch|announce-starry-night|announce-sage-eucalyptus|announce-twin-balloons]: Design to use. GET /api/ai/baby-card-maker/templates (public) lists the designs with preview images, the occasion each is for, and each occasion's fields; only ids listed there are accepted.
Optional: occasion (string) [new-baby-wishes|birth-announcement]: new-baby-wishes (needs senderName) or birth-announcement (needs babyName and birthDate). Defaults to the design's occasion., senderName (string): Who the card is from, printed exactly as written. Used by new-baby-wishes; required for new-baby-wishes., babyName (string): The baby's name, printed under the headline. Used by new-baby-wishes and birth-announcement; required for birth-announcement., parentsNames (string): Printed as 'Dear <names>,' above the message. Used by new-baby-wishes., headline (string): Replaces the design's headline (for example 'Welcome, Little One'). Used by new-baby-wishes and birth-announcement., message (string): Replaces the design's message. Up to 3 line breaks are kept. Hearts print; other emoji are left out. Used by new-baby-wishes and birth-announcement., ...

### AI Brand Guideline Kit
toolId: ai-brand-guideline-kit
POST https://backend.aaddyy.com/api/ai/brand-guideline-kit — $0.49 per use (~49 credits); flat price per brand guidelines kit; the brand snapshot before it is free (5 a day)
Turn your logo, website, product photos or a short description into complete brand guidelines. Start with a free brand snapshot you can edit (palette, fonts, logo, personality, voice), then get a 21-page brand book PDF covering your story, voice and tone, logo rules, colour system with accessible contrast, typography and imagery, plus business card, social post, story, website hero and email signature mockups with your real logo. The download kit adds logo files and favicons, CSS variables, design tokens, a Tailwind theme and a brand file for AI writing tools. One click saves it to your Brand Kit so every AADDYY writing tool uses your voice.
Optional: analysisId (string): Id from POST /api/ai/brand-guideline-kit/analyze (free snapshot, multipart or JSON). Use it with overrides to build the kit the user reviewed. Without it, pass the inputs below and the snapshot runs inline., overrides (object): Edits to the snapshot: name, description, audience, tone, industry, language, personality (array), palette ({ primary, secondary, accent, neutralDark, neutralLight } hex), fonts ({ heading, body })., businessName (string): Brand name. With a description, it is enough on its own; otherwise give websiteUrl, logoUrl, productImageUrls or fromBrandKit., description (string): What the business does and for whom (20-500 characters). Needed with businessName when no other source is given., websiteUrl (string): Public website to read colours, fonts, logo and copy from (homepage plus one about page). Any one source is enough: businessName with a description, websiteUrl, logoUrl, productImageUrls or fromBrandKit., logoUrl (string): Public link to the logo (PNG, JPG, WebP or SVG, up to 10 MB). Any one source is enough: businessName with a description, websiteUrl, logoUrl, productImageUrls or fromBrandKit., ...

### AI Festival Greeting Card Maker
toolId: ai-festival-greeting-card-maker
POST https://backend.aaddyy.com/api/ai/festival-greeting-card-maker — $0.20 per image (~20 credits); flat price per greeting card
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.
Required: templateId (string) [diwali-diyas-rangoli|diwali-marigold-lanterns|diwali-gold-minimal|diwali-modern-geometric|bhai-dooj-tilak-thali|chhath-rising-sun|gurpurab-golden-glow|thanksgiving-harvest-wreath|hanukkah-silver-menorah|christmas-classic-wreath|christmas-bows-baubles|christmas-nordic-minimal|new-year-gold-fireworks|new-year-champagne-toast|new-year-silver-stars|lohri-bonfire|sankranti-kites|pongal-harvest-pot|republic-day-tricolour|lunar-red-lanterns|ramadan-crescent-lanterns|eid-emerald-gold-arch|eid-lilac-lanterns|holi-colour-splash|holi-pichkari-play|holi-pastel-clouds|easter-spring-eggs|gudi-padwa-gudi|ugadi-mango-neem|baisakhi-golden-harvest|eid-adha-crescent-night|independence-tricolour-kites|rakhi-thread-sweets|rakhi-pastel-modern|janmashtami-flute-peacock|ganesh-modak-marigold|onam-pookalam|navratri-dandiya-nights|navratri-nine-colours|durga-puja-dhak-shiuli|dussehra-bow-arrow|karva-chauth-moonlit]: 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., senderName (string): Who the card is from: a name, family or business, printed exactly as written.
Optional: greeting (string): Headline greeting. Omit to keep the design's own (e.g. 'Happy Diwali')., message (string): Wish text under the greeting. Omit to keep the design's own message., signOff (string): Line above the sender. Omit to keep the design's own., contactLine (string): Optional line under the sender for business greetings: phone, website or address., output_format (string) [png|jpeg|webp]: Image format of the generated card.

### AI Greeting Card Maker
toolId: ai-greeting-card-maker
POST https://backend.aaddyy.com/api/ai/greeting-card-maker — from $0.15 per image (~15 credits); per card with a ready-made design; $0.30 when we create new artwork from your own idea
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.
Required: templateId (string) [love-rose-watercolor|love-starry-heart|sorry-bloom-again|sorry-after-rain|missyou-across-miles|thanks-botanical-jade|thanks-sunflowers|birthday-confetti|birthday-balloon-sky|anniversary-golden-deco|proposal-ring-noir|justbecause-wildflowers|custom]: 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)., senderName (string): Who the card is from, printed exactly as written.
Optional: message (string): 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., rawMessage (string): 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., occasion (string) [love|sorry|miss-you|thank-you|birthday|anniversary|proposal|congratulations|just-because]: Sets the default headline and sign-off. Defaults to the design's first occasion., recipientName (string): Printed as 'Dear <name>,' above the message ('प्रिय <name>,' on a Hindi card)., relationship (string) [partner|spouse|crush|ex|mother|father|parents|sister|brother|son|daughter|grandparent|friend|best-friend|teacher|boss|colleague|team|client|other]: Who the card is for; guides the writer when rawMessage is used., headline (string): Replaces the occasion's headline (for example 'I'm Sorry')., ...

### AI Jewelry Designer
toolId: ai-jewelry-designer
POST https://backend.aaddyy.com/api/ai/jewelry-designer — $0.05 per image (~5 credits); per design image; up to 4 per request
Create unique jewelry designs using AI. Select materials, styles, gemstones, and custom settings to generate concept art or detailed design visualizations for rings, necklaces, earrings, bracelets, and more.
Required: jewelry_type (enum) [ring|necklace|earring|bracelet|pendant|anklet|brooch|tiara|cufflinks|nose_ring|maang_tikka|waist_belt|armlet|hair_pin|watch_charm|jhumka|chandbali|mangalsutra|matha_patti|haath_phool|bichhiya|kalire|choker|rani_haar|bangle|kada|tasbih|tennis_bracelet|signet_ring|eternity_band|charm_bracelet|cameo|evil_eye|jade_bangle|longevity_lock|custom], design_style (enum) [classic|modern|minimalist|vintage|royal|art_deco|bohemian|ethnic|luxury|nature_inspired|kundan|polki|temple|meenakari|jadau|victorian|contemporary|gothic|steampunk|geometric|abstract|industrial|cyberpunk|neo_heritage|indo_western|mughal|rajasthani|south_indian|bengali|maharashtrian|navratna|pachchikam|thewa|filigree|nakshi|guttapusalu|guochao|ottoman|byzantine|etruscan|florentine|scandinavian], material (enum) [gold_yellow|gold_rose|gold_white|platinum|silver|titanium|copper|mixed_metals|bronze|brass|wood|leather|ceramic|carbon_fiber|resin|glass|enamel|black_gold|green_gold|22k_gold|24k_gold|oxidized_silver|rudraksh|terracotta|silk_thread|shell|vermeil|murano_glass]
Optional: gemstones (array) [diamond|lab_grown_diamond|moissanite|emerald|ruby|sapphire|pearl|amethyst|opal|turquoise|topaz|garnet|tanzanite|aquamarine|peridot|citrine|moonstone|onyx|lapis_lazuli|jade|coral|amber|quartz|spinel|tourmaline|zircon|cubic_zirconia|swarovski_crystal|polki_uncut|salt_and_pepper_diamond|black_diamond|zultanite|agate|malachite|none], target_audience (enum) [women|men|unisex|kids|seniors|teens|couples|pets|bride|groom], occasion (enum) [engagement|wedding|daily_wear|party|gift|anniversary|festival|formal|graduation|red_carpet|corporate|baby_shower|religious|date_night|casual|photoshoot|sangeet|haldi|reception|office_wear|college_wear|dhanteras|eid|diwali|karva_chauth], design_description (string), complexity (enum) [minimal|moderate|intricate], color_palette (enum) [neutral|pastel|bold|monochrome|warm|cool|vibrant], ...

### AI Logo Creator
toolId: ai-logo-creator
POST https://backend.aaddyy.com/api/ai/logo-creator — from $0.25 per image (~25 credits); per logo concept, PNG plus SVG; 1 to 6 concepts per request at $0.25 each
Generate professional, high-quality logos in seconds. Choose from multiple styles like modern, minimal, or vintage. Customize colors and backgrounds to perfectly match your brand.
Required: keyword (string): The brand name, drawn or set exactly as given
Optional: concepts (integer): How many logo concepts to make, each a different logo type, palette and typeface; priced per concept, and concepts that fail are refunded, tagline (string), description (string): What the business does, its audience and personality, logoTypes (array) [wordmark|lettermark|pictorial|abstract|mascot|emblem|combination]: Logo types to choose from (default: a mix that fits the brand), palette (array): Brand colours as hex codes like #1F4D3A; every concept then uses them, iconIdea (string), ...

### AI QR Code Generator
toolId: ai-qr-code-generator
POST https://backend.aaddyy.com/api/ai/qr-code-generator — free
Generate customized QR codes from any URL or text. Choose colors, error correction level, size, and output format. Completely free — no credits required.
Required: content (string)
Optional: foreground_color (string), background_color (string), error_correction (string) [L|M|Q|H], width (integer), margin (integer), output_format (string) [png|svg]

### AI T-Shirt Designer
toolId: ai-tshirt-designer
POST https://backend.aaddyy.com/api/ai/t-shirt-designer — $0.06 per image (~6 credits); per design image; up to 4 per request
Generate custom, print-ready T-shirt artwork using AI with text prompts, brand assets, style preferences, and realistic mockups
Required: prompt (string)
Optional: design_type (string) [Graphic Artwork|Typography-Only|Logo-Based|Pattern Design], inspiration_image (array): Up to 3 http(s) links or base64 data URIs of images to take inspiration from: 3 images at most together with logo_image., logo_image (string): Your logo, as an http(s) link or a base64 data URI (PNG, JPG, WebP or SVG)., logo_placement (string) [Top Left|Top Right|Bottom Center|Sleeve|Back Neck|Integrated in Design], art_style (string) [Minimalist|Vintage|Streetwear|Cartoon|Abstract|Realistic|Retro|Grunge|Pop Art|Anime|Cyberpunk], mood (string) [Fun|Bold|Motivational|Aesthetic|Whimsical|Chill], ...

### AI Wedding Invitation Card Maker
toolId: ai-wedding-invitation-card-maker
POST https://backend.aaddyy.com/api/ai/wedding-invitation-card-maker — $0.30 per image (~30 credits); flat price per invitation card
Create a personalised wedding invitation card in seconds. Pick one of 16 ready-made designs across Indian, floral, elegant and whimsical styles, add the couple's names, date, venue and RSVP details, and AI rewrites the card's wording while keeping the artwork. Works for engagement, reception and save-the-date cards too. Download a print-ready 2K PNG.
Required: templateId (string) [royal-maroon-gold|sage-french-garden|lilac-mughal-arch|editorial-minimal|peach-sage-blossoms|whimsical-doodles|blush-palace-peacocks|midnight-art-deco|temple-gold-jasmine|plum-fig-romance|lake-palace-watercolour|heirloom-lace-bow|moorish-arch-lanterns|amalfi-lemons|powder-blue-silver|wildflower-meadow]: Design to personalise. GET /api/ai/wedding-invitation-card-maker/templates (public, no auth) lists the available designs with names and preview images; only ids listed there are accepted., partnerOneName (string): First partner's name, printed exactly as written., partnerTwoName (string): Second partner's name, printed exactly as written., eventDate (string): Date as free text, printed exactly as written., venueName (string): Venue name.
Optional: eventType (string) [wedding|engagement|reception|save_the_date]: Kind of card. Sets the invitation wording unless invitationMessage is given., eventTime (string): Time line. Omit to remove the time line from the card., venueAddress (string): Address or city printed under the venue. Omit to remove the address line., hostLine (string): Opening line above the names. Omit to keep the design's own opening line., invitationMessage (string): Replaces the invitation wording under the names. Omit to keep the design's wording for the chosen eventType., rsvpDetails (string): RSVP line. Omit to remove the RSVP line., ...

## Education

### AI Educational Clip Generator
toolId: ai-edu-clip-generator
POST https://backend.aaddyy.com/api/ai/edu-clip-generator — from $0.60 per video (~60 credits); 15-second video; $0.20 per 5-second scene (15 to 60 seconds)
Generate short animated educational videos from a topic or idea. AI writes the script, generates scene-by-scene clips with narrated audio, and stitches them into a complete MP4.
Required: userInput (string): The topic or idea the clip explains., duration (integer) [15|30|45|60]: Length of the clip in seconds: 15, 30, 45 or 60.
Optional: aspectRatio (string) [21:9|16:9|4:3|1:1|3:4|9:16], videoStyle (string) [2d-cartoon|3d-cartoon|realistic|watercolor|whiteboard]

### AI Math Solver
toolId: ai-math-solver
POST https://backend.aaddyy.com/api/ai/math-solver — $0.02 per use (~2 credits); flat price per problem
Solve mathematical problems with step-by-step explanations. Supports image or text input for arithmetic, algebra, geometry, calculus, and more.
Required: inputType (string) [image|text]
Optional: problemImage (string), problemText (string), problemCategory (string) [arithmetic|algebra|geometry|trigonometry|calculus|statistics|linear-algebra|other|auto-detect], explanationLevel (string) [brief|step-by-step|conceptual], language (string) [english|spanish|french|hindi|arabic|chinese|custom], solutionFormat (string) [text|text-latex|pdf], ...

### AI Physics Solver
toolId: ai-physics-solver
POST https://backend.aaddyy.com/api/ai/physics-solver — $0.02 per use (~2 credits); flat price per problem
Solve physics problems with step-by-step explanations. Supports image or text input for mechanics, electricity & magnetism, thermodynamics, optics, and more.
Required: inputType (string) [image|text]
Optional: problemImage (string), problemText (string), problemCategory (string) [mechanics|electricity-magnetism|thermodynamics|optics|waves|modern-physics|relativity|fluid-mechanics|other|auto-detect], explanationLevel (string) [final-answer|step-by-step|conceptual], unitsPreference (string) [SI|Imperial|Mixed], language (string) [english|spanish|french|hindi|arabic|chinese|custom], ...

### AI Synonym Finder
toolId: ai-synonym-finder
POST https://backend.aaddyy.com/api/ai/synonym-finder — from $0.10 per use (~10 credits); covers up to 2 similar words; +$0.01 per extra word (up to 50)
Find synonyms and multiple meanings for words, returning key-value pairs of meanings and their synonyms
Required: topic (string), similarWordsCount (integer)

## Entertainment

### AI Boyfriend Designer
toolId: ai-boyfriend-designer
POST https://backend.aaddyy.com/api/ai/boyfriend-designer — $0.10 per image (~10 credits); flat price per image
Design and generate your dream boyfriend character with AI - customize every detail from appearance to style
Optional: hisName (string), ageAppearance (integer), faceShape (string) [chiseled|square|oval|heart|diamond], eyeStyle (string) [sharp|smoldering|soft|piercing], eyeColor (string) [hazel|gray|amber|ice_blue|heterochromia], hairStyle (string) [messy|undercut|long_tied|buzz|wavy_top|slick_back|curtains], ...

### AI Girlfriend Designer
toolId: ai-girlfriend-designer
POST https://backend.aaddyy.com/api/ai/girlfriend-designer — $0.10 per image (~10 credits); flat price per image
Design and generate your dream girlfriend character with AI - customize every detail from appearance to style
Optional: herName (string), ageAppearance (integer), faceShape (string) [heart|oval|square|round|diamond], eyeStyle (string) [almond|doe|cat_eye|round], eyeColor (string) [blue|green|brown|violet|heterochromia], hairStyle (string) [long_straight|wavy|curly|bob|ponytail|braids|messy_bun], ...

### AI Halloween Costume Generator
toolId: ai-halloween-costume-generator
POST https://backend.aaddyy.com/api/ai/halloween-costume-generator — from $0.06 per image (~6 credits); per image; output type "All" renders 4 views at 4x the price; up to 4 images per request
Generate unique and creative Halloween costume designs using AI. Create personalized costumes for individuals, couples, families, or groups with customizable themes, styles, and accessories.
Required: prompt (string)
Optional: costume_type (string) [Individual|Couple|Group|Family], photo_upload (string): A photo of the wearer, as an http(s) link or a base64 data URI., inspiration_image (array): Up to 3 http(s) links or base64 data URIs of images to take inspiration from: 3 images at most together with photo_upload., theme (string) [Classic Horror|Fantasy|Sci-Fi|Gothic|Mythical|Pop Culture|Funny|Cute|Retro|Futuristic], character_mood (string) [Scary|Mysterious|Cute|Powerful|Funny|Elegant|Creepy|Whimsical], era (string) [Modern|Medieval|Victorian|Futuristic|Post-Apocalyptic|80s/90s Retro], ...

## Image Generation

### AI Image Generator
toolId: ai-image-generator
POST https://backend.aaddyy.com/api/ai/image-generation — $0.12 per image (~12 credits); per image; up to 4 per request
Generate high-quality images from text prompts using advanced AI models
Required: prompt (string)
Optional: aspect_ratio (string) [1:1|16:9|9:16|4:3|3:4], num_images (integer): How many images to make., seed (integer), output_format (string) [png|jpeg|webp], enhance_prompt (boolean): Add detail and quality words to the prompt before the image is made.

### AI Image Prompt Creator
toolId: ai-image-prompt-creator
POST https://backend.aaddyy.com/api/ai/image-prompt-creator — $0.10 per use (~10 credits); flat price per prompt
Analyze any image and generate a detailed AI image generation prompt to recreate it. Supports plain text or structured JSON output.
Required: imageUrl (string): An http(s) link to the image, or the image as a base64 data URI.
Optional: outputFormat (string) [normal|json]

### AI Nano Banana Creator
toolId: ai-nano-banana-2
POST https://backend.aaddyy.com/api/ai/nano-banana-2 — $0.55 per image (~55 credits); per image; up to 4 per request
Fast AI text-to-image generation. Create stunning images from text prompts with support for extreme aspect ratios and multiple outputs.
Required: prompt (string)
Optional: num_images (integer), seed (integer), aspect_ratio (string) [auto|21:9|16:9|3:2|4:3|5:4|1:1|4:5|3:4|2:3|9:16|4:1|1:4|8:1|1:8], output_format (string) [jpeg|png|webp], safety_tolerance (string) [1|2|3|4|5|6], sync_mode (boolean), ...

## Photo Editing

### AI Action Figure
toolId: ai-action-figure
POST https://backend.aaddyy.com/api/ai/action-figure — $0.07 per image (~7 credits); flat price per figure image
Transform any photo into a realistic action figure toy in blister pack packaging. Choose from 5 styles: Classic, Superhero, Barbie, LEGO, or Vintage. Add a name and accessories.
Required: image_urls (array)
Optional: name (string), accessories (string), style (string) [classic|superhero|barbie|lego|vintage], output_format (string) [png|jpeg|webp]

### AI Background Remover
toolId: ai-background-remover
POST https://backend.aaddyy.com/api/ai/background-remover — $0.02 per image (~2 credits); flat price per image
Upload an image and remove its background instantly, returning a clean transparent PNG cutout. Supports PNG, JPG, and WEBP up to 20MB.
Required: image (file)

### AI Face Swapper
toolId: ai-face-swapper
POST https://backend.aaddyy.com/api/ai/face-swapper — $0.11 per image (~11 credits); flat price per swapped image
Swap faces between photos with AI. Upload a source face and a target body image to get a seamless, photorealistic face swap result.
Required: source_image_url (string), target_image_url (string)
Optional: prompt (string), aspect_ratio (string) [auto|21:9|16:9|3:2|4:3|5:4|1:1|4:5|3:4|2:3|9:16], output_format (string) [png|jpeg|webp], consent (boolean): true confirms that you may use both faces; it is recorded with the request.

### AI Ghibli Generator
toolId: ai-ghibli-generator
POST https://backend.aaddyy.com/api/ai/ghibli-generator — $0.11 per image (~11 credits); flat price per image
Transform any photo into stunning Studio Ghibli anime art style. Upload a selfie, pet photo, or landscape and get an authentic Ghibli-style artwork instantly.
Required: image_urls (array)
Optional: prompt (string), aspect_ratio (string) [auto|21:9|16:9|3:2|4:3|5:4|1:1|4:5|3:4|2:3|9:16], output_format (string) [png|jpeg|webp]

### AI Headshot Generator
toolId: ai-headshot-generator
POST https://backend.aaddyy.com/api/ai/headshot-generator — $0.12 per image (~12 credits); flat price per headshot
Transform portrait photos into professional headshots with customizable backgrounds
Required: image_url (string): Portrait image URL or base64 data URI
Optional: background_style (string) [professional|corporate|clean|gradient], aspect_ratio (string) [1:1|16:9|9:16|4:3|3:4]: Aspect ratio in format "width:height" (e.g., "3:4", "1:1"). Backend automatically converts to required format.

### AI Nano Banana Edit
toolId: ai-nano-banana
POST https://backend.aaddyy.com/api/ai/nano-banana — from $0.605 per image (~61 credits); per image with 1 reference image; each extra reference image adds $0.055 per image
AI image editing from reference photos. Transform and edit images based on reference photos and text prompts.
Required: prompt (string), image_urls (array)
Optional: num_images (integer), aspect_ratio (string) [auto|21:9|16:9|3:2|4:3|5:4|1:1|4:5|3:4|2:3|9:16], output_format (string) [png|jpeg|webp], sync_mode (boolean), limit_generations (boolean)

### AI Product Photo Studio
toolId: ai-product-photo-studio
POST https://backend.aaddyy.com/api/ai/product-photo-studio — from $0.20 per image (~20 credits); per photo, 1 to 6 per run; the default 5 photos cost $1.00; feature images cost the same
Generate professional e-commerce product photos from casual uploads. AI-powered analysis, theme selection, and multi-angle photo generation with optional feature highlights.
Required: product_images (file): Photos of the product, as JPEG, PNG or WebP files (multipart upload).
Optional: theme (string) [ai_recommended|white_studio|light_gray_studio|black_premium|wooden_minimal|marble_luxury|natural_outdoor], num_outputs (integer), product_name (string), product_category (string), feature_highlights

### AI Upscale Image
toolId: ai-upscale-image
POST https://backend.aaddyy.com/api/ai/upscale-image — $0.12 per image (~12 credits); flat price per upscaled image
Upscale and enhance images with AI. Supports face enhancement, denoising, sharpening, and generative upscaling up to 4x.
Required: image_url (string): Public http(s) link to the image to upscale.
Optional: model (string): Enhancement mode. Leave it out to use the standard mode., upscale_factor (number), crop_to_fill (boolean), output_format (string) [jpeg|png], subject_detection (string) [All|Foreground|Background], face_enhancement (boolean), ...

### AI Watermark Remover
toolId: ai-watermark-remover
POST https://backend.aaddyy.com/api/ai/watermark-remover — $0.20 per image (~20 credits); flat price per image
Remove watermarks from images with AI image editing. Provide an image URL and get back a clean, watermark-free version.
Required: image_url (string): An http(s) link to the image, or the image as a base64 data URL (data:image/jpeg;base64,...) of at most 3 MB.

## Productivity

### AI Image Compressor
toolId: ai-image-compressor
POST https://backend.aaddyy.com/api/ai/image-compressor — free
Compress images at a Low, Recommended or High compression level: High makes the smallest file, Low keeps the most detail. Reduces file size while preserving the original format. Supports JPEG, PNG, WebP and AVIF.
Required: image (file)
Optional: quality (string) [low|recommended|high]: Compression level: high makes the smallest file, low keeps the most detail.

### AI Image to PDF
toolId: ai-image-to-pdf
POST https://backend.aaddyy.com/api/ai/image-to-pdf — free
Convert 1–20 images into a single downloadable PDF document. Each image becomes its own page. Supports JPEG, PNG, WEBP, GIF and more.
Required: images (file)

### AI PDF Merge
toolId: ai-pdf-merge
POST https://backend.aaddyy.com/api/ai/pdf-merge — free
Upload multiple PDF files and merge them into a single downloadable PDF document. Supports 2–10 files, up to 20MB each.
Required: pdfs (file)

## Seo Tools

### AI Keyword Researcher
toolId: ai-keyword-researcher
POST https://backend.aaddyy.com/api/ai/keyword-researcher — $0.20 per use (~20 credits); flat price per keyword researched
Deep keyword and domain research with SEO analysis, monetization insights, and strategic recommendations through multi-step AI analysis.
Required: keyword (string)

### AI SEO Analysis
toolId: ai-seo-analysis
POST https://backend.aaddyy.com/api/ai/seo-analysis — from $0.10 per use (~10 credits); per page analysed; $0.15 with backlink analysis
Comprehensive SEO analysis with 10 analyzers covering 60+ metrics: Meta tags, Content, Performance, Security, Mobile, Accessibility, and more. Optional backlinks analysis available.
Required: url (string): The URL to analyze (must be a valid URL)
Optional: includeBacklinks (boolean): Include backlinks analysis for deeper insights (adds $0.05 to cost)

## Social Media

### AI Caption Generator
toolId: ai-caption-generator
POST https://backend.aaddyy.com/api/ai/caption-generator — $0.02 per use (~2 credits); flat price per request, whatever the number of caption variations
Generate creative captions, social media posts, and AI prompts from images using advanced AI analysis
Required: imageUrl (string)
Optional: outputType (string) [short_caption|detailed_caption|hashtag_set|ai_prompt|story], tone (string) [funny|romantic|inspirational|professional|casual|artistic|bold|trendy|emotional|minimal], platform (string) [instagram|twitter|linkedin|facebook|pinterest|threads|custom], captionLength (string) [short|medium|long], includeEmojis (boolean), includeHashtags (boolean), ...

### Link-in-Bio Profile
toolId: link-in-bio
POST https://backend.aaddyy.com/api/profiles — $0.50 per publish (~50 credits); first publish of a profile; $0.10 per later update; drafts are free
Build your own shareable bio page (like Linktree) at aaddyy.com/profile/your-id — add your photo, bio, links and social icons, get a QR code, and switch it live or paused anytime. Building and editing drafts is free; publishing a new profile costs 50¢ and each later update costs 10¢.
Required: slug (string)
Optional: displayName (string), bio (string), theme (string) [dark|light|brand], backgroundColor (string), links (array): Each link: { title (up to 100 characters), url (2048), description (160), active, order }., socials (array): Each entry: { platform (up to 30 characters), url (2048) }.

## Video Generation

### AI Card Animator
toolId: ai-card-animator
POST https://backend.aaddyy.com/api/ai/card-animator — $0.15 per video (~15 credits); flat price per video; asking again for the same card and look within 30 days is free
Turn a card you made on AADDYY into a short 9:16 video for WhatsApp Status and Instagram Stories: an 11-second 1080x1920 MP4 plus a poster image. A gentle camera move, light catching the gold and sparkles drifting around the card, with every name, date and venue kept exactly as on your card. Pass the generationId of a card from an AADDYY card maker, such as the wedding invitation or festival greeting card maker. The look is picked from the design, or choose a preset. Asking again for the same card and look within 30 days returns the same video at no charge.
Required: sourceGenerationId (string): The generationId returned with a card made by an AADDYY card maker, such as AI Wedding Invitation Card Maker or AI Festival Greeting Card Maker (data.generationId in its response; also listed in GET /api/generations). The card must be in your own library. Image URLs are not accepted.
Optional: preset (string) [auto|golden-glow|floral-petals|festival-of-lights|winter-sparkle|crescent-night|holi-colours|celebration|baby-dreams|love-hearts]: Animation look. "auto" picks one from the card (e.g. Festival of lights for a Diwali card). GET /api/ai/card-animator/presets (public) lists them., music (string) [none]: Background music. Only "none" is available for now., format (string) [story]: Output shape: story = 9:16, 1080x1920.

### AI Seedance Video Generator
toolId: ai-seedance-video-generator
POST https://backend.aaddyy.com/api/ai/seedance-video-generator — from $0.16 per video (~16 credits); 4-second 480p video in reference-to-video mode; billed per second by quality and mode (4 to 15 seconds); a default 5-second 720p video costs $1.0667
Generate videos in three modes: text-to-video, image-to-video (1–2 frames), and reference-to-video (images + videos + audio). Pricing is per second of output, by quality and mode.
Required: mode (enum) [text-to-video|image-to-video|reference-to-video]: Generation mode. text-to-video: prompt only. image-to-video: 1–2 reference images. reference-to-video: images + videos + audio., prompt (string)
Optional: image_urls (array): Links to reference images: 1–2 for image-to-video (required there), up to 9 for reference-to-video; text-to-video takes none. A list, a JSON list or links separated by commas or new lines., video_urls (array): reference-to-video only: up to 3 links to reference videos., audio_urls (array): reference-to-video only: up to 3 links to reference audio, together with at least one reference image or video., images (file): Reference images uploaded as files (multipart) instead of image_urls; the same limits apply., videos (file): Reference videos uploaded as files (multipart) instead of video_urls., audio (file): Reference audio uploaded as files (multipart) instead of audio_urls., ...

---

## Accounts, Verification & Limits

- Signup: POST /api/auth/quick-register {"email"} (agents) or POST /api/auth/register {username, email, password}. Free credits included, no card. Disposable email domains are rejected.
- Unverified accounts CAN: create 1 bounded API key, spend a small slice of the free credits (cap in the 403 details when reached).
- Verification lifts all bounds: emailed link (one human click) OR the OTP relay (POST /api/auth/send-otp → human reads code → POST /api/auth/verify-otp). Poll GET /api/auth/check-verification.
- Per-key spend caps: create keys with {"spendLimit": 5} (USD) to bound an agent's blast radius; PUT /api/users/api-keys/{id} to change. KEY_SPEND_LIMIT_REACHED (403) when hit.

## Billing

- 1 credit = $0.01 USD. Each tool below lists the price of its cheapest valid request; "from" means options (length, quality, extra images) raise it, and the note after the price says how. The catalog JSON carries the same numbers as priceFrom, credits, priceUnit and pricingNote.
- Failed generations are refunded automatically.
- Balance: GET /api/users/balance. Every success response also carries cost + remainingCredits.
- Top-up (one human click): POST /api/payments/checkout-session {"amountUsd": 10} → Stripe-hosted url. Auto top-up (zero clicks after setup): GET/PUT /api/payments/auto-topup.
- Retry safety: send Idempotency-Key on paid POSTs; duplicates replay, never double-charge.
- Coupons: POST /api/credits/redeem {"code": "AADDYY-..."} credits hackathon/partner codes to your balance.

## Rate Limits

- Headers (IETF draft style): ratelimit-limit, ratelimit-remaining, ratelimit-reset — on every response.
- Global: 600 req/15min per IP unauthenticated; 6,000 req/15min with a credential.
- Per key (defaults, configurable at creation): 60/min, 1,000/hour, 10,000/day. Unverified keys: 10/min, 200/day.

## SDKs & Integrations

- NPM SDK: npm install aaddyy — https://www.npmjs.com/package/aaddyy
- MCP server (Cursor / Claude Code / Windsurf): npx @aaddyy/mcp-server — https://www.npmjs.com/package/@aaddyy/mcp-server
- Both discover tools dynamically from https://backend.aaddyy.com/api/documentation/tools.

---
Generated: 2026-11-12 (auto-generated from the live tool catalog)
Source of truth: https://backend.aaddyy.com/api/documentation/tools