Face Swap API

POST /api/v1/uploads

원본 또는 대상 파일용 presigned 업로드 URL을 만듭니다. 같은 Content-Type으로 파일을 uploadUrl에 PUT 한 다음, 페이스 스왑 요청에 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초입니다.

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, "planId": "...", "currentPeriodEnd": "..." } }