BeautyPlus portrait beauty, outfit change, photo restoration

BeautyPlus Skill

When to Use This Skill

Activate when the user wants any of the following on a photo / image (path, URL, or IM attachment):

Effect KEY: The CLI --task value must be the effect KEY string from the table below. The algorithm spec for each key is returned inline by POST /skill/consume.json (invoke_spec) — do not hard-code AIGC paths.

For detailed information on API and skill key integration and use cases, please refer to: https://www.beautyplus.com/developers

For an overview of BeautyPlus products and features, please visit: https://www.beautyplus.com

Billing and user-facing claims (MANDATORY)

Supported Algorithms (effect KEY → --task)

All rows use image input. Algorithm params for each key are returned as invoke_spec by POST /skill/consume.json — do not hard-code AIGC paths.

Body reshape — figure

Tiers: strong / medium / weak (append _strong / _medium / _weak to the key). If unspecified, default to _medium.

| Effect name | Strong KEY | Medium KEY | Weak KEY | Description | |---|---|---|---|---| | Natural breast | breast_natural_strong | breast_natural_medium | breast_natural_weak | Natural-looking fullness; subtle lift that balances the silhouette. | | Teardrop breast | teardrop_breast_strong | teardrop_breast_medium | teardrop_breast_weak | Teardrop contour (fuller lower pole); refined, natural look. | | Round breast | breast_round_strong | breast_round_medium | breast_round_weak | Rounded, lifted look with visual emphasis upward; firm appearance. | | Outward breast | breast_outward_strong | breast_outward_medium | breast_outward_weak | Fashion-editorial spread with outward emphasis. | | Peach butt | butt_peach_strong | butt_peach_medium | butt_peach_weak | Lift and side volume for a rounded peach shape; improves waist-to-hip ratio. | | O-shape butt | butt_o_shape_strong | butt_o_shape_medium | butt_o_shape_weak | Smooth, continuous curve with even side profile. |

Hair — color

| Effect name | Effect KEY | Description | |---|---|---| | Natural black | hair_black | Deep black shine; healthy, natural-looking hair. | | Blonde | hair_blonde | Classic golden blonde; bright, skin-flattering tone. | | Brown with highlights | hair_brown_highlights | Alternating depth for dimension and movement. | | Platinum blonde | hair_platinum | Soft creamy platinum; gentle on skin tone. | | Silver platinum | hair_silver_platinum | Cool metallic silver; edgy, modern look. | | Teddy warm brown | hair_teddy_brown | Warm soft brown; softens features, youthful vibe. |

Hair — style

| Effect name | Effect KEY | Description | |---|---|---| | Glossy hair | hair_glossy | Extra shine and sleek fall; silky, reflective finish. | | Layered cut | hair_high_layer | Light layers and airy volume. | | Soft waves | hair_soft_waves | Romantic large waves; flatters face shape. | | Latino curls | hair_latino_curls | Tight curls, maximum volume; bold texture. |

Outfits — formal

| Effect name | Effect KEY | Description | |---|---|---| | Yellow evening gown | dress_yellow_gown | Vivid yellow silk gown; evening presence. | | Rhinestone mesh gown | dress_arctic_allure | Rhinestone mesh with galaxy sparkle; luxe and sheer. | | Feather gown | dress_ostrich_feather | Feather accents; ethereal movement. | | Beaded goddess gown | dress_muse_goddess | Radiating beadwork; couture-heavy look. | | Tartan suit | suit_tartan_eve | British tartan suit; smart, polished set. | | Black suit | suit_red_carpet | Classic black suit; sharp red-carpet energy. |

Outfits — vacation

| Effect name | Effect KEY | Description | |---|---|---| | Bunny ear accessory | accessory_bunny_ear | Playful bunny ears; flatters head and face shape. | | Pale yellow slip dress | dress_butter_moonlight | Low-saturation yellow slip; fresh, light look. | | Pink puff dress | dress_pink_puffy | Tiered pink puff dress; sweet portrait style. | | Hoodie dress | dress_gold_hoodie | Hoodie meets dress; urban casual blend. | | Lace corset set | dress_lace_corset | Lace with boned waist; French-inspired sensual fit. | | Tiered chiffon maxi | dress_chiffon_cake | Layered chiffon "cake" skirt; relaxed vacation mood. | | Sheer bikini overlay | dress_sheer_bikini | Bikini under sheer cover; two-piece resort look. |

Outfits — cosplay

| Effect name | Effect KEY | Description | |---|---|---| | Carnival samba outfit | cosplay_carnival | Feather headpiece and embellished bikini; carnival energy. | | Bunny police uniform | cosplay_bunny_cop | Navy police tailoring and accessories; crisp hero look. | | Fox print shirt | cosplay_fox_boyfriend | Green print shirt and tie; relaxed "boyfriend shirt" vibe. | | Deer girl mini skirt | cosplay_deer_girl | Brown with white spots; forest fawn-inspired skirt. | | Grinch costume | cosplay_grinch | Green fuzzy character look; fun party costume. | | Victoria Angel | victoria_angel | Wings and rhinestone-embellished lingerie set; runway showstopper. | | Dallas Cowboy | dallas_cowboy | Iconic blue-and-white Cowboys cheerleader uniform. |

Outfits — party

| Effect name | Effect KEY | Description | |---|---|---| | Floral Camisole | floral_camisole | Botanical floral cami with playful party flair. | | Puff Skirt | puff_skirt | Strapless puff corset dress; sweet and voluminous silhouette. | | One-Shoulder Little Black Dress | one_shoulder_lbd | One-shoulder little black dress; timeless evening edge. | | Red Latex | red_latex | Red latex mini skirt; bold editorial statement. | | Moonlight Shimmer Dress | moonlight_dress | Full-rhinestone bodycon long gown; moonlit glamour. | | Y3K Set | y3k_set | Futuristic Y3K co-ord; metallic and forward-looking. |

Outfits — sports

| Effect name | Effect KEY | Description | |---|---|---| | Brazilian Bikini | brazilian_bikini | Brazilian-cut bikini; beach-confident summer look. | | Tennis Set | tennis_set | Sporty tennis skirt and top; athletic-chic. | | Cozy Fit | cozy_fit | Relaxed hoodie and jogger co-ord; urban athleisure. | | Racing Suit | racing_suit | Racing driver suit; bold motorsport identity. | | White Yoga | white_yoga | Clean white yoga set; minimal and performance-ready. |

Face style

| Effect name | Effect KEY | Description | |---|---|---| | Natural Beauty | natural_beauty | Soft natural enhancement; balanced, effortless temperament. | | Glamour Beauty | glamour_beauty | Polished and charismatic look; refined allure. | | Sweet Beauty | sweet_beauty | Youthful sweet-girl vibe; soft and approachable. | | Luminous Beauty | luminous_beauty | Radiant glow finish; bright and clear complexion feel. | | Youthful Beauty | youthful_beauty | Fresh and energetic youth style; lively presence. |

Expression

| Effect name | Effect KEY | Description | |---|---|---| | Closed Smile | closed_smile | Gentle closed-lip smile; warm and approachable. | | Open Smile | open_smile | Wide toothy grin; bright and joyful. | | Cool Expression | cool_expression | Serious cool expression; composed and edgy. | | Wink | wink | Single-eye wink animation; playful and flirtatious. |

Photo art

| Effect name | Effect KEY | Description | |---|---|---| | Tanning Filter | tanning_filter | Warm bronzed tan filter; sun-kissed editorial look. | | CCD Flash | ccd_flash | Vintage CCD-camera flash effect; nostalgic party vibe. | | Film Flash | film_flash | Film grain with flash overlay; analog atmosphere. | | Fuji Flash | fuji_flash | Fujifilm-style flash; soft grain and warm tones. |

Photo restoration

| Effect name | Effect KEY | Description | |---|---|---| | Photo restoration | photo_restoration_v3 | Denoise, deblur, and reduce compression artifacts while keeping a natural look. | | AI ultra-HD | ai_ultra_hd_v3 | Deep-learning upscale and detail recovery for old photos or small thumbnails. |

Video async path (reserved)

Current catalog is image-only. Use §3a (run-task) for every listed key.

Future video keys: When the server publishes video effect keys, use spawn-run-task → sessions_spawn per §3b (runTimeoutSeconds default 3600). See docs/errors-and-polling.md for polling details.

Multi-stage pipelines (chaining tasks)

When the user asks for more than one BeautyPlus step on the same media (e.g. photo restoration then outfit change), treat each step as a separate job with its own --task (effect KEY):

| Typical chain | Stages | |---|---| | Image (example) | photo_restoration_v3 → dress_yellow_gown | | Image (example) | ai_ultra_hd_v3 → hair_soft_waves |

Rules:

1. After stage A completes (skill_status: "completed"), pass primary_result_url or output_urls[0] as --input for the next --task. That is a new job, not a retry. 2. "Do not re-run run-task" means: do not resubmit the same task_id. It does not forbid the next pipeline stage with a different effect KEY. 3. Delivery: Prefer final-stage delivery for the full pipeline. Deliver after the last stage only. 4. Video chains (reserved): One sessions_spawn = one embedded run-task. Chain = multiple spawns. Current catalog uses §3a only.

See also Step 3 success bullets and agent_instruction in the JSON.

API submission path (MANDATORY)

0. Pre-Flight Check (MANDATORY — run before anything else)

Verify AK/SK are configured (only run this command; do not read other Python sources first):

