Deepfake 오디오 검출 API

개요

Deepfake 오디오 검출 API는 사용자가 업로드한 오디오 파일이 AI로 생성된 가짜 음성(deepfake)인지 실제 음성(bonafide)인지 판별하는 딥러닝 기반 서비스입니다.
고성능 transformer 모델을 사용하여 정확한 deepfake 검출을 제공합니다.

---

오디오 검출 예시

샘플 1: 실제 음성 (Bonafide)

실제 사람이 녹음한 음성입니다.

샘플 2: AI 생성 음성 (Deepfake)

딥러닝 모델로 생성된 합성 음성입니다.

---

API 엔드포인트

POST https://medisensing.kr/api/deepfake/detect

인증 방식은 마이페이지에서 발급된 토큰을 사용합니다.

---

요청 (Request)

요청 헤더

Content-Type: multipart/form-data
X-API-Key: <api_key>

요청 파라미터

이름	타입	필수	설명
file	file	O	오디오 파일 (WAV/FLAC/MP3, 최대 500MB)

---

응답 (Response)

성공 응답 (200 OK)

{
  "status": "success",
  "job_id": "abc123",
  "processing_time": 2.35,
  "model_info": {
    "feature_extractor_sampling_rate": 16000
  },
  "detection_result": {
    "predicted": "bonafide",
    "confidence": 0.95,
    "filename": "sample.flac"
  }
}

오류 응답 예시

{
  "detail": "Invalid API key"
}

가능한 오류 코드: - 400 Bad Request: 파일 누락 또는 형식 오류 - 401 Unauthorized: 잘못된 API 키 - 413 Payload Too Large: 파일 크기 초과 - 500 Internal Server Error: 서버 내부 오류

---

샘플 요청

cURL

curl -X POST "https://medisensing.kr/api/deepfake/detect" \\
  -H "X-API-Key: YOUR_API_KEY" \\
  -F "file=@bonafide_1.flac"

JavaScript (fetch)

const formData = new FormData();
formData.append("file", fileInput.files[0]);

fetch("https://medisensing.kr/api/deepfake/detect", {
  method: "POST",
  headers: {
    "X-API-Key": "YOUR_API_KEY"
  },
  body: formData
})
  .then(res => res.json())
  .then(console.log)
  .catch(console.error);

---

직접 테스트 (Demo)

오디오 파일 선택

API Key

Deepfake 검출 요청

응답 미리보기

---

검출 결과 해석

라벨 설명

• bonafide: 실제 사람이 녹음한 음성
• spoof: AI로 생성된 합성 음성 (deepfake)

신뢰도 점수

• 90% 이상: 매우 높은 신뢰도
• 80-90%: 높은 신뢰도
• 70-80%: 중간 신뢰도
• 70% 미만: 낮은 신뢰도 (추가 검증 권장)

---

참고

• 파일 형식: WAV, FLAC, MP3 지원
• 파일 크기: 최대 500MB 지원
• 오디오 길이: 제한 없음 (긴 파일은 처리 시간 증가)
• 처리 시간: 파일 크기에 따라 5-30초 소요
• 정확도: 평균 95% 이상의 높은 정확도 제공