Face Swap API

POST /api/v1/uploads

Create a presigned upload URL for a source or target file. PUT the file to uploadUrl with the same Content-Type, then use url in the face swap request. Supported types: JPEG, PNG, WebP, MP4, QuickTime, WebM.

curl -X POST https://aideepfake.io/api/v1/uploads \
  -H "x-api-key: adf_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"fileName": "target.jpg", "contentType": "image/jpeg"}'

# → { "success": true, "data": { "uploadUrl": "...", "url": "https://...", "expiresIn": 600 } }

curl -X PUT "UPLOAD_URL_FROM_RESPONSE" \
  -H "Content-Type: image/jpeg" \
  --data-binary @target.jpg

POST /api/v1/face-swap

Start a face swap job. An image swap costs 15 credits and a video swap costs 20 credits, the same prices as the web app. Set targetType to image or video. Optional fields: faceEnhance, frameEnhance, watermark and targetDurationSeconds for videos.

curl -X POST https://aideepfake.io/api/v1/face-swap \
  -H "x-api-key: adf_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "sourceUrl": "https://.../source.jpg",
    "targetUrl": "https://.../target.jpg",
    "targetType": "image"
  }'

# → { "success": true, "data": { "taskId": "...", "creditsCost": 15 } }

Video limits: up to 300 seconds for a plain swap, up to 90 seconds when faceEnhance or frameEnhance is on.

GET /api/v1/face-swap/{taskId}

Poll the task status. The status field moves from processing to succeeded or failed. On success, outputUrl holds the hosted result. Failed jobs are refunded automatically.

curl https://aideepfake.io/api/v1/face-swap/TASK_ID \
  -H "x-api-key: adf_YOUR_API_KEY"

# → { "success": true, "data": { "taskId": "...", "status": "succeeded",
#      "outputUrl": "https://...", "targetType": "image" } }

GET /api/v1/credits

Read your current credit balance and plan before you submit jobs.

curl https://aideepfake.io/api/v1/credits \
  -H "x-api-key: adf_YOUR_API_KEY"

# → { "success": true, "data": { "credits": 1000, "subscriptionCredits": 985,
#      "oneTimeCredits": 15, "planId": "...", "currentPeriodEnd": "..." } }