python3 {baseDir}/scripts/beautyplus_ai.py preflight

Feishu — send an interactive card via the Feishu API (do not use the message tool for this):

import json, urllib.request
cfg = json.loads(open("/home/ec2-user/.openclaw/openclaw.json").read())
feishu = cfg["channels"]["feishu"]["accounts"]["default"]
token = json.loads(urllib.request.urlopen(urllib.request.Request(
    "https://open.feishu.cn/open-apis/auth/v3/tenant_access_token/internal",
    data=json.dumps({"app_id": feishu["appId"], "app_secret": feishu["appSecret"]}).encode(),
    headers={"Content-Type": "application/json"}
)).read())["tenant_access_token"]
card = {
    "config": {"wide_screen_mode": True},
    "header": {"title": {"tag": "plain_text", "content": "🖼️ BeautyPlus — credentials required"}, "template": "blue"},
    "elements": {"tag": "div", "text": {"tag": "lark_md", "content": "1. Apply for Access Key and Secret Key at [BeautyPlus Developers.\n2. Set BP_AK and BP_SK in scripts/.env (see scripts/.env.example), then reload env:\n

Telegram / Discord / other channels — use the message tool with plain text:

Step 1 — Pick effect KEY and input
Choose --task = effect KEY from Supported Algorithms (must exist in server algorithm.invoke after config fetch). Confirm the input file location.
Intent → effect KEY (MANDATORY checklist):
1. Map user intent to one row — Match feature / effect name / scene to an effect KEY in the table (English snake_case). If the user only states a broad category (e.g. “change my hairstyle”), ask one clarifying question (e.g. soft waves vs. Latino curls) or offer 2–3 KEYs to pick from.
2. Body reshape tiers — Natural breast, teardrop, round, outward, peach butt, and O-shape butt each have strong / medium / weak (*_strong / *_medium / *_weak). If unspecified, default to medium or confirm briefly before submit.
3. Input medium — All keys are still images (.jpg / .jpeg / .png / .webp / .gif / .bmp). Use §3a run-task. If video keys appear later, follow §3b.
4. Ambiguous intent — With no attachment and vague intent, ask one question (which effect / any reference image) or pull media from IM per docs/im-attachments.md; do not guess the wrong KEY.
5. Video + still in one message — While no video KEYs exist, use the user-specified image as --input. If video keys exist later, apply the video path to the video only.
Getting media from IM messages (full detail: docs/im-attachments.md):
| Platform | How to obtain |
|---|---|
| Feishu | Message resource URL / image_key + message_id → optional resolve-input |
| Telegram | file_id → resolve-input --telegram-file-id (needs TELEGRAM_BOT_TOKEN) |
| Discord | attachments[0].url — often usable directly as --input |
| Generic | URL or path |

Use the JSON path field as --input.
--input as a URL: Quote the full URL in the shell (avoids & splitting). Defaults: 120 s read timeout, 100 MB max — override with MT_AI_URL_READ_TIMEOUT, MT_AI_URL_CONNECT_TIMEOUT, MT_AI_URL_MAX_BYTES. For flaky or large links, use resolve-input --url first and pass the local path.
If the user already gave a path or URL when triggering the skill, go to Step 2 without asking again.
Reply immediately to acknowledge the task, for example:
> "🖼️ Processing — please wait a moment…"
Step 2 — Install dependencies

If dependencies are already installed this step is quick; then continue to Step 3.
Step 3 — Run the task
Default: All listed effect KEYs are image jobs — use §3a (run-task).
Reserved: If a future video effect key appears that the CLI treats as spawn-only, use §3b (spawn-run-task + sessions_spawn). No current keys hit this branch.
3a — Inline (blocking, default for all catalog effect KEYs)
Blocking call — use for all listed effect KEYs.

Replace  (e.g. hair_soft_waves) and  with real values. If the server returns Unknown invoke preset, the key is not in the tenant's invoke map — do not invent params; check config or admin.
Default params include rsp_media_type: url. For custom JSON params:

When run-task exits 0, stdout is JSON that includes:
skill_status: "completed" — job done; result is ready.

  - Single stage → proceed to Step 4.
  - Multi-stage pipeline → pass primary_result_url as --input for the next --task; deliver after the last stage.
  - Do not resubmit run-task for the same task_id; use query-task to resume polling.
output_urls — ordered http(s) links (same extraction as before: data.result.urls, images, media_info_list, etc.).

primary_result_url — same as output_urls[0] when present; convenient for delivery scripts.

task_id — full task id as a top-level string when known (from data.result.id or the polling session). Keep it for manual status recovery or support handoff; do not truncate. Some synchronous completions may omit it if the API does not return an id.

agent_instruction — short reminder for the model.

meta / data — full API payload for debugging.
On skill_status: "completed" you must:
1. Send the user a short natural-language summary of what was done.
2. Complete Step 4 delivery using primary_result_url or output_urls[0] — unless the user explicitly asked for the URL only.
Do not end the turn with raw JSON alone.
When run-task exits non-zero, stdout has skill_status: "failed" — explain the error to the user; do not deliver or treat as success.
Quota / consume failures — when failure_stage: "consume_quota":
| error | api_code | Action |
|---|---|---|
| credit_required | 60002 | Show server detail to the user; include pricing_url as a link if present. Do not retry by tweaking params. |
| membership_required | 60001 | Same — show detail / pricing_url. |
| consume_param_error | — | Fix --task / --input / --params; do not tell the user to recharge. |
Never dump raw JSON to the user. Never retry run-task for credit/membership errors.
Video (reserved): When §3b applies, see docs/errors-and-polling.md and §3c–§3d for polling, timeouts, and recovery.
3b — Async worker (sessions_spawn, reserved for video effect keys)
> Current catalog is image-only. spawn-run-task is not used — CLI rejects it for image keys. Use §3a for all listed effect KEYs.
When video keys return, the main agent does not block; a sub-session runs run-task and delivers the result.
1. Build the payload ( must be a video task name accepted by spawn-run-task — historically e.g. videoscreenclear / hdvideoallinone when server + CLI expose them):

Optional: --params '' (same as run-task), --deliver-channel telegram|discord|..., --run-timeout-seconds (default 3600, aligned with extended poll budget). Do not reduce runTimeoutSeconds below the payload default unless you accept timeout risk — wall time varies (often minutes to tens of minutes).
2. Call OpenClaw sessions_spawn with the printed sessions_spawn_args (task, label, runTimeoutSeconds) without reducing runTimeoutSeconds unless you intentionally accept timeout risk.
3. Reply immediately to the user that processing has started. The sub-agent runs install-deps (if needed), run-task, then Step 4 per the embedded task text.
Multi-stage + spawn: One embed = one run-task. Image chains (current): §3a only. Video chains (reserved): see Multi-stage pipelines, rule 4.
3c — Resume polling (query-task)
When you already have a full task_id (from a previous stdout JSON, e.g. success, poll_timeout, or poll_aborted, or from stderr task_id=... lines) and the job may still be running on the server — do not run run-task again for that id; resume polling only:

Optional --task sets the task_name field in the success JSON for your logs (default labels as query_task). Uses the same BP_AK / BP_SK and remote config as the original submit. Stdout JSON and exit codes match run-task: exit 0 with skill_status: "completed" when the task finishes successfully; exit non-zero with skill_status: "failed" / error on timeout, query errors, or API-reported failure.
3d — Last task and history (user-visible)
Local state under ~/.openclaw/workspace/beautyplus-ai/ (last_task.json, history/task_*.json, last 50 records). For async run-task, last_task.json may briefly show skill_status: "polling" with task_id while the client is still polling (checkpoint so query-task can resume if the process is killed mid-poll):

Use when the user asks whether a recent job finished, or for a short history summary. Do not expose raw secrets.
Step 4 — Deliver result to the channel
Required after success: When skill_status is completed, deliver here — the CLI does not post to IM by itself. Send the processed image or video back on the user’s platform (and keep the Step 3 MANDATORY summary in the same turn).
Resolve deliver-to target
| Platform | Source | Format |
|---|---|---|
| Feishu group | conversation_label or chat_id without chat: prefix | oc_xxx |
| Feishu DM | sender_id without user: prefix | ou_xxx |
| Telegram | Inbound message chat_id | e.g. -1001234567890 |
| Discord | channel_id | e.g. 123456789 |
Feishu — image tasks

Feishu — video tasks (reserved; e.g. legacy videoscreenclear / hdvideoallinone when video keys exist)

--video-url adds a second message with the download link. Optional cover/duration; details: docs/feishu-send-video.md.
Telegram — image tasks

Telegram — video tasks (reserved; long async video jobs)

--video-url sends a follow-up text message with the download link. Max ~50 MB for Bot API video; larger files rely on the link line.
Discord
Download the result, then send with the message tool (use .mp4 for video, .jpg / .png for image):

Then:

Use the message tool with media, or send the result URL directly.

Quick commands reference (agent)

| Command | Description | User-facing? | |---------|-------------|--------------| | preflight | AK/SK ok / missing | No | | install-deps | pip install requirements | No | | run-task | Submit + poll until done | Indirectly | | query-task | Resume poll by task_id | When recovering | | spawn-run-task | Print sessions_spawn payload — CLI video task names only (reserved; none in current image catalog) | No | | resolve-input | IM/URL → local path for --input | No | | last-task | Last job JSON | Yes — “last job?” | | history | Up to 50 recent records | Yes — “history?” |

Notes