AI Stylist API

Complete head-to-toe styled looks on demand: occasion, season and style direction in, a coherent outfit out.

POST/v1/generateworkflow: ai_stylist-v1

One endpoint serves every workflow — this page documents ai_stylist-v1, the current version. Credits are debited at submission (1 cr standard, 3 cr pro); a failed generation is refunded automatically. Earlier versions of this endpoint, if any, keep being served under their own names.

Parameter	Value for this workflow
workflow	"ai_stylist-v1" required
photo_image	Your photo — one public HTTPS URL.
fields.outfit	Outfit description. The outfit to dress the person in — the heart of the request; e.g. "an elegant monochrome look with a structured blazer".required
fields.seg_occasion	Occasion. The occasion, by value — e.g. "cocktail party". The route phrases it into the prompt.baby shower · beach · birthday celebration · brunch · casual weekend · christmas · cocktail party · date night · festival concert · formal gala · funeral · graduation · new year party · night club · outdoor picnic · sport workout · rainy day · religious ceremony · school · snowing day · summer holidays · travel business · travel casual · university · wedding · winter holidays · work/office
fields.seg_style	My style. Your style in a few words — e.g. "quiet luxury, clean lines".

Example request

curl -X POST https://thenewblack.ai/api/v1/generate \
  -H "Authorization: Bearer tnb_live_XXXXXXXXXXXX" \
  -H "Content-Type: application/json" \
  -d '{
    "workflow": "ai_stylist-v1",
    "photo_image": "https://example.com/photo.jpg",
    "fields": {
      "outfit": "an elegant monochrome look with a structured blazer",
      "seg_occasion": "cocktail party",
      "seg_style": "quiet luxury, clean lines",
      "seg_palette": "soft_summer"
    },
    "variant": "Dress me",
    "ratio": "auto",
    "tier": "standard"
  }'

// 202 Accepted
{
  "generation_id": "3f1c9a6e-...",
  "status": "running",
  "poll": "/api/v1/generations/3f1c9a6e-..."
}

Example response

Poll /v1/generations/{id} (or receive the webhook) until the generation settles:

// 200 OK
{
  "generation_id": "3f1c9a6e-...",
  "workflow": "ai_stylist",
  "status": "succeeded",
  "result": {
    "type": "image",
    "url": "https://.../result.webp",
    "thumbnail": "https://.../thumb.webp"
  }
}

Results are stored for 48 hours — copy them to your own storage. Authentication, errors and webhooks are documented in the full API reference.

Frequently asked questions

What is an AI stylist API?

An endpoint that assembles a complete, coherent outfit — layered pieces, matched palette, shoes included — for an occasion and style you specify.

How much does it cost?

1 credit on the standard tier, 3 on pro. Credits come with plans and packs; a failed generation is always refunded.

Affiliation & Blog

Contact

Legal