AI Caption Generator API

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

social media2 creditsv1.0.0

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-11-13T08:40:25.288Z",
  "requestId": "req_le0kr94rl",
  "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

$0.02 per use (2 credits)

flat price per request, whatever the number of caption variations

Rate Limits

20 requests per 60000

Burst: 5

← Back to all endpoints