AI Fashion Models API

Put your product on an AI-generated fashion model: send the product image, describe the model and the scene, get an e-commerce-ready photo.

Get an API key Claude MCP

POST/v1/generateworkflow: product_to_model-v1

One endpoint serves every workflow — this page documents product_to_model-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	"product_to_model-v1" required
product_images	Products — up to 3 public HTTPS URLs.required
model_image	Model image — one public HTTPS URL.
scene_image	Scene — one public HTTPS URL.
fields.seg_framing	Framing. How the shot is framed, in a few words — e.g. "full body" or "close-up on the hands". Leave it out for auto framing.
fields.gender	Gender. Who wears it.Woman · ManDefaults to “Woman”.
fields.seg_look	Optional styling details — what else is worn with your products, e.g. "a beige trench coat, gold hoops".

Example request

curl -X POST https://thenewblack.ai/api/v1/generate \
  -H "Authorization: Bearer tnb_live_XXXXXXXXXXXX" \
  -H "Content-Type: application/json" \
  -d '{
    "workflow": "product_to_model-v1",
    "product_images": ["https://example.com/product.jpg"],
    "model_image": "https://example.com/model.jpg",
    "scene_image": "https://example.com/scene.jpg",
    "fields": {
      "seg_framing": "full body",
      "gender": "Woman",
      "seg_look": "a beige trench coat, gold hoops",
      "body_shape": "Mid size",
      "age": "25",
      "origin": "Italy",
      "seg_features": "Chin up. Back view.",
      "seg_scene": "a rooftop terrace at dusk"
    },
    "ratio": "4:5",
    "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": "product_to_model",
  "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 fashion model API?

An endpoint that generates photorealistic fashion-model photography from your product image — no photoshoot, no model booking.

Can I control the model's look?

Yes — age, gender, pose, setting and light are all described in the prompt.

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