Image Faceswap

POST

https://api.goapi.ai/api/v1/task

INFO

This async endpoint from GoAPI's Faceswap API swaps the face from the swap_image onto the target_image.

Format & Constraints

Size & Resolution: both swap_image and target_image should be under 2048 x 2048 resolution each.

Input Format: both swap_image and target_image should be passed in as urls (ending in jpg/jpeg/png/webp) or in base64 string.

Pricing

Task-type	Price (USD)
face-swap	$0.01 per generation

Param Details

The Face-Swap API enables transferring face from reference image to target image. When multiple faces are detected, the API automatically selects and replaces the largest face in the image.

Request

Header Params

Body Params application/json

Example

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

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api.goapi.ai/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"
    } 
}'

Responses

🟢200Success

application/json

Body

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

Modified at 2025-04-03 03:34:20

Multi Faceswap

Video Faceswap

Image Faceswap

Format & Constraints#

Pricing#