К основному содержанию
скилл CX Codex

face-transform — скилл для Claude Code: работа с лицами через API

Скилл face-transform для Claude Code, Codex, Cursor и других платформ, который подключает семь API AceDataCloud для работы с лицами: поиск ключевых точек, ретушь портретов, изменение возраста и пола, замена лиц.

Apache-2.0 228 установок ★ 17 обновлён 2026-10-25

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add AceDataCloud/Skills --skill face-transform -a claude-code
Открыть на GitHub

Что делает face-transform

Скилл работает через семь конечных точек AceDataCloud: /face/analyze находит до 90 ключевых точек на каждом лице, /face/beautify ретуширует портрет, /face/change-age делает человека старше или моложе, /face/change-gender меняет пол, /face/swap подставляет одно лицо вместо другого, /face/cartoon превращает фотографию в мультяшный стиль, /face/detect-live проверяет, снято ли изображение с живого человека. Для возраста и пола нужно передать массив параметров — по одной записи на лицо.

Перед первым вызовом зарегистрируйтесь на AceDataCloud, создайте ключ API в разделе Applications и положите его в ~/.openclaw/.env как ACEDATACLOUD_API_TOKEN=ваш_ключ. Ключ должен начинаться с platform-, а не Bearer. Если в настройках приложения включены ограничения Allowed APIs, добавьте туда нужные маршруты — /face/analyze, /face/beautify и другие. Без ключа или баланса запросы вернут ошибку авторизации.

Все API работают синхронно и отдают результат сразу; только /face/swap дополнительно принимает callback_url для асинхронной доставки через вебхук. Для лучшего результата на изображении должно быть чёткое фронтальное лицо. Все API находятся в стадии Alpha — интерфейсы могут измениться.

Какие задачи решает

  • распознать ключевые точки лица (нос, глаза, брови, контур) в изображении
  • состарить или омолодить человека на фотографии до заданного возраста
  • сменить пол лица на портрете (из мужского в женский и обратно)
  • подставить одно лицо на тело другого человека
  • проверить, снято ли изображение с живого человека или с экрана

Примеры запросов агенту

  • Найди ключевые точки лица на изображении https://cdn.acedata.cloud/lrbtcn.jpg через /face/analyze
  • Подставь лицо из source-face.jpg на тело из target-person.jpg через /face/swap
  • Состарь человека на портрете portrait.jpg до 60 лет через /face/change-age

Как установить face-transform

1Через Skills CLI (Vercel)

npx skills add AceDataCloud/Skills --skill face-transform -a claude-code

2Вручную: положить файлы

~/.claude/skills/face-transform/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/face-transform/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о face-transform

Как установить face-transform в Claude Code?

Выполните npx skills add AceDataCloud/Skills --skill face-transform -a claude-code, затем откройте ~/.claude/skills/face-transform/SKILL.md.

Что делает скилл face-transform?

Подключает семь API AceDataCloud для работы с лицами: находит ключевые точки (до 90 на лицо), ретуширует портреты, меняет возраст и пол, подставляет одно лицо вместо другого, превращает фото в мультяшный стиль и проверяет, снято ли изображение с живого человека.

Что нужно для работы face-transform?

Ключ API из AceDataCloud (раздел Applications, General application) в переменной ACEDATACLOUD_API_TOKEN в файле ~/.openclaw/.env. Ключ начинается с platform-, а не Bearer. Если в настройках приложения включены ограничения Allowed APIs, добавьте туда нужные маршруты — /face/analyze, /face/beautify и другие.

Исходный текст

