Developer Platform

ZukMe API

Bring Runway Edit and StyleMe's AI fashion generation into your own product, powered by the same engine that runs the ZukMe app, available over a simple REST API. Need more credits for high-volume use? Contact our team below.

Go to API Dashboard →Contact Us

Capabilities

What the API does

Runway Edit

Send us any art, photo, or design plus an outfit and scene direction, and we generate a photorealistic fashion editorial image of a model wearing an outfit built from your source image, styled to your creative direction. Returns a job that you poll until the finished image is ready.

StyleMe

Send us a photo and we return a personalized style reading: a stylist-grade read on the person's colouring, proportions, and aesthetic, generated by our vision AI. Also returns a job that you poll until the reading is ready.

Two products, one account

Match & render — choose your source

StyleMe can put real, purchasable garments on your user's photo — sourced either from ZukMe's own marketplace, or from a product catalog you push us yourself. Same account, same credits, same Runway Edit and StyleMe endpoints either way — pick the docs for the source you need.

Match against ZukMe's own marketplace

Pull from Marketplace

StyleMe matches real pieces from ZukMe's marketplace — its own listings blended with affiliate products — and puts them on your user's photo.

API Docs →

Match against your own catalog

Use My Own Inventory

Push your own product catalog (Shopify, a custom DB, any CRM) to us once. Every matched piece comes from your inventory instead — and the final look is delivered back to you.

API Docs →

Billing

Credits & pricing

Every ZukMe account can create an API key today, with nothing to request or wait on. API usage draws from the exact same credit balance as the app itself, using your existing subscription (GLIMPSE, GLANCE, FOCUS, or FRAME), with no separate API metering system. Any bonus credits on your account (which never expire) can be spent through the API or the app interchangeably. Each successful Runway Edit or StyleMe call costs 1 credit, refunded automatically if generation fails. See pricing for subscription tiers.

For Apps, Products & Enterprise

Need more volume than your subscription covers?

Talk to our team about Pay-as-you-Go API credits. Once arranged, we add them straight to your account, and they work exactly like any other credits, shared across the API and the app.

Quick Start

Getting started

1Sign in to your ZukMe account and open the API Dashboard.
2Create an API key and copy it immediately, it's shown only once.
3Call the endpoint for the feature you need, passing the key as a bearer token.
4Poll the same endpoint with your jobId until the job is done.

bash

curl https://zukme.com/api/v1/runway-edit \
  -X POST \
  -H "Authorization: Bearer zk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "artPhotoBase64": "<base64>",
    "outfitName": "Tailored Blazer Set",
    "outfitDirection": "structured double-breasted blazer, wide-leg trousers",
    "sceneName": "Golden Hour Rooftop",
    "styleDirection": "warm, cinematic, editorial"
  }'

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

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

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

Reference

Endpoints

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

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

Runway Edit and StyleMe are shared by both API products above. Match + render (putting real garments on your user) has its own endpoint per source — see Pull from Marketplace Docs or Use My Own Inventory Docs for full field-by-field schemas, error codes, and copy-paste examples.

Monitoring

Usage & limits

Each API key tracks its own call count and credits spent, plus your account's overall usage, visible any time in the API Dashboard. Requests are rate-limited per key to keep the API fair and responsive for everyone — 30 requests per minute, see either product's docs for the exact error shape.