AI T-Shirt Designer API

Generate custom, print-ready T-shirt artwork using AI with text prompts, brand assets, style preferences, and realistic mockups.

design toolsFrom 6 creditsv1.0.0

Endpoint

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

Authentication

header
Authorization: Bearer YOUR_API_KEY

Parameters

Required

promptstringrequired

Optional

design_typestring

Values: Graphic ArtworkTypography-OnlyLogo-BasedPattern Design

inspiration_imagearray

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

logo_imagestring

Your logo, as an http(s) link or a base64 data URI (PNG, JPG, WebP or SVG).

logo_placementstring

Values: Top LeftTop RightBottom CenterSleeveBack NeckIntegrated in Design

art_stylestring

Values: MinimalistVintageStreetwearCartoonAbstractRealisticRetroGrungePop ArtAnimeCyberpunk

moodstring

Values: FunBoldMotivationalAestheticWhimsicalChill

target_audiencestring

Values: CasualStreetwearSportsMinimalistKidsUnisex

design_placementstring

Values: Front CenterBack CenterPocket AreaSleeveFull Wrap

tshirt_colorstring

Garment colour as a hex code.

include_textboolean

Print text_content on the design.

text_contentstring

The text to print; required when include_text is true.

text_font_stylestring

Values: Bold SansHandwrittenGraffitiSerifRetro

text_placementstring

Values: TopBottomCenter

text_colorstring

Text colour as a hex code.

text_effectsstring

Any of Outline, Shadow and Gradient, separated by commas.

apparel_typestring

Values: T-shirtHoodieTank TopSweatshirtPoloLong Sleeve

mockup_stylestring

Values: Flat LayOn Male ModelOn Female ModelOn Mannequin3D Floating

creativity_levelinteger
aspect_ratiostring

Values: 1:14:33:22:34:53:416:9

output_formatstring

Values: pngjpegwebp

num_imagesinteger

Example Request

cURL
curl -X POST https://backend.aaddyy.com/api/ai/t-shirt-designer \
  -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 T-Shirt Designer completed successfully",
  "timestamp": "2026-11-13T13:37:23.287Z",
  "requestId": "req_avkkdafpi",
  "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/t-shirt-designer', {
  "prompt": "A serene mountain landscape at sunset",
  "num_images": 1
})

Install: npm install aaddyy

Pricing

$0.06 per image (6 credits)

per design image; up to 4 per request

Rate Limits

10 requests per 1m

Burst: 3