SKILL.md · Apache-2.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 in .env file (get an API key at https://platform.acedata.cloud/console/applications).
---

# Face Transform

Analyze and transform faces through AceDataCloud's Face API suite.

## First-time setup

1. Install the official Skill with `clawhub install @acedatacloud/face-transform`. Check that the ClawHub publisher is **@acedatacloud**.
2. Sign in at [AceDataCloud → Applications](https://platform.acedata.cloud/console/applications), open **General application**, and check Face Transform access, balance, and current pricing. Copy its API key, or select **Manage Keys → Create** for a separate key. Copy the key value without `Bearer `; a `platform-...` management token is not a service API key.
3. If you enable **Allowed APIs** restrictions, include `/face/analyze` for the first example; other face actions need their own access. Advanced workflows below may call additional routes.
4. On the OpenClaw Gateway host, put `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.
5. Run the **Quick Start** below. If this workflow returns a task ID, query that same task until it finishes; do not submit the same billable request again just to check progress.

[Illustrated key setup, first run, and troubleshooting](https://github.com/AceDataCloud/Skills#first-run-with-clawhub-and-openclaw) · [Token details](https://github.com/AceDataCloud/Skills/blob/main/skills/_shared/authentication.md)

## 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://cdn.acedata.cloud/lrbtcn.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

`age_infos` is required — one entry per face, each carrying the target `age`.

```json
POST /face/change-age
{
  "image_url": "https://example.com/portrait.jpg",
  "age_infos": [{ "age": 60 }]
}
```

### 4. Gender Swap

`gender_infos` is required. `gender` is `0` to turn a male face female, `1` for the reverse.

```json
POST /face/change-gender
{
  "image_url": "https://example.com/portrait.jpg",
  "gender_infos": [{ "gender": 1 }]
}
```

### 5. Face Swap

Replace the face in the target image with the face from the source.

```json
POST /face/swap
{
  "source_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"
}
```

## Parameters

### Common

| 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 |

## Gotchas

- All face APIs return results synchronously. `/face/swap` additionally supports an optional `callback_url` parameter for async delivery (pass it to receive the result via webhook instead of waiting inline)
- Face analyze returns 90+ keypoints per detected face, supporting multiple faces in one image
- Face swap uses `source_image_url` (the face to apply) and `target_image_url` (the body to apply it to)
- 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

© acedatacloud · Apache-2.0 · AceDataCloud/Skills

Похожие скиллы

Все скиллы по теме «ИИ и ML» →
eachlabs-face-swap eachlabs Скилл eachlabs-face-swap для Claude Code, Cursor, Codex и других платформ, который меняет лица на фотографиях и видео через EachLabs AI. Агент отправляет запрос к API и получает готовое изображение. CX Codex +1 348установок face-swap prime-skills Скилл face-swap подменяет лицо персонажа в видео или фотографиях через RunComfy CLI. Автоматически выбирает нужную модель: для видео с аудио, для одного кадра или пакета, для сохранения движения или идентичности. CX Codex +1 390 600установок runcomfy-cli prime-skills Скилл runcomfy-cli для Claude Code, Codex, Cursor, Copilot, Gemini CLI и OpenCode учит агента работать с CLI RunComfy. CX Codex +1 390 900установок eye-color-changer eachlabs Скилл eye-color-changer для изменения цвета глаз на портретах через нейросеть each::sense. Подходит для естественной ретуши, фэнтези-эффектов и гетерохромии. CX Codex +1 206установок catalyst-zia catalystbyzoho Добавляет API Catalyst Zia Services: OCR, анализ лиц, тональность текста, поиск объектов, штрихкоды и модерацию контента. CX Codex +1 1 200установок faceswap calesthio Скилл faceswap для Claude Code заменяет лицо в видео через HeyGen API по ссылке на портрет. Персонализирует ролики. CX Codex +1 1 200установок

Из того же набора67

Весь набор →
google-gmail Скилл google-gmail позволяет искать письма Gmail, разбирать цепочки и работать с метками и вложениями. Отправка и архивирование требуют соответствующих разрешений и подтверждения пользователя. CX Codex +1 231установок ai-chat Скилл ai-chat подключает шлюз AceDataCloud к агенту для вызова более 50 моделей LLM через единый API. Запускается при запросах к Claude, GPT, Gemini, DeepSeek или Kimi с сохранением контекста и стримингом. CX Codex +1 230установок zhihu Скилл подключает Zhihu к агенту: ищет посты и весь веб, показывает горячие темы, отдаёт статистику ваших статей и ответов. CX Codex +1 229установок short-url Скилл short-url для Claude Code создаёт короткие ссылки через AceDataCloud API. Готовит длинный URL к передаче или публикации. CX Codex +1 228установок google-calendar Скилл google-calendar для Claude Code просматривает расписание, ищет свободные окна и планирует встречи в Google Календаре через Calendar v3 REST API. Управляет событиями без перехода в браузер. CX Codex +1 222установок blogger Работает с Blogger API v3: публикует записи, читает блоги и посты, обновляет публикации. Управляет блогом из Claude Code. CX Codex +1 221установок tencentcloud-cls Скилл ищет и анализирует логи Tencent Cloud CLS: помогает находить ошибки API, трассировать запросы и запускать CQL/SQL-запросы. CX Codex +1 221установок youtube Ищет видео на YouTube, читает данные канала и помогает загружать ролики через YouTube Data API v3. Проверяет статистику и комментарии своих видео. CX Codex +1 221установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой