- 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
export ACEDATACLOUD_API_TOKEN="your-token-here"Quick Start
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.
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
POST /face/beautify
{
"image_url": "https://example.com/portrait.jpg"
}3. Age Transformation
POST /face/change-age
{
"image_url": "https://example.com/portrait.jpg"
}4. Gender Swap
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.
POST /face/swap
{
"image_url": "https://example.com/source-face.jpg",
"target_image_url": "https://example.com/target-person.jpg"
}6. Cartoon Style
POST /face/cartoon
{
"image_url": "https://example.com/portrait.jpg"
}7. Liveness Detection
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