Fabric to Design API

POST/v1/generateworkflow: fabric_to_design-v1

One endpoint serves every workflow — this page documents fabric_to_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	"fabric_to_design-v1" required
fabric_image	Your fabric — one public HTTPS URL.required
fields.age	Age. The model's age (On model variant).20 · 25 · 30 · 35 · 40 · 45 · 50 · 55 · 60Defaults to “25”.
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.garmentwithfabric	Garment with fabric. The garment to drape this fabric on — e.g. "an oversized shirt".
fields.optionalgarment	Complete the look. Optional — what completes the look, e.g. "black tailored trousers".
variant	On model · Design 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.

Example request

curl -X POST https://thenewblack.ai/api/v1/generate \
  -H "Authorization: Bearer tnb_live_XXXXXXXXXXXX" \
  -H "Content-Type: application/json" \
  -d '{
    "workflow": "fabric_to_design-v1",
    "fabric_image": "https://example.com/fabric.jpg",
    "fields": {
      "age": "25",
      "gender": "Woman",
      "country": "Italy",
      "garmentwithfabric": "an oversized shirt",
      "optionalgarment": "black tailored trousers"
    },
    "variant": "On model",
    "ratio": "21:9",
    "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": "fabric_to_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.

Frequently asked questions

How does fabric-to-design work?

You provide a flat photo or scan of the fabric; the endpoint drapes it onto the garment your prompt describes, preserving the print's scale and repeat.

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.

Other endpoints: Virtual Try-On API · AI Fashion Models API · Fashion Design API · Reimagine Model API · Swap Model API · AI Stylist API · all endpoints

Affiliation & Blog

Contact

Legal

Example request

Example response

Frequently asked questions

How does fabric-to-design work?

How much does it cost?