face-transformlisted

# Face Transform Analyze and transform faces through AceDataCloud's Face API suite. > **Setup:** See [authentication](../_shared/authentication.md) for token setup. ## Quick Start ```bash curl -X POST https://api.acedata.cloud/face/analyze \ -H "Authorization: Bearer $ACEDATACLOUD_API_TOKEN" \ -H "Content-Type: application/json" \ -d '{"image_url": "https://example.com/portrait.jpg"}' ``` ## Available APIs | Endpoint | Purpose | Description | |----------|---------|-------------| | `POST /face/analyze` | Face Detection | Detect face keypoints (90+ points per face) | | `POST /face/beautify` | Beautification | Apply beauty/decoration effects | | `POST /face/change-age` | Age Transform | Make a face look older or younger | | `POST /face/change-gender` | Gender Swap | Transform facial gender characteristics | | `POST /face/swap` | Face Swap | Replace one person's face with another | | `POST /face/cartoon` | Cartoon Style | Convert portrait to animated/cartoon style | | `POST /face/detect-live` | Liveness Check | Detect if a face image is from a live person | ## Workflows ### 1. Face Analysis Detect faces and extract 90+ keypoints per face. ```json POST /face/analyze { "image_url": "https://example.com/photo.jpg" } ``` Response includes detailed keypoints: `nose`, `mouth`, `left_eye`, `right_eye`, `left_eyebrow`, `right_eyebrow`, `contour` — each as arrays of `{x, y}` coordinates. ### 2. Face Beautification ```json POST /face/beautify { "image_url": "https://