AADDYY
API Reference

API Documentation

100+ 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_. Email verification is required. Google/Auth0 users are auto-verified.

Get API Key

Create & manage keys

NPM SDK

npm install aaddyy

API Endpoints

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

Headers: X-RateLimit-LimitX-RateLimit-RemainingX-RateLimit-Reset