Sign in

v1

latestOpenAPI 3.0.32026-07-26214565.6 KB
Face Swap

Face Swap Plus

Face Swap Plus API (akool_faceswap_classic_plus) - Multi-face swap for images and videos.

  • Supports multiple faces via face_mapping
  • Supports both images and videos (source_url / target_url)
  • Supports single_face_mode for single-face swap
  • Supports model_style (realistic / beautify / lossless)
post/api/open/v4/faceswap/faceswapPlusByImage

Request body

source_urlstring required

Source (new) face image URL

target_urlstring required

Target material URL (image or video)

webhookUrlstring

Callback URL for result notification

face_enhanceboolean

Whether to enable face enhancement (default false)

model_style'realistic' | 'beautify' | 'lossless'

Model style: realistic (default), beautify, or lossless

single_face_modeboolean

When true, enables single-face mode for simplified single-face swap. When false (default), uses face_mapping for multi-face swap.

Response

Faceswap request submitted successfully

codeinteger required

Interface returns business status code (1000: success)

msgstring required

Interface returns status information

Example response

{
  "code": 1000,
  "msg": "OK"
}