← API overviewAPI Product

Pull from Marketplace

Send us a photo and a creative direction. Runway Edit generates the outfit, StyleMe matches it against real products from ZukMe's marketplace — its own listings blended with affiliate products — and returns a photorealistic image of your user wearing the closest real match, per piece, with product name, shop, and price attached.

Go to API Dashboard →API Docs

Capabilities

What it does

Runway Edit

Any art, photo, or design plus an outfit and scene direction becomes a photorealistic fashion editorial image, styled to your creative direction.

StyleMe

A photo becomes a stylist-grade style reading: colouring, proportions, and aesthetic, feeding directly into what the marketplace match looks for.

Marketplace Try-On

A reading plus a photo becomes a rendered look built from the best-matching real marketplace product per garment category, worn by your user.

Try-on in three calls

Quick start

Get a StyleMe reading, then submit it to the marketplace try-on endpoint along with the same photo. Poll until the rendered image is ready.

bash

curl https://zukme.com/api/v1/marketplace/tryon \
  -X POST \
  -H "Authorization: Bearer zk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "reading": { /* from POST /api/v1/styleme */ },
    "photoBase64": "<base64>",
    "occasion": "Weekend brunch"
  }'

# response: { "ok": true, "jobId": "...", "status": "processing" }

curl https://zukme.com/api/v1/marketplace/tryon \
  -X POST \
  -H "Authorization: Bearer zk_live_..." \
  -H "Content-Type: application/json" \
  -d '{ "action": "poll", "jobId": "..." }'

# response: { "ok": true, "status": "done", "imageUrl": "https://...", "outfitBreakdown": [...] }

Reference

Endpoints

POST /api/v1/runway-editsubmit or poll a Runway Edit generation job

POST /api/v1/stylemesubmit or poll a StyleMe reading job

POST /api/v1/marketplace/tryonsubmit or poll a marketplace match + render job

Full field-by-field request/response schemas, error codes, and copy-paste examples are in the API Docs. Looking to match against your own catalog instead? Use My Own Inventory — same account, same credits.