AI Jewelry Designer API

Create unique jewelry designs using AI. Select materials, styles, gemstones, and custom settings to generate concept art or detailed design visualizations for rings, necklaces, earrings, bracelets, and more.

design toolsFrom 5 creditsv1.0.0

Endpoint

endpoint
POST https://backend.aaddyy.com/api/ai/jewelry-designer

Authentication

header
Authorization: Bearer YOUR_API_KEY

Parameters

Required

jewelry_typeenumrequired

Values: ringnecklaceearringbraceletpendantankletbroochtiaracufflinksnose_ringmaang_tikkawaist_beltarmlethair_pinwatch_charmjhumkachandbalimangalsutramatha_pattihaath_phoolbichhiyakalirechokerrani_haarbanglekadatasbihtennis_braceletsignet_ringeternity_bandcharm_braceletcameoevil_eyejade_banglelongevity_lockcustom

design_styleenumrequired

Values: classicmodernminimalistvintageroyalart_decobohemianethnicluxurynature_inspiredkundanpolkitemplemeenakarijadauvictoriancontemporarygothicsteampunkgeometricabstractindustrialcyberpunkneo_heritageindo_westernmughalrajasthanisouth_indianbengalimaharashtriannavratnapachchikamthewafiligreenakshiguttapusaluguochaoottomanbyzantineetruscanflorentinescandinavian

materialenumrequired

Values: gold_yellowgold_rosegold_whiteplatinumsilvertitaniumcoppermixed_metalsbronzebrasswoodleatherceramiccarbon_fiberresinglassenamelblack_goldgreen_gold22k_gold24k_goldoxidized_silverrudrakshterracottasilk_threadshellvermeilmurano_glass

Optional

gemstonesarray

Values: diamondlab_grown_diamondmoissaniteemeraldrubysapphirepearlamethystopalturquoisetopazgarnettanzaniteaquamarineperidotcitrinemoonstoneonyxlapis_lazulijadecoralamberquartzspineltourmalinezirconcubic_zirconiaswarovski_crystalpolki_uncutsalt_and_pepper_diamondblack_diamondzultaniteagatemalachitenone

target_audienceenum

Values: womenmenunisexkidsseniorsteenscouplespetsbridegroom

occasionenum

Values: engagementweddingdaily_wearpartygiftanniversaryfestivalformalgraduationred_carpetcorporatebaby_showerreligiousdate_nightcasualphotoshootsangeethaldireceptionoffice_wearcollege_weardhanteraseiddiwalikarva_chauth

design_descriptionstring
complexityenum

Values: minimalmoderateintricate

color_paletteenum

Values: neutralpastelboldmonochromewarmcoolvibrant

price_rangeenum

Values: economymid_rangepremiumluxury

output_typeenum

Values: concept_sketchrealistic_renderlifestyle_imagemarketing_image

engraving_textstring
cultural_influenceenum

Values: indianwesternarabicjapaneseafricanfusionchineseegyptiangreekcelticmayannative_americanpersianrussianitalianturkishvietnamesethaikorean

num_imagesinteger
aspect_ratioenum

Values: 1:14:33:216:99:163:44:5

Default: 1:1

output_formatenum

Values: jpegpngwebp

Default: jpeg

Example Request

cURL
curl -X POST https://backend.aaddyy.com/api/ai/jewelry-designer \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "jewelry_type": "ring",
    "design_style": "classic",
    "material": "gold_yellow",
    "num_images": 1
  }'

Request Body

json
{
  "jewelry_type": "ring",
  "design_style": "classic",
  "material": "gold_yellow",
  "num_images": 1
}

Example Response

json
{
  "success": true,
  "message": "AI Jewelry Designer completed successfully",
  "timestamp": "2026-11-13T08:40:23.119Z",
  "requestId": "req_p7c90uef3",
  "data": {
    "cost": 0.05,
    "remainingCredits": 9.95
  }
}

SDK

javascript
import { AADDYY } from 'aaddyy'

const client = new AADDYY()
const result = await client._request('POST', '/api/ai/jewelry-designer', {
  "jewelry_type": "ring",
  "design_style": "classic",
  "material": "gold_yellow",
  "num_images": 1
})

Install: npm install aaddyy

Pricing

$0.05 per image (5 credits)

per design image; up to 4 per request