APIDOCUMENTATION

100+ AI tools via REST API. Pay-per-use pricing (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 -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:

Authorization: Bearer aip_YOUR_API_KEY

API keys start with aip_. Email verification is required before creating keys. Google/Auth0 users are auto-verified.

Swagger UI

Interactive API explorer

OpenAPI JSON

Machine-readable spec

Get API Key

Create & manage keys

NPM SDK

npm install aaddyy

API Endpoints

Async Tools (V2)

Some tools (video, image editing, upscaling) use async processing:

  1. 1. POST /api/v2/ai/{tool-name} — returns { jobId, pollUrl }
  2. 2. GET /api/v2/ai/jobs/{jobId} — poll every 2s until status is "completed"

The AADDYY SDK and MCP server handle this automatically — you get the final result without manual polling.

Rate Limits

Default per API key:

  • 60 requests per minute
  • 1,000 requests per hour
  • 10,000 requests per day

Response headers: X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset