Skip to main content
POST
/
v1
/
generation
/
image-face-swap
Submit Image Face Swap Task
curl --request POST \
  --url https://api.weryai.com/v1/generation/image-face-swap \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "img_url": "https://example.com/target.jpg",
  "face_img_url": "https://example.com/face.jpg",
  "webhook_url": "https://your-server.com/webhook"
}
'
{
  "status": 0,
  "desc": "success",
  "message": "success",
  "data": {
    "task_id": "task_abc123",
    "task_status": "waiting"
  }
}

Authorizations

​
Authorization
string
header
required

Authenticate using Bearer token. Get your API Key from the WeryAI Console.

Example: Authorization: Bearer sk-xxxxxxxxxxxxxxxx

Body

application/json
​
img_url
string<uri>
required

Source image URL (the image where the face will be replaced)

Example:

"https://example.com/target.jpg"

​
face_img_url
string<uri>
required

Face reference image URL (the face to swap in)

Example:

"https://example.com/face.jpg"

​
webhook_url
string<uri>

Callback URL where results will be sent when task completes

Example:

"https://your-server.com/webhook"

​
caller_id
integer<int64>

Caller ID (for business association)

Response

Task submitted successfully

​
status
integer

Business status code (0 indicates success)

Example:

0

​
desc
string

Status description

Example:

"success"

​
message
string

Multi-language message

Example:

"success"

​
data
object