AADDYY
API Reference

API Documentation

55 AI tools via REST API. Pay-per-use (1 credit = $0.01). 50 free credits on signup — no card required.

Quick Start

  1. 1Sign up at aaddyy.com/signup — get 50 free credits
  2. 2Create an API key at aaddyy.com/api-keys
  3. 3Make your first API call:
cURL
curl -X POST https://backend.aaddyy.com/api/ai/article \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"topic": "AI Tools", "tone": "professional"}'

Authentication

All API calls require an API key in the Authorization header:

header
Authorization: Bearer aip_YOUR_API_KEY

API keys start with aip_. Before you verify your email, you can create one key, with lower limits and an expiry date, and spend part of your free credits. Verify your email to unlock all your free credits and full key limits. Google/Auth0 users are auto-verified.

Get API Key

Create & manage keys

NPM SDK

npm install aaddyy

API Endpoints

Content Creation

Async Tools (V2)

Video, image editing, and upscaling use async processing:

  1. 1. Submit:
    POST /api/v2/ai/{tool-name} → { jobId, pollUrl }
  2. 2. Poll:
    GET /api/v2/ai/jobs/{jobId} → { status, result }

The AADDYY SDK and MCP server handle polling automatically.

Rate Limits

Per minute60 requests
Per hour1,000 requests
Per day10,000 requests

Per key, once your email is verified. Until then, your key has lower limits. A key over its limit gets a 401 error: “Rate limit exceeded”.

Each IP address also has a limit per 15 minutes; past it, the API answers 429. Its headers: RateLimit-Limit, RateLimit-Remaining, RateLimit-Reset