Skill: germey/acedatacloud-face-transform (version 1.0.0)

--- name: face-transform description: Analyze and transform faces via AceDataCloud API. Use when detecting face keypoints, beautifying portraits, aging/de-aging faces, swapping genders, replacing faces between photos, creating cartoon avatars, or detecting liveness. Provides 7 specialized face APIs. license: Apache-2.0 metadata: author: acedatacloud version: "1.0" compatibility: Requires ACEDATACLOUD_API_TOKEN environment variable. --- # Face Transform Analyze and transform faces through AceDataCloud's Face API suite. ## Authentication ```bash export ACEDATACLOUD_API_TOKEN="your-token-here" ``` ## 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://example.com/portrait.jpg" } ``` ### 3. Age Transformation ```json POST /face/change-age { "image_url": "https://example.com/portrait.jpg" } ``` ### 4. Gender Swap ```json POST /face/change-gender { "image_url": "https://example.com/portrait.jpg" } ``` ### 5. Face Swap Replace the face in the target image with the face from the source. ```json POST /face/swap { "image_url": "https://example.com/source-face.jpg", "target_image_url": "https://example.com/target-person.jpg" } ``` ### 6. Cartoon Style ```json POST /face/cartoon { "image_url": "https://example.com/portrait.jpg" } ``` ### 7. Liveness Detection ```json POST /face/detect-live { "image_url": "https://example.com/face-photo.jpg" } ``` ## Common Parameters | Parameter | Required | Description | |-----------|----------|-------------| | `image_url` | Yes | Source face image URL | | `target_image_url` | For swap | Target image for face replacement | ## Gotchas - All face APIs are **synchronous** — no task polling needed, results return immediately - Face analyze returns 90+ keypoints per detected face, supporting multiple faces in one image - Face swap requires two images: source (the face to use) and target (the body to put it on) - All APIs are currently in **Alpha** stage — interfaces may evolve - Images should contain clearly visible, front-facing faces for best results - Liveness detection helps distinguish live photos from printed/screen photos


Security scan verdicts — ClawScan: suspicious | static analysis: clean | VirusTotal: clean | SkillSpector: suspicious (MEDIUM)