Tài liệu tham chiếu API production
DeepSwapAI: API face swap AI
Kết nối hoán đổi khuôn mặt cho ảnh, ảnh hàng loạt, ảnh nhóm theo ánh xạ, video và GIF qua một giao diện production duy nhất. Xem tại đây hợp đồng API, đơn vị tính phí, trạng thái tác vụ và các giới hạn; mở tài liệu tham chiếu API đầy đủ bằng tiếng Anh để xem mọi trường và phản hồi.
Một hợp đồng, năm quy trình
HTTPS, tải lên multipart và trạng thái tác vụ JSON
Mọi route tạo nội dung đã công bố đều dùng khóa API Bearer, trả về taskId và cung cấp trạng thái tác vụ qua GET trên chính route đó.
Trả lời trực tiếp
Một tài khoản API hỗ trợ năm loại đầu vào hoán đổi khuôn mặt
Ảnh, ảnh hàng loạt, khuôn mặt được ánh xạ trong ảnh nhóm, video và GIF dùng chung tên miền production và vòng đời tác vụ. Trước mỗi yêu cầu, hãy kiểm tra định dạng, kích thước, thời lượng, số lượng mục tiêu và credit khả dụng; sau khi gửi, hãy lưu taskId và truy vấn định kỳ route GET tương ứng.
Hợp đồng công khai hiện hành
Route, đơn vị tính phí và giới hạn chính
| Quy trình | Route POST | Đơn vị hiện tại | Giới hạn chính |
|---|---|---|---|
| Ảnh | POST /api/ai-tasks | 6 tín dụng / đầu ra | One source face and one target image |
| Ảnh hàng loạt | POST /api/ai-tasks/batch-face-swap | 6 tín dụng / đầu ra | Tối đa tổng cộng 20 ảnh đầu vào; tổng 95 MB |
| Ánh xạ ảnh nhóm | POST /api/ai-tasks/multi-face-swap | 6 credits / selected face | Up to 10 mapped faces; 95 MB combined |
| Video | POST /api/ai-tasks/video | 3 credits / rounded second; 12 minimum | MP4, MOV, or WebM; 600 seconds; fixed highest 1080p tier |
| GIF | POST /api/ai-tasks/gif | 3 credits / rounded second; 12 minimum | GIF, MP4, or WebM; 30 seconds |
Luồng tích hợp tối thiểu
Kiểm tra yêu cầu trước khi gửi tác vụ tạo nội dung
- 1. Giữ khóa API trên máy chủ của bạn, không bao giờ đặt trong trình duyệt, gói ứng dụng di động, log hoặc kho mã công khai.
- 2. Kiểm tra các trường multipart, loại tệp, kích thước, số lượng, thời lượng và credit cho quy trình đã chọn.
- 3. Gửi yêu cầu POST và lưu lại taskId được trả về cùng mức phí dự kiến.
- 4. Truy vấn định kỳ GET trên cùng route cho đến khi tác vụ đạt trạng thái COMPLETED, FAILED hoặc CANCELLED.
- 5. Chỉ giao kết quả cho tài khoản sở hữu tác vụ và xóa media theo quy tắc lưu giữ đã công bố.
Không có trường khóa idempotency nào được ghi lại trong hợp đồng công khai. Dịch vụ gọi nên vô hiệu hóa việc gửi trùng lặp, lưu trữ taskId đầu tiên và đối chiếu phản hồi mạng không chắc chắn trước khi phát hành POST khác.
Vòng đời tác vụ
Giữ taskId và dừng ở trạng thái cuối
| Sự kiện | Bản ghi tác vụ | Hành động tín dụng | Hành động của khách hàng |
|---|---|---|---|
| Tác vụ được chấp nhận | Lưu trữ taskId và chi phí dự kiến | Coi việc thanh toán là thuộc sở hữu của máy chủ | Bắt đầu thăm dò đo được |
| Tác vụ hoàn thành | Kết quả đầu cuối | Công việc đã hoàn thành vẫn được thanh toán | Ủy quyền truy xuất kết quả |
| Xử lý thất bại | Lỗi đầu cuối | Hợp đồng hiện tại tự động hoàn tiền xử lý thất bại | Đọc lỗi trước khi quyết định gửi lại |
| Kết quả phản hồi không chắc chắn | Đối chiếu trước khi POST khác | Không bao giờ đoán từ một thời gian chờ | Sử dụng taskId đã lưu trữ hoặc lịch sử tài khoản |
Kết quả phản hồi không chắc chắn Không có trường khóa idempotency nào được ghi lại trong hợp đồng công khai. Dịch vụ gọi nên vô hiệu hóa việc gửi trùng lặp, lưu trữ taskId đầu tiên và đối chiếu phản hồi mạng không chắc chắn trước khi phát hành POST khác.
Tính phí, quyền riêng tư và xuất tệp
Đưa các giới hạn có thể kiểm chứng vào tích hợp của bạn
API access requires a verified email and at least one PAID or COMPLETED credit order. Reward and trial credits are limited to the signed-in web workflow and cannot be automated through the API. Each account can create up to 3 API keys, with up to 6 generation requests per minute per key. Failed tasks are refunded under the current rules, and media is deleted within 24 hours.
Câu hỏi của nhà phát triển
Xác nhận các điểm sau trước khi ra mắt
API có hỗ trợ webhook không?
Hiện chưa. Hãy lưu taskId do POST trả về và truy vấn định kỳ GET trên cùng route của quy trình cho đến khi đạt trạng thái kết thúc.
Có SDK chính thức không?
Hiện chưa công bố SDK chính thức cho ngôn ngữ nào. HTTPS tiêu chuẩn, xác thực Bearer, dữ liệu multipart và phản hồi JSON hoạt động với mọi HTTP client phía máy chủ.
Một tác vụ ảnh dùng bao nhiêu credit?
Một ảnh, một kết quả đầu ra trong lô, hoặc một khuôn mặt được chọn trong ảnh nhóm hiện dùng 6 credit. Video và GIF tính theo số giây làm tròn lên và có mức phí tối thiểu.
Tôi có thể đặt khóa API trong mã frontend không?
Không. Hãy lưu khóa API trên máy chủ và không bao giờ ghi chúng vào bundle trình duyệt, tệp nhị phân ứng dụng di động, log, sự kiện phân tích hoặc phiếu hỗ trợ.
Kiểm chứng tích hợp bằng một tác vụ đại diện
Kiểm thử các trường, trạng thái, mức phí và việc giao kết quả với mẫu media nhỏ nhất mà bạn có quyền sử dụng trước khi mở rộng sang xử lý hàng loạt hoặc video dài.