프로덕션 API 레퍼런스
DeepSwapAI AI 얼굴 바꾸기 API
사진, 사진 일괄 처리, 단체 사진 매핑, 동영상, GIF를 하나의 프로덕션 인터페이스에 연결하세요. 핵심 계약, 비용 단위, 작업 상태와 경계를 확인하고, 전체 필드와 응답은 영어 API 레퍼런스에서 확인할 수 있습니다.
하나의 계약, 다섯 가지 워크플로
HTTPS, multipart 업로드, JSON 작업 상태
공개 생성 경로는 모두 Bearer API 키를 사용하고 taskId를 반환하며 같은 경로의 GET으로 작업 상태를 조회합니다.
직접 답변
하나의 API 계정으로 다섯 가지 입력을 처리
사진, 사진 일괄 처리, 단체 사진 다중 얼굴 매핑, 동영상, GIF는 같은 프로덕션 도메인과 작업 수명 주기를 사용합니다. 요청 전에 형식, 크기, 길이, 대상 수, 크레딧을 확인하고 제출 후 taskId를 저장해 해당 GET 경로를 폴링하세요.
현재 공개 계약
경로, 비용 단위, 주요 제한
| 워크플로 | POST 경로 | 현재 단위 | 주요 제한 |
|---|---|---|---|
| 사진 | POST /api/ai-tasks | 출력당 3크레딧 | 소스 얼굴 이미지 1장과 대상 이미지 1장 |
| 사진 일괄 | POST /api/ai-tasks/batch-face-swap | 출력당 3크레딧 | 최대 20장, 합계 95MB |
| 단체 매핑 | POST /api/ai-tasks/multi-face-swap | 선택한 얼굴당 3크레딧 | 최대 10개 얼굴 매핑, 합계 95MB |
| 동영상 | POST /api/ai-tasks/video | 올림한 초당 2크레딧, 최소 6크레딧 | MP4, MOV 또는 WebM; 300초; 720p 또는 1080p |
| GIF | POST /api/ai-tasks/gif | 올림한 초당 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을 종료 상태까지 폴링하세요.
공식 SDK가 있나요?
현재 공식 언어 SDK는 공개되지 않았습니다. 표준 HTTPS, Bearer 인증, multipart와 JSON 응답을 모든 서버 HTTP 클라이언트에서 호출할 수 있습니다.
사진 작업 한 건은 몇 크레딧인가요?
사진 한 장, 일괄 출력 한 건, 단체 사진에서 선택한 얼굴 한 건은 현재 3크레딧입니다. 동영상과 GIF는 올림한 초 수와 최소 요금으로 계산됩니다.
API 키를 프론트엔드에 넣어도 되나요?
안 됩니다. API 키는 서버에 보관하고 브라우저 번들, 모바일 바이너리, 로그, 분석 이벤트, 지원 티켓에 기록하지 마세요.
대표 작업 하나로 통합을 검증
허가받은 최소 미디어 샘플로 필드, 상태, 비용, 결과 전달을 확인한 뒤 일괄 작업이나 긴 동영상으로 확장하세요.