Authentication
POST /api/v1/auth/token
Send a client UUID (no password). Response: { token, expires_at }.
Use Authorization: Bearer <token> for transform and job endpoints.
Categories
GET /api/v1/categories
Public — list all example categories with counts.
Examples
GET /api/v1/examples/{category}
Style Transform
POST /api/v1/transform/{hairstyles|hair-colors|smiles|makeup|features|impressions|presets|skin-filter}
Requires JWT. Returns 202 with job_id for polling.
Face Sizes Transform
POST /api/v1/transform/face-sizes
Multiple adjustments allowed. Send adjustments as JSON string in multipart.
Jobs
GET /api/v1/jobs/{id}
GET /api/v1/jobs/{id}/result