face-transformAnalyze 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.
Independent GitHub snapshot · Automated classification · Original documentation governs
Analyze and transform faces through AceDataCloud's Face API suite.
clawhub install @acedatacloud/face-transform. Check that the ClawHub publisher is @acedatacloud.Bearer ; a platform-... management token is not a service API key./face/analyze for the first example; other face actions need their own access. Advanced workflows below may call additional routes.ACEDATACLOUD_API_TOKEN=your_api_key_here in ~/.openclaw/.env, then restart the Gateway and start a new session. For a direct terminal test, run export ACEDATACLOUD_API_TOKEN="your_api_key_here" in that shell. Never put the key in a prompt or commit an .env file.Illustrated key setup, first run, and troubleshooting · Token details
curl -X POST https://api.acedata.cloud/face/analyze \
-H "Authorization: Bearer $ACEDATACLOUD_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{"image_url": "https://cdn.acedata.cloud/lrbtcn.jpg"}'
| 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 |
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.
POST /face/beautify
{
"image_url": "https://example.com/portrait.jpg"
}
age_infos is required — one entry per face, each carrying the target age.
POST /face/change-age
{
"image_url": "https://example.com/portrait.jpg",
"age_infos": [{ "age": 60 }]
}
gender_infos is required. gender is 0 to turn a male face female, 1 for the reverse.
POST /face/change-gender
{
"image_url": "https://example.com/portrait.jpg",
"gender_infos": [{ "gender": 1 }]
}
Replace the face in the target image with the face from the source.
POST /face/swap
{
"source_image_url": "https://example.com/source-face.jpg",
"target_image_url": "https://example.com/target-person.jpg"
}
POST /face/cartoon
{
"image_url": "https://example.com/portrait.jpg"
}
POST /face/detect-live
{
"image_url": "https://example.com/face-photo.jpg"
}
| Parameter | Required | Description |
|---|---|---|
image_url | Yes (all except /face/swap) | Source face image URL |
/face/change-age| Parameter | Required | Description |
|---|---|---|
age_infos | Yes | Array of { "age": <number> }, one per face. Omitting it returns 400 age_infos is required |
/face/change-gender| Parameter | Required | Description |
|---|---|---|
gender_infos | Yes | Array of { "gender": 0|1 } — 0 male→female, 1 female→male. Each entry also accepts an optional face_rect |
/face/swap| Parameter | Required | Description |
|---|---|---|
source_image_url | Yes | URL of the face to use (replaces the face) |
target_image_url | Yes | URL of the image to put the face onto |
callback_url | No | Webhook URL for async delivery |
timeout | No | Max wait time in seconds (default: 120) |
/face/beautify| Parameter | Required | Description |
|---|---|---|
image_url | Yes | Image URL |
smoothing | No | Skin smoothing 0–100 (default: 10) |
whitening | No | Whitening 0–100 (default: 30) |
face_lifting | No | Face slimming 0–100 (default: 70) |
eye_enlarging | No | Eye enlarging 0–100 (default: 70) |
/face/analyze| Parameter | Required | Description |
|---|---|---|
image_url | Yes | Image URL |
mode | No | 0 = all faces (default), 1 = largest face only |
face_model_version | No | Algorithm version (recommended: 3.0) |
need_rotate_detection | No | 0 = disabled (default), 1 = enabled |
/face/swap additionally supports an optional callback_url parameter for async delivery (pass it to receive the result via webhook instead of waiting inline)source_image_url (the face to apply) and target_image_url (the body to apply it to)