Generate original clothing, jewelry, shoes or accessory designs from a text prompt — the studio's core design workflow, as an endpoint.
/v1/generateworkflow: create_design-v1One endpoint serves every workflow — this page documents create_design-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 | "create_design-v1" required |
| fields.age | Age. The model's age (On model variant).20 · 25 · 30 · 35 · 40 · 45 · 50 · 55 · 60Defaults to “25”. |
| fields.bodyform | Body Shape. The model's build (On model variant).Small size · Mid size · Plus size · PregnantDefaults to “Mid size”. |
| fields.gender | Gender. Who wears it (On model variant).Woman · ManDefaults to “Woman”. |
| fields.country | From. The model's origin — a country name (On model variant).Defaults to “Italy”. |
| fields.craziness | Creative booster. Creative intensity, 0 to 100 — 0 keeps it classic; higher adds sculptural, surreal energy.Defaults to “0”. |
| fields.outfit | Product description. The piece itself, precisely — fabric, cut, detail; e.g. "pastel elegant cropped jacket, transparent with high collar".Defaults to “Pastel elegant cropped jacket, transparent with high collar”. |
| fields.seg_look | Complete the look. Optional — what completes the look around the piece (On model variant), e.g. "white wide-leg trousers". |
| fields.seg_view | Side. Garment only: which side(s) to show. Leave it out for the front.Front · Front and Back |
| variant | On model · Product only |
| ratio | 21:9 · 16:9 · 3:2 · 4:3 · 5:4 · 1:1 · 4:5 · 3:4 · 2:3 · 9:16 |
| tier | "standard" (1 cr) or "pro" (3 cr) |
| webhook_url | Optional — we POST the outcome here when the generation settles. Without it, poll the URL returned in the response until the status settles. |
curl -X POST https://thenewblack.ai/api/v1/generate \
-H "Authorization: Bearer tnb_live_XXXXXXXXXXXX" \
-H "Content-Type: application/json" \
-d '{
"workflow": "create_design-v1",
"fields": {
"age": "25",
"bodyform": "Mid size",
"gender": "Woman",
"country": "Italy",
"craziness": "0",
"outfit": "pastel elegant cropped jacket, transparent with high collar",
"seg_look": "white wide-leg trousers",
"seg_view": "Front"
},
"variant": "On model",
"ratio": "1:1",
"tier": "standard"
}'// 202 Accepted
{
"generation_id": "3f1c9a6e-...",
"status": "running",
"poll": "/api/v1/generations/3f1c9a6e-..."
}Poll /v1/generations/{id} (or receive the webhook) until the generation settles:
// 200 OK
{
"generation_id": "3f1c9a6e-...",
"workflow": "create_design",
"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.
Any fashion creation a prompt can describe: garments, jewelry, watches, bags, sunglasses, shoes — as photorealistic product imagery.
Yes — the legacy per-category endpoints (ring design, shoes design, watch design…) are all served by this one workflow with the category in the prompt.
1 credit on the standard tier, 3 on pro. Credits come with plans and packs; a failed generation is always refunded.
Other endpoints: Virtual Try-On API · AI Fashion Models API · Reimagine Model API · Swap Model API · AI Stylist API · Fabric to Design API · all endpoints