Welcome. Someone using On-Model (a fashion brand, retailer, or photo studio) invited you to review or retouch images on one of their jobs. This guide covers how the portal works so you can get started in minutes.

Are you a PiktID-vetted QA partner? If you're part of PiktID's official partner pool and receive jobs through managed-service routing, the longer QA Partner Handbook is what you want. This guide is for people invited directly by a client, not through PiktID.

You don't need an On-Model account. The client sent you a secure link; you click it, and you're in. Everything you do is scoped to that one job.

About On-Model
Your role
Getting started
Reviewer workflow
Retoucher workflow
The claim system
Annotation categories
Confidentiality
FAQ
Who to contact
Glossary

1. About On-Model

On-Model is PiktID's AI image platform for fashion e-commerce. Brands and retailers use it to generate model-swap, flat-to-model, and packshot imagery at scale. Every output passes through a Review step before it ships, and any flagged output can go through a Retouch step.

The client who invited you is the job owner. They configured this job, set the brief, and chose to bring you in either to review the outputs, to retouch flagged ones, or both.

Vocabulary you'll see in the portal

Job: the work package the client invited you to. Holds many images.
Image / image index: one image in the job. Stable position; versions stack on top.
Version: an iteration of an image. A retouch always produces a new version.
Output: the image the AI (or a retoucher) produced for review.
Verdict: your decision on one image, either Approve or Needs Retouch.
Annotations: structured feedback you attach when flagging.

2. Your role

The client invited you with one of four permission scopes. Your link carries that scope, and the portal only shows actions you're allowed to take.

	Permission	What you can do
view_only	Inspect images and annotations	Read-only. No verdicts, no uploads.
review_only	Approve or flag images	Submit verdicts and annotations. Cannot upload retouches.
retouch_only	Upload corrected images	Download flagged images, upload retouched versions. Cannot submit verdicts.
review_and_retouch	Both roles in one session	Flag an image and retouch it yourself in the same flow.

If you don't see a button you expected, you probably don't have permission for that action. Ask the client to adjust your invitation if needed.

3. Getting started

The invitation

The client sent you an email with a link of the form /review/<token>. Click it; you're signed into a scoped session for that one job. No account needed.

The link is time-limited. If it's expired, ask the client to send a fresh one. PiktID can't re-issue a client-owned link.
The link is personal and tied to your email. Don't forward it. If a colleague needs access, the client should issue them their own link.

What you'll need

Chrome, Firefox, or Safari (latest two versions).
A stable internet connection, since the portal streams full-resolution images.
For retouch work, a color-accurate monitor is strongly recommended.

Treat the link like a password. Anyone who has it can do everything you can do in the portal, attributed to you. If you suspect the link has leaked, ask the client to revoke and re-issue it.

4. Reviewer workflow

4.1 Opening the portal

The link takes you to the Review Portal scoped to one job. You'll see a job header, a filter row (Pending Review, Reviewing, Approved, Needs Retouch, Retouching), and a grid of images.

4.2 Pick an image

Click any unclaimed image to open the viewer. The portal places a claim under your name so other reviewers can't act on the same image while you're working on it. The claim refreshes on every interaction and expires after one hour of inactivity.

4.3 The viewer

The output image at full resolution.
The input images the AI worked from (source garment, identity reference, pose/composition hints). Look at these; they tell you what the AI was trying to produce.
A version strip if previous retouches happened on this image.

4.4 Make a verdict

Two buttons: Approve or Needs Retouch.

Approve when the image is good enough for the client's purpose.
Needs Retouch when there's a fixable defect. You'll be asked to annotate.

The quality bar is the client's call. If you're not sure what "good enough" means for this job, ask the client.

4.5 Annotations (required for Needs Retouch)

The annotations form asks for:

Categories: tick everything that applies, from a fixed list (see §7).
Per-category notes: short, specific, actionable. "Left hand has 6 fingers; thumb is doubled" beats "hands weird".
Overall notes (optional): anything that doesn't fit a category.

The retoucher reads your notes and never speaks to you. Specific notes save everyone time.

4.6 Submit

Click Submit verdict. The image moves to Approved or Needs Retouch. Your verdict is now part of the job's audit log and can't be undone from your side. If you change your mind, ask the client; they can reset the image from their portal.

5. Retoucher workflow

5.1 Pick up a flagged image

Flagged images sit under Needs Retouch in the portal. Click into one; the portal places a retouch claim under your name (same 1-hour idle rule as review claims).

You'll see:

The flagged output image, full resolution, with a download button.
The input images the AI used (so you can see what the source was).
The reviewer's annotations: categories and notes telling you what to fix.

Download the original via the download button.

5.2 Edit locally

Open the file in your tool of choice (Photoshop, Affinity, Capture One, anything that can save high-quality PNG or JPEG). The goal is fix the flagged defects without changing anything else.

In scope: artifact removal, shadow correction, logo fixes, skin-tone adjustment, background cleanup, garment-distortion repair, pose corrections, lighting evening-out.

Out of scope unless the annotation asks for it: changing the model's identity, hairstyle, ethnicity, or age; changing garment design, color, or cut; re-posing or recomposing the shot; beautifying beyond what the brief specifies.

If a defect is outside what a retouch can fix (e.g., the AI generated the wrong garment entirely), tell the client. They may need to regenerate, not retouch.

5.3 Save and upload

Format: PNG (preferred) or JPEG quality ≥ 90.
Color space: sRGB.
Resolution: match the original output exactly. Don't up- or down-scale.

Then in the portal:

Click Upload Retouch.
Drag your file or browse for it.
Wait for the progress bar to finish. Don't close the tab.
Click Confirm to register the file as a new version.

If the confirm step fails, the portal lets you retry without re-uploading. If you exit the page mid-upload, the file may not be registered, so you'll need to upload again.

5.4 What happens after

A new version is created. The image returns to Pending Review for the reviewer to re-check. Your claim is released automatically. Pick the next image.

If your retouch is rejected, you'll see the image return to Needs Retouch with a new annotation set. Treat the second pass as a small task: only the new annotations need addressing.

6. The claim system

When multiple people are invited to the same job, the claim system prevents collisions.

Open an image and it's claimed under your name.
Any interaction (zoom, scroll, draft save) heartbeats the claim.
After one hour of inactivity, the claim becomes stale and someone else can take it.
Visible signals: Claimed by you / Claimed by <name> / no pill (unclaimed).

Rule of thumb: never start work on an image where someone else holds the claim. Wait for them to release it or pick a different image. Stepping on a live claim creates duplicate verdicts in the audit log.

7. Annotation categories

When flagging Needs Retouch, pick from this list. Multi-select is allowed; use multiple categories when an image has multiple distinct issues.

Category	Use it for
Artifact	AI-introduced visual noise: extra digits, melted edges, ghost limbs, stray pixels, hallucinated text.
Shadow	Missing, doubled, or wrongly-directed shadows; inconsistent shadow direction.
Logo	Brand marks that are smudged, misspelled, distorted, or mis-positioned.
Skin Tone	Uneven patches, unrealistic hues, inconsistent tone across body parts.
Background	Visible seams, vignetting, color cast, distracting elements.
Garment Distortion	Fabric warping, broken pattern continuity, pocket misalignment, hem irregularities.
Pose	Implausible body positions, hands or feet at wrong angles, "floating" limbs.
Lighting	Blown highlights, crushed shadows; color-temperature inconsistencies; harsh transitions.
Other	Anything that doesn't fit above. Always add a detailed note explaining what's wrong.

Write notes that are specific and localized. Reference the region by words ("top-left of jacket", "right hem", "under the collar"); the retoucher doesn't have annotation pins.

8. Confidentiality

The images you see belong to the client who invited you. Treat them accordingly.

Don't copy, share, or use them outside the portal except as required to do your retouch.
If you downloaded files locally for retouching, keep them only as long as you need them and delete when done.
Confidentiality terms between you and the client are governed by whatever agreement (NDA, contract, working relationship) you have with the client, not with PiktID. Defer to that agreement.

If you're unsure what's allowed, ask the client.

9. FAQ

My link won't open, it says expired. Ask the client to send a fresh one. PiktID can't re-issue client-owned links.

I submitted the wrong verdict. You can't undo. Ask the client; they can reset the image from their portal.

The brief is unclear, what counts as "good enough"? The client knows. Ask them. The quality bar on this job is theirs to set.

Two reviewers disagree on the same image. Both verdicts are recorded. The client decides.

Upload failed mid-way. Retry from the Upload Retouch button; the portal handles partial uploads. If it keeps failing, ask the client to investigate.

My file is too large. Resave as PNG or quality-90 JPEG. Avoid 16-bit uncompressed TIFFs.

Can I bookmark the portal? The link is per-invitation and time-limited. Bookmark on a personal device only if you're comfortable with that, and only for as long as the token is valid.

Can my colleague help? Ask the client to issue them their own invitation. Don't forward your link, since verdicts get attributed to you, not them.

"Claim taken by another user", what do I do? Pick a different image, or wait for the other person to finish (claims auto-release after an hour idle). Don't try to force an override.

10. Who to contact

For anything about this specific job (the brief, an ambiguous annotation, a question about whether something is in scope), contact the client who invited you. They own the job and the relationship; PiktID is just the platform underneath.

For platform issues (the portal won't load, an upload errors out, a link won't open), tell the client first. The client has a direct line to PiktID support and can escalate on your behalf. PiktID doesn't have a support relationship with you directly.

11. Glossary

Annotation: structured feedback on a Needs Retouch verdict. Categories, per-category notes, and optional overall notes.
Claim: a soft lock on an image. Heartbeated by activity, expires after one hour idle.
Image / image index: one image inside a job. Versions stack on top.
Job: the work package the client invited you to.
Job owner: the client who created the job and invited you. Your point of contact for everything.
Output: the image the AI (or a retoucher) produced for review.
Permission: what you're allowed to do on this job, one of view_only, review_only, retouch_only, or review_and_retouch. Set by the client when they invited you.
Review session: the scoped session created when you opened the invitation link.
Token: the secret in your invitation link.
Verdict: your decision, either Approve or Needs Retouch. Immutable once submitted.
Version: n-th iteration of an image. Increments on every retouch upload.

Document changelog

Date	Version	Summary
2026-05-22	1.0	Initial publication.

External Reviewer & Retoucher Guide

Contents