AI Image Prompt Creator API

Analyze any image and generate a detailed AI image generation prompt to recreate it. Supports plain text or structured JSON output.

image generation10 creditsv1.0.0

Endpoint

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

Authentication

header
Authorization: Bearer YOUR_API_KEY

Parameters

Required

imageUrlstringrequired

An http(s) link to the image, or the image as a base64 data URI.

Optional

outputFormatstring

Values: normaljson

Default: normal

Example Request

cURL
curl -X POST https://backend.aaddyy.com/api/ai/image-prompt-creator \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "imageUrl": "example_imageUrl"
  }'

Request Body

json
{
  "imageUrl": "example_imageUrl"
}

Example Response

json
{
  "success": true,
  "message": "AI Image Prompt Creator completed successfully",
  "timestamp": "2026-11-13T08:40:24.487Z",
  "requestId": "req_hwqv4218o",
  "data": {
    "cost": 0.1,
    "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-prompt-creator', {
  "imageUrl": "example_imageUrl"
})

Install: npm install aaddyy

Pricing

$0.10 per use (10 credits)

flat price per prompt

Rate Limits

10 requests per 1m

Burst: 3