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

Schema

LLMs

Open Markdown content Open in ChatGPT Open in Claude

Endpoint

endpoint

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

Authentication

header

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

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

json

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

Example Response

json

{
  "success": true,
  "message": "AI Caption Generator completed successfully",
  "timestamp": "2026-05-16T12:19:13.480Z",
  "requestId": "req_q2ot0nsti",
  "data": {
    "cost": 0.02,
    "remainingCredits": 9.95
  }
}

SDK

javascript

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