Skip to main content

Getting Started

Zupertry is a per-image API for AI virtual try-on. You upload a model image and a garment image — Zupertry returns a photorealistic result. No subscriptions, no minimums. You only pay for successful completions.

Step 1 — Create an account

Go to app.zupertry.com/signup. Enter your work email, a password, and your organisation name. You will receive 100 free credits immediately — no card required.
One credit = one successfully processed try-on image. Failed jobs are refunded automatically.

Step 2 — Verify your email

Check your inbox for a verification email from Zupertry. Click the link, then return to the app. The page polls automatically — you will be redirected to onboarding within a few seconds of clicking the link.

Step 3 — Complete onboarding

  1. Confirm or edit your organisation name
  2. Select your billing region (this sets your currency — cannot be changed later)
  3. Name your first workspace (or keep the default “Default”)
  4. Copy your test API key — it is shown only once
Save your API key now. It will never be shown again. If you lose it, generate a new one from the console at /api-keys.

Step 4 — Make your first API call

Use your test API key (zt_test_sk_...) to try the API without consuming credits:
curl -X POST https://app.zupertry.com/v1/tryon \
  -H "Authorization: Bearer zt_test_sk_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model_image_url": "https://example.com/model.jpg",
    "garment_image_url": "https://example.com/shirt.jpg"
  }'
Response:
{
  "job_id": "job_abc123",
  "status": "pending",
  "created_at": "2026-03-19T10:00:00.000Z",
  "mode": "test"
}

Step 5 — Check the result

curl https://app.zupertry.com/v1/jobs/job_abc123 \
  -H "Authorization: Bearer zt_test_sk_YOUR_KEY"
When complete:
{
  "job_id": "job_abc123",
  "status": "completed",
  "output_url": "https://storage.googleapis.com/zupertry-outputs/...",
  "credits_consumed": 0,
  "mode": "test"
}
Test mode returns a mock placeholder image and consumes 0 credits. Switch to a live key (zt_live_sk_...) when you’re ready for real Vertex AI results.

Next steps

Quickstart

Full Node.js example with webhook receiver

API Reference

Every endpoint, parameter, and error code

Webhooks

Receive real-time job completion events

Pricing

Understand credits, tiers, and auto-reload