AI Caption GeneratorAPI

Generate creative captions, social media posts, and AI prompts from images using advanced AI analysis

social media~2 credits/callv1.0.0

Endpoint

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

Authentication

Authorization: Bearer YOUR_API_KEY

Parameters

Required

imageUrlstringrequired

Optional

outputTypestring

Values: short_captiondetailed_captionhashtag_setai_promptstory

Default: short_caption

tonestring

Values: funnyromanticinspirationalprofessionalcasualartisticboldtrendyemotionalminimal

Default: trendy

platformstring

Values: instagramtwitterlinkedinfacebookpinterestthreadscustom

Default: instagram

captionLengthstring

Values: shortmediumlong

Default: medium

includeEmojisboolean

Default: true

includeHashtagsboolean

Default: true

numberOfHashtagsinteger

Default: 5

customKeywordsarray

languagestring

Values: englishspanishfrenchhindigermanitalianjapanese

Default: english

numberOfVariationsinteger

Default: 3

captionFocusstring

Values: objectemotionsceneconceptual

Default: emotion

customPromptModifierstring

nsfwFilterboolean

Default: true

Example Request

curl -X POST https://backend.aaddyy.com/api/ai/caption-generator \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "imageUrl": "example_imageUrl",
    "tone": "trendy"
  }'

Request Body

{
  "imageUrl": "example_imageUrl",
  "tone": "trendy"
}

Example Response

{
  "success": true,
  "message": "AI Caption Generator completed successfully",
  "timestamp": "2026-04-01T22:35:07.221Z",
  "requestId": "req_y2x715crp",
  "data": {
    "cost": 0.02,
    "remainingCredits": 9.95
  }
}

SDK

import { AADDYY } from 'aaddyy'

const client = new AADDYY()
const result = await client._request('POST', '/api/ai/caption-generator', {
  "imageUrl": "example_imageUrl",
  "tone": "trendy"
})

Install: npm install aaddyy

Pricing

~2 credits (~$0.02) per request

Rate Limits

20 requests per 60000

Burst: 5

← Back to all endpoints