ZukMe API

Pick your flow

Getting started

1. 1Sign in and open the API Dashboard — create an API key instantly, copy it immediately, it's shown only once.
2. 2Contact our team to get credits on your account — a new key starts with none, and API/embed usage draws from bonus credits only (see Credits below).
3. 3Pick a flow above and follow it start to finish.
4. 4Most flows are async: submit, then poll with your jobId until done.

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://..." }

Credits & pricing

Anyone can create an API key instantly from the API Dashboard — but a new key starts with 0 credits. Contact our team to get credits added to your account before building against this in production. Each key tracks its own calls and credits in the Dashboard. See pricing for tiers.

Check the balance your key bills against programmatically — free, never costs a credit:

curl https://zukme.com/api/v1/credits \
  -H "Authorization: Bearer zk_live_..."

# {
#   "ok": true,
#   "plan": null,
#   "credits": { "looks": 0, "bonus": 12, "total": 12 }
# }

bonus is the balance that actually matters here — the same number a CREDITS_EXHAUSTED error reports, and the only pool every /api/v1/* call and every embedded-widget action spends from. looks (monthly subscription quota) and plan always report 0/null here by design — subscription credits are an app-only benefit, never spendable through the API or the embed widget. total is just bonus restated for symmetry with the app's own balance display.