The New Black AI

Flat Lay API

Image to Flat Lay workflow

From any garment photo to a styled flat-lay product shot, laid out and lit like a catalogue page.

From $0.054 per image · 1 credit on the standard tier

How it works

  1. 1. Create an API key

    Sign up and create a key in your profile, under API. It starts with tnb_live_ and goes in the Authorization header. Creating a key needs no plan.

  2. 2. Send the request

    One POST /v1/generate with the workflow image_to_flat_lay-v1 and your pictures as public HTTPS URLs. Every value below is one this endpoint accepts.

    curl -X POST https://thenewblack.ai/api/v1/generate \
      -H "Authorization: Bearer tnb_live_XXXXXXXXXXXX" \
      -H "Content-Type: application/json" \
      --data-binary @- <<'JSON'
    {
      "workflow": "image_to_flat_lay-v1",
      "garment_image": "https://example.com/garment.jpg",
      "fields": {
        "garmenttorecreate": "the denim jacket"
      },
      "ratio": "1:1",
      "tier": "standard"
    }
    JSON
  3. 3. Get the result

    The call answers at once with a generation_id. Poll GET /v1/generations/{id} until the status settles, or send a webhook_url and we POST the outcome to it.

    // 202 Accepted
    {
      "generation_id": "3f1c9a6e-...",
      "status": "running",
      "poll": "/api/v1/generations/3f1c9a6e-..."
    }
    
    // GET /v1/generations/3f1c9a6e-...  →  200 OK
    {
      "generation_id": "3f1c9a6e-...",
      "workflow": "image_to_flat_lay",
      "status": "succeeded",
      "result": {
        "type": "image",
        "url": "https://.../result.webp",
        "thumbnail": "https://.../thumb.webp"
      }
    }

    Results stay 48 hours on our URL: copy them to your own storage. Authentication, errors and webhooks are documented in the full API reference.

Parameters

POST/v1/generateworkflow: image_to_flat_lay-v1

One endpoint serves every workflow; this page documents image_to_flat_lay-v1, the current version. Earlier versions, if any, keep being served under their own names.

ParameterValue for this workflow
workflow"image_to_flat_lay-v1" required
garment_imageProduct image — one public HTTPS URL.required
fields.garmenttorecreateProduct to recreate. Which product in the photo to lay flat, e.g. "the denim jacket" or "the scarf".
ratio1:1 · 9:16 · 2:3 · 3:4 · 3:2 · 4:3
tier"standard" (1 cr), "pro" (3 cr) or "ultra" (7 cr) — a 4K picture, from the Pro plan
webhook_urlOptional — we POST the outcome here when the generation settles. Without it, poll the URL returned in the response until the status settles.

Pricing

TierCreditsWhat it makesFrom
standard1 cr1K resolution image + fast generation$0.054
pro3 cr2K resolution image + thinking process before generating$0.16
ultra7 cr4K resolution image + deep thinking process before generating · from the Pro plan$0.38

Credits are debited when the request is accepted, a fixed price per generation; a failed generation is refunded automatically. Dollar prices are at the best credit price, $0.054 a credit (Enterprise, billed yearly). Credits come with plans and packs; new accounts start with free credits.

From Claude and from the terminal

The same workflow is the image_to_flat_lay tool of our MCP server for Claude, and tnb generate image_to_flat_lay in our command line (the CLI tab above), with the same parameters and the same prices.

Frequently asked questions

What does the flat lay endpoint return?

The garment from your photo re-rendered as a top-down flat-lay packshot on a clean surface.

How much does it cost?

1 credit per generation on the standard tier, 3 on pro, 7 on ultra: a fixed price per generation. At $0.054 a credit (Enterprise, billed yearly), that is $0.054 per image on standard. 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