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

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

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