AI Image Generator API

Generate high-quality images from text prompts using advanced AI models.

image generationFrom 12 creditsv1.0.0

Endpoint

endpoint
POST https://backend.aaddyy.com/api/ai/image-generation

Authentication

header
Authorization: Bearer YOUR_API_KEY

Parameters

Required

promptstringrequired

Optional

aspect_ratiostring

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

Default: 1:1

num_imagesinteger

How many images to make.

Default: 1

seedinteger
output_formatstring

Values: pngjpegwebp

Default: png

enhance_promptboolean

Add detail and quality words to the prompt before the image is made.

Default: false

Example Request

cURL
curl -X POST https://backend.aaddyy.com/api/ai/image-generation \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A serene mountain landscape at sunset",
    "num_images": 1
  }'

Request Body

json
{
  "prompt": "A serene mountain landscape at sunset",
  "num_images": 1
}

Example Response

json
{
  "success": true,
  "message": "AI Image Generator completed successfully",
  "timestamp": "2026-11-13T21:00:31.911Z",
  "requestId": "req_9pd4gn1fw",
  "data": {
    "cost": 0.12,
    "remainingCredits": 9.95,
    "images": [
      {
        "url": "https://example.com/generated-image-xyz.png",
        "size": "1024x1024",
        "format": "png"
      }
    ],
    "numImages": 1
  }
}

SDK

javascript
import { AADDYY } from 'aaddyy'

const client = new AADDYY()
const result = await client._request('POST', '/api/ai/image-generation', {
  "prompt": "A serene mountain landscape at sunset",
  "num_images": 1
})

Install: npm install aaddyy

Pricing

$0.12 per image (12 credits)

per image; up to 4 per request

Rate Limits

20 requests per 1m

Burst: 5