生產 API 參考
DeepSwapAI AI 換臉 API
用統一的生產介面接入照片、批次照片、合照對應、影片和 GIF 換臉。先查看關鍵契約、計費單位、任務狀態與邊界；完整欄位和回應請開啟英文 API 參考。
一個契約，五種工作流程
HTTPS、multipart 上傳與 JSON 任務狀態
所有公開生成路由都使用 Bearer API 金鑰，回傳 taskId，並在同一路由透過 GET 查詢任務狀態。
驗證Bearer API 金鑰金鑰只在建立時顯示，服務端僅保存 SHA-256 雜湊。
完成方式依 taskId 輪詢終態為 COMPLETED、FAILED 或 CANCELLED。
計費方式一次性帳戶積分輪詢 GET 不會產生新的生成扣費。
用戶端資料OpenAPI 3.1 + Postman目前沒有官方語言 SDK 或 webhook 回呼。
直接回答
一個 API 帳戶涵蓋五種換臉輸入
照片、批次照片、合照多人對應、影片和 GIF 使用同一個生產網域與任務生命週期。請求前檢查格式、大小、時長、目標數量和可用積分；提交後保存 taskId，並在對應的 GET 路由輪詢。
開啟英文完整 API 參考: 開啟英文完整 API 參考. 查看本地化費用計算器.
目前公開契約
路由、計費單位和主要邊界
| 工作流程 | POST 路由 | 目前單位 | 主要邊界 |
|---|---|---|---|
| 照片 | POST /api/ai-tasks | 3 積分 / 個輸出 | 一張身份圖和一張目標圖 |
| 批次照片 | POST /api/ai-tasks/batch-face-swap | 3 積分 / 個輸出 | 最多 20 張圖片；合計 95 MB |
| 合照對應 | POST /api/ai-tasks/multi-face-swap | 3 積分 / 個選取臉孔 | 最多對應 10 張臉；合計 95 MB |
| 影片 | POST /api/ai-tasks/video | 每向上取整 1 秒 2 積分；最低 6 積分 | MP4、MOV 或 WebM；300 秒；720p 或 1080p |
| GIF | POST /api/ai-tasks/gif | 每向上取整 1 秒 3 積分；最低 6 積分 | GIF、MP4 或 WebM；30 秒 |
最小整合流程
先驗證請求，再提交生成任務
- 1. 將 API 金鑰保存在服務端，不要放入瀏覽器、行動端套件、日誌或公開儲存庫。
- 2. 按工作流程驗證 multipart 欄位、檔案類型、大小、數量、時長和積分。
- 3. 提交 POST 請求，持久化回傳的 taskId 與預期扣費。
- 4. 輪詢同一路由的 GET 端點，直到 COMPLETED、FAILED 或 CANCELLED。
- 5. 只向任務所屬帳戶交付結果，並依照產品保留規則清理媒體。
計費、隱私與匯出
把可驗證的邊界寫入你的整合
API 使用與網頁端相同的一次性積分餘額。失敗生成任務依目前產品規則自動退款；圖像試用匯出在帳戶完成首次購買前包含 DeepSwapAI.com 和完整帳戶電郵，購買只影響之後新生成的圖像，不會追溯修改舊檔案。上傳和生成媒體會在伺服器端 24 小時內刪除，上傳內容不會用於訓練 AI 模型。
開發者問題
上線前確認這些問題
API 支援 webhook 嗎？
目前不支援。提交 POST 後保留 taskId，並在同一工作流程路由使用 GET 輪詢到終態。
API 有官方 SDK 嗎？
目前沒有發布官方語言 SDK。標準 HTTPS、Bearer 驗證、multipart 和 JSON 回應可以透過任意服務端 HTTP 用戶端呼叫。
一個圖片任務需要多少積分？
一張照片、一個批次輸出或一個合照對應臉孔目前都是 3 積分；影片和 GIF 依向上取整的秒數及最低費用計算。
API 金鑰可以放在前端嗎？
不可以。API 金鑰必須保存在服務端，避免寫入瀏覽器套件、行動端二進位檔、日誌、分析事件或工單。
用一個代表性任務先驗證整合
先用獲授權的最小媒體樣本測試欄位、狀態、扣費和結果交付，再擴大到批次或長影片。