The New Black AI

AI Fashion Models API

Product to Model — workflow

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.

ParameterValue for this workflow
workflow"product_to_model-v1" required
product_imagesProducts — up to 3 public HTTPS URLs.required
model_imageModel image — one public HTTPS URL.
scene_imageScene — one public HTTPS URL.
fields.seg_framingFraming. 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.genderGender. Who wears it.Woman · Man · Girl · BoyDefaults to “Woman”.
fields.seg_lookStyling details. Optional styling details — what else is worn with your products, e.g. "a beige trench coat, gold hoops".
fields.body_shapeBody shape. The model's build. Leave it out for a mid-size build.Small size · Mid size · Plus size · PregnantDefaults to “Mid size”.
fields.ageAge. The model's age.3 · 5 · 7 · 10 · 13 · 16 · 20 · 25 · 30 · 35 · 40 · 45 · 50 · 55 · 60Defaults to “25”.
fields.originOrigin. The model's origin — a country name, e.g. "Italy".Defaults to “Italy”.
fields.seg_featuresPhysical features. Short sentences about the person and the pose — e.g. "Chin up. Back view."
fields.seg_sceneDescribed scene. The scene around the person, in words — e.g. "a rooftop terrace at dusk". Used with the Scene described variants; ignored when you send scene_image.
fields.seg_cameraCamera angle. Where the camera stands: auto, eye_level, slightly_above, slightly_below or low_ground. Leave it out for auto.auto · eye_level · slightly_above · slightly_below · low_ground
ratio21: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_urlOptional — 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": "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",
      "seg_camera": "auto"
    },
    "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.

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