프로덕션 API 레퍼런스
DeepSwapAI AI 얼굴 바꾸기 API
사진, 사진 일괄 처리, 단체 사진 매핑, 동영상, GIF를 하나의 프로덕션 인터페이스에 연결하세요. 핵심 계약, 비용 단위, 작업 상태와 경계를 확인하고, 전체 필드와 응답은 영어 API 레퍼런스에서 확인할 수 있습니다.
하나의 계약, 다섯 가지 워크플로
HTTPS, multipart 업로드, JSON 작업 상태
공개 생성 경로는 모두 Bearer API 키를 사용하고 taskId를 반환하며 같은 경로의 GET으로 작업 상태를 조회합니다.
직접 답변
하나의 API 계정으로 다섯 가지 입력을 처리
사진, 사진 일괄 처리, 단체 사진 다중 얼굴 매핑, 동영상, GIF는 같은 프로덕션 도메인과 작업 수명 주기를 사용합니다. 요청 전에 형식, 크기, 길이, 대상 수, 크레딧을 확인하고 제출 후 taskId를 저장해 해당 GET 경로를 폴링하세요.
현재 공개 계약
경로, 비용 단위, 주요 제한
| 워크플로 | POST 경로 | 현재 단위 | 주요 제한 |
|---|---|---|---|
| 사진 | POST /api/ai-tasks | 출력당 6크레딧 | 소스 얼굴 이미지 1장과 대상 이미지 1장 |
| 사진 일괄 | POST /api/ai-tasks/batch-face-swap | 출력당 6크레딧 | 소스 이미지와 대상 이미지를 합해 입력 이미지 최대 20장, 합계 95MB |
| 단체 매핑 | POST /api/ai-tasks/multi-face-swap | 선택한 얼굴당 6크레딧 | 최대 10개 얼굴 매핑, 합계 95MB |
| 동영상 | POST /api/ai-tasks/video | 올림한 초당 3크레딧, 최소 12크레딧 | MP4, MOV 또는 WebM; 600초; 최고 1080p 고정 |
| GIF | POST /api/ai-tasks/gif | 올림한 초당 3크레딧, 최소 12크레딧 | GIF, MP4 또는 WebM; 30초 |
최소 통합 흐름
요청을 검증한 뒤 생성 작업을 제출
- 1. API 키는 서버에 보관하고 브라우저, 모바일 앱, 로그, 공개 저장소에 넣지 마세요.
- 2. 워크플로별 multipart 필드, 파일 형식, 크기, 수, 길이, 크레딧을 검증하세요.
- 3. POST 요청을 제출하고 반환된 taskId와 예상 비용을 저장하세요.
- 4. 같은 경로의 GET 엔드포인트를 COMPLETED, FAILED, CANCELLED까지 폴링하세요.
- 5. 작업 소유 계정에만 결과를 전달하고 공개된 보관 규칙에 따라 미디어를 삭제하세요.
공개 계약에 멱등성 키 필드가 문서화되어 있지 않습니다. 호출 서비스는 중복 제출을 비활성화하고, 첫 번째 taskId를 유지하며, 다른 POST를 발행하기 전에 불확실한 네트워크 응답을 조정해야 합니다.
작업 수명 주기
taskId를 유지하고 터미널 상태에서 중지
| 이벤트 | 작업 기록 | 크레딧 조치 | 클라이언트 조치 |
|---|---|---|---|
| 작업 수락됨 | taskId 및 예상 비용 유지 | 정산을 서버 소유로 처리 | 측정된 폴링 시작 |
| 작업 완료됨 | 최종 결과 | 완료된 작업은 정산된 상태 유지 | 결과 검색 승인 |
| 처리 실패 | 최종 실패 | 현재 계약은 실패한 처리를 자동으로 환불 | 재제출 결정 전 실패 확인 |
| 응답 결과 불확실 | 다른 POST 전에 조정 | 타임아웃으로 추정하지 마십시오 | 저장된 taskId 또는 계정 기록 사용 |
응답 결과 불확실 공개 계약에 멱등성 키 필드가 문서화되어 있지 않습니다. 호출 서비스는 중복 제출을 비활성화하고, 첫 번째 taskId를 유지하며, 다른 POST를 발행하기 전에 불확실한 네트워크 응답을 조정해야 합니다.
비용, 개인정보, 출력
검증 가능한 경계를 통합에 반영
API 사용에는 이메일 인증과 PAID 또는 COMPLETED 상태의 크레딧 주문이 최소 1건 필요합니다. 보상·체험 크레딧은 로그인한 웹 워크플로에서만 사용할 수 있으며 API로 자동화할 수 없습니다. 계정당 키는 최대 3개, 생성은 키당 분당 6회로 제한됩니다. 실패 작업은 현재 규칙에 따라 환불되고 미디어는 24시간 이내 삭제됩니다.
개발자 질문
배포 전에 확인할 내용
API는 webhook을 지원하나요?
현재 지원하지 않습니다. POST가 반환한 taskId를 저장하고 같은 워크플로 경로의 GET을 종료 상태까지 폴링하세요.
공식 SDK가 있나요?
현재 공식 언어 SDK는 공개되지 않았습니다. 표준 HTTPS, Bearer 인증, multipart와 JSON 응답을 모든 서버 HTTP 클라이언트에서 호출할 수 있습니다.
사진 작업 한 건은 몇 크레딧인가요?
사진 한 장, 일괄 출력 한 건, 단체 사진에서 선택한 얼굴 한 건은 현재 6크레딧입니다. 동영상과 GIF는 올림한 초 수와 최소 요금으로 계산됩니다.
API 키를 프론트엔드에 넣어도 되나요?
안 됩니다. API 키는 서버에 보관하고 브라우저 번들, 모바일 바이너리, 로그, 분석 이벤트, 지원 티켓에 기록하지 마세요.
대표 작업 하나로 통합을 검증
허가받은 최소 미디어 샘플로 필드, 상태, 비용, 결과 전달을 확인한 뒤 일괄 작업이나 긴 동영상으로 확장하세요.