换脸 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 秒。

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