Image Faceswap
POST
/api/v1/task
swap_image to the target_image.INFO
swap_image onto the target_image.Format & Constraints
1.
swap_image and target_image should be under 2048 x 2048 resolution each.2.
swap_image and target_image should be passed in as URLs (ending in .jpg / .jpeg / .png / .webp) or as base64 strings.Pricing
| Task-type | Price (USD) |
|---|---|
| face-swap | $0.01 per generation |
Param Details
When multiple faces are detected, the API automatically selects and replaces the largest face in the image.
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST '/api/v1/task' \
--header 'x-api-key;' \
--header 'Content-Type: application/json' \
--data-raw '{
"model": "Qubico/image-toolkit",
"task_type": "face-swap",
"input": {
"target_image": "https://i.ibb.co/LnLYwhR/66f41e64b1922.jpg",
"swap_image": "https://i.ibb.co/m9BFL9J/ad61a39afd9079e57a5908c0bd9dd995.jpg"
}
}'Response Response Example
{
"code": 200,
"data": {
"task_id": "90efd2db-bcfc-413f-a0be-c893850c9d68",
"model": "Qubico/image-toolkit",
"task_type": "face-swap",
"status": "pending",
"config": {
"webhook_config": {
"endpoint": "",
"secret": ""
}
},
"input": {},
"output": null,
"meta": {},
"detail": null,
"logs": [],
"error": {
"code": 0,
"raw_message": "",
"message": "",
"detail": null
}
},
"message": "success"
}Request
Header Params
Body Params application/json
Responses
Modified at 2025-07-06 06:34:53