Face Swap API
  1. Face Swap APIs
Face Swap API
  • Start Your Face Swap
  • Pricing
  • Face Swap APIs
    • Get Face Swap Task Info by ID
      POST
    • Create Face Swap Task
      POST
    • Cancel Face Swap Task (if still pending)
      POST
  • Other APIs
    • Face detection from image/video URL
      POST
    • Get video info from url
      POST
  1. Face Swap APIs

Get Face Swap Task Info by ID

POST
https://api.facemint.io/api/get-task-info
Last modified:2025-07-17 12:22:24
Maintainer:Not configured
It returns the current processing status, progress percentage, and result URL (if the task is completed).

Request

Header Params

Body Params application/json

Examples

Responses

🟒200OK
application/json
Body

🟠404Record not found
🟠400Invalid input
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://api.facemint.io/api/get-task-info' \
--header 'x-api-key: dfed35b0-350c-11f0-9d91-1507389bbab0' \
--header 'Content-Type: application/json' \
--data-raw '{
    "task_id": "683a233819c60c16bb3b987e"
}'
Response Response Example
200 - Example 1
{
    "code": 0,
    "info": "success",
    "data": {
        "id": "683a233819c60c16bb3b987e",
        "state": 3,
        "price": 100,
        "process": 0,
        "show_id": "486405687",
        "params": {
            "type": "video",
            "media_url": "https://facemint.io/media.mp4",
            "start_time": 0,
            "end_time": 4,
            "resolution": 2,
            "enhance": 1,
            "nsfw_check": 0,
            "watermark": "MyFaceAI",
            "callback_url": "https://your-site.com/?cbid=121233",
            "swap_list": [
                {
                    "from_face": "https://facemint.io/face1.png",
                    "to_face": "https://facemint.io/to1.png"
                },
                {
                    "from_face": "https://facemint.io/face1.png",
                    "to_face": "https://facemint.io/to1.png"
                },
                {
                    "from_face": "https://facemint.io/face1.png",
                    "to_face": "https://facemint.io/to1.png"
                }
            ]
        },
        "result": {
            "user_id": "656373d418c7f23a1d28e914",
            "media_id": "",
            "file_url": "https://waf-cloudflare.com/4174d2903db711f09d911507389bbab0.mp4",
            "thumb_url": "https://waf-cloudflare.com/429006903db711f09d911507389bbab0.jpg",
            "file_hash": "2025-05-31 00:36:16"
        },
        "add_time": 1748640568770,
        "edit_time": 1748651776801
    }
}
Modified atΒ 2025-07-17 12:22:24
Previous
Pricing
Next
Create Face Swap Task
Built with