AI Headshot GeneratorAPI

Transform portrait photos into professional headshots with customizable backgrounds

photo editing~12 credits/callv1.0.0

Endpoint

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

Authentication

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 -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

{
  "image_url": "example_image_url"
}

Example Response

{
  "success": true,
  "message": "AI Headshot Generator completed successfully",
  "timestamp": "2026-04-01T22:35:20.102Z",
  "requestId": "req_frpq7yf3y",
  "data": {
    "cost": 0.12,
    "remainingCredits": 9.95
  }
}

SDK

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

~12 credits (~$0.12) per request

Rate Limits

10 requests per 1m

Burst: 3

← Back to all endpoints