AADDYY

AI Headshot Generator API

Transform portrait photos into professional headshots with customizable backgrounds.

photo editing12 creditsv1.0.0
Schema
LLMs
Open Markdown contentOpen in ChatGPTOpen in Claude

Endpoint

endpoint
POST https://backend.aaddyy.com/api/ai/headshot-generator

Authentication

header
Authorization: Bearer YOUR_API_KEY

Parameters

Required

image_urlstringrequired

Portrait image URL or base64 data URI

Optional

background_stylestring

Values: professionalcorporatecleangradient

Default: professional

aspect_ratiostring

Aspect ratio in format "width:height" (e.g., "3:4", "1:1"). Backend automatically converts to required format.

Values: 1:116:99:164:33:4

Example Request

cURL
curl -X POST https://backend.aaddyy.com/api/ai/headshot-generator \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "image_url": "example_image_url"
  }'

Request Body

json
{
  "image_url": "example_image_url"
}

Example Response

json
{
  "success": true,
  "message": "AI Headshot Generator completed successfully",
  "timestamp": "2026-11-13T08:40:24.807Z",
  "requestId": "req_l89jgyzec",
  "data": {
    "cost": 0.12,
    "remainingCredits": 9.95
  }
}

SDK

javascript
import { AADDYY } from 'aaddyy'

const client = new AADDYY()
const result = await client._request('POST', '/api/ai/headshot-generator', {
  "image_url": "example_image_url"
})

Install: npm install aaddyy

Pricing

$0.12 per image (12 credits)

flat price per headshot

Rate Limits

10 requests per 1m

Burst: 3

← Back to all endpoints