顔交換 API

POST /api/v1/uploads

ソースまたはターゲットファイル用の署名付きアップロード 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": "..." } }