AI Halloween Costume Generator API

Generate unique and creative Halloween costume designs using AI. Create personalized costumes for individuals, couples, families, or groups with customizable themes, styles, and accessories.

entertainmentFrom 6 creditsv1.0.0

Schema

LLMs

Open Markdown content Open in ChatGPT Open in Claude

Endpoint

endpoint

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

Authentication

header

Authorization: Bearer YOUR_API_KEY

Parameters

Required

promptstringrequired

Optional

costume_typestring

Values: IndividualCoupleGroupFamily

photo_uploadstring

A photo of the wearer, as an http(s) link or a base64 data URI.

inspiration_imagearray

Up to 3 http(s) links or base64 data URIs of images to take inspiration from: 3 images at most together with photo_upload.

themestring

Values: Classic HorrorFantasySci-FiGothicMythicalPop CultureFunnyCuteRetroFuturistic

character_moodstring

Values: ScaryMysteriousCutePowerfulFunnyElegantCreepyWhimsical

erastring

Values: ModernMedievalVictorianFuturisticPost-Apocalyptic80s/90s Retro

gender_fitstring

Values: FeminineMasculineAndrogynousKids

group_coordinationstring

accessory_preferencesarray

Accessories to include, any of Mask, Makeup, Hat, Cape, Armor, Jewelry, Props and Wings.

Values: MaskMakeupHatCapeArmorJewelryPropsWings

color_palettearray

Colours to use, any of Black, Red, Purple, Gold, White, Green, Orange, Blue and Silver.

Values: BlackRedPurpleGoldWhiteGreenOrangeBlueSilver

material_preferencestring

Values: FabricLeatherMetallicPlasticOrganicEthereal / Magic Glow

body_type_adaptationboolean

creativity_levelinteger

output_typestring

Values: Costume Concept ImageFull Body RenderMakeup Close-UpAccessories LayoutAll

num_imagesinteger

aspect_ratiostring

Values: 1:12:33:24:55:416:99:16

output_formatstring

Values: pngjpegwebp

Example Request

cURL

curl -X POST https://backend.aaddyy.com/api/ai/halloween-costume-generator \
  -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 Halloween Costume Generator completed successfully",
  "timestamp": "2026-11-13T08:40:24.498Z",
  "requestId": "req_g1gelpipz",
  "data": {
    "cost": 0.06,
    "remainingCredits": 9.95
  }
}

SDK

javascript

import { AADDYY } from 'aaddyy'

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

Install: npm install aaddyy

Pricing

$0.06 per image (6 credits)

per image; output type "All" renders 4 views at 4x the price; up to 4 images per request

Rate Limits

20 requests per 3600

Burst: 5

← Back to all endpoints