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

Create Face Swap Task

POST
https://api.facemint.io/api/create-face-swap-task
Last modified:2025-07-17 12:22:32
Maintainer:Not configured
⚠️ Notes:
• 🎞️ Video Format Support: Common formats like .mp4, .mov, and others are supported.
• 🗓️ Storage Policy: All generated content is stored for 7 days only and will be permanently deleted after that.
• 📐 Output Resolution Rule: If the selected output resolution exceeds the source resolution, the output will default to the source resolution — but pricing will still be based on the requested resolution.
• 💧 Watermark Placement: A watermark will appear in the bottom-right corner of all face-swapped media.
• 🔄 Targeted Face Swap Limitation: When swapping specific faces in videos, rapid facial expression changes may cause flickering or inconsistent results. Choosing to swap all detected faces can significantly reduce this issue.

Request

Header Params

Body Params application/json

Examples

Responses

🟢201OK
application/json
Body

Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://api.facemint.io/api/create-face-swap-task' \
--header 'x-api-key: dfed35b0-350c-11f0-9d91-1607289bbab1' \
--header 'Content-Type: application/json' \
--data-raw '{
    "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/cb?id=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"
        }
    ]
}'
Response Response Example
{
    "code": 0,
    "info": "ok",
    "data": {
        "taskId": "683b82962ea80a690d299a7c",
        "price": 2000
    }
}
Modified at 2025-07-17 12:22:32
Previous
Get Face Swap Task Info by ID
Next
Cancel Face Swap Task (if still pending)
Built with