換臉 API

POST /api/v1/uploads

為來源檔案或目標檔案建立預先簽章的上傳 URL。以相同的 Content-Type 將檔案 PUT 到 uploadUrl，然後在換臉請求中使用 url。支援的類型：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

發起換臉任務。圖片換臉需 15 點數，影片換臉需 20 點數，與網頁版價格相同。將 targetType 設為 image 或 video。選填欄位：faceEnhance、frameEnhance、watermark，以及影片專用的 targetDurationSeconds。

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

影片長度限制：一般換臉最長 300 秒；開啟 faceEnhance 或 frameEnhance 時最長 90 秒。提高 face_swapper_pixel_boost 會依其倍率縮短這兩個上限，以 1024x1024 進行一般換臉時最長為 120 秒。

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

輪詢任務狀態。status 欄位會從 processing 變為 succeeded 或 failed。成功時，outputUrl 會提供託管的結果檔案。失敗的任務會自動退還點數。

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

在提交任務前，查詢目前的點數餘額與方案。

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

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