Sign in

v1

latestOpenAPI 3.0.32026-07-26214565.6 KB
Face Swap

Face Swap Pro

Face Swap Pro API (akool_faceswap_image_hq) - Highest quality face swap for images.

  • More realistic, more similar results
  • Simplified integration: opts parameter is optional when both arrays have 1 element
  • Supports up to 50 sourceImage / targetImage pairs
  • Validation Rules:
    • Each path must be a valid HTTP/HTTPS URL
    • opts is required when either array has more than 1 element
    • opts is optional when both arrays have exactly 1 element each
post/api/open/v4/faceswap/faceswapByImage

Request body

model_name'akool_faceswap_image_hq'

Model name (default: akool_faceswap_image_hq)

webhookUrlstring

Callback URL for result notification

face_enhanceboolean

Whether to enable face enhancement (default false)

single_face_modeboolean

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

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