> ## Documentation Index
> Fetch the complete documentation index at: https://docs.zupertry.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Getting Started

> Create an account, get an API key, and submit your first virtual try-on job in 5 minutes.

# 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](https://app.zupertry.com/signup).

Enter your work email, a password, and your organisation name. You will receive **100 free credits** immediately — no card required.

<Note>
  One credit = one successfully processed try-on image. Failed jobs are refunded automatically.
</Note>

## 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

<Warning>
  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`.
</Warning>

## Step 4 — Make your first API call

Use your **test API key** (`zt_test_sk_...`) to try the API without consuming credits:

```bash theme={null}
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:**

```json theme={null}
{
  "job_id": "job_abc123",
  "status": "pending",
  "created_at": "2026-03-19T10:00:00.000Z",
  "mode": "test"
}
```

## Step 5 — Check the result

```bash theme={null}
curl https://app.zupertry.com/v1/jobs/job_abc123 \
  -H "Authorization: Bearer zt_test_sk_YOUR_KEY"
```

**When complete:**

```json theme={null}
{
  "job_id": "job_abc123",
  "status": "completed",
  "output_url": "https://storage.googleapis.com/zupertry-outputs/...",
  "credits_consumed": 0,
  "mode": "test"
}
```

<Note>
  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.
</Note>

## Next steps

<CardGroup cols={2}>
  <Card title="Quickstart" icon="bolt" href="/quickstart">
    Full Node.js example with webhook receiver
  </Card>

  <Card title="API Reference" icon="code" href="/api-reference">
    Every endpoint, parameter, and error code
  </Card>

  <Card title="Webhooks" icon="webhook" href="/webhooks">
    Receive real-time job completion events
  </Card>

  <Card title="Pricing" icon="credit-card" href="/pricing">
    Understand credits, tiers, and auto-reload
  </Card>
</CardGroup>
