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