API

엔드포인트 다섯 개. SDK 없습니다.

배치를 넣고, 진행을 조회하고, CSV 를 받습니다. curl 로 됩니다.

인증

모든 요청에 X-API-Key 를 붙입니다. 키는 조직 단위이며 플랜의 월 한도를 따릅니다.

배치 제출

curl -X POST https://oneeda.net/v1/batches \
  -H "X-API-Key: $KEY" -H "Content-Type: application/json" \
  -d '{"label":"2026 sync library","tracks":[
        {"filename":"0001.wav","url":"https://your-bucket/0001.wav"}
      ]}'

프리사인드 URL 이어도 됩니다. 파일은 한 번만 읽습니다. 요청당 최대 5,000곡. 응답은 202 입니다.

목록과 진행

GET /v1/batches            # 내 배치 전부
GET /v1/batches/{id}       # 진행 상황과 판정 집계
GET /v1/batches/{id}/tracks?filter=ai
GET /v1/usage              # 이번 달 사용량

결과

GET /v1/batches/{id}/results.csv

filename,sha256,verdict,grade,duration_sec,error

엑셀 감사표

GET /v1/batches/{id}/results.xlsx

CSV 와 같은 소유자 규칙입니다. 시트: Summary, AI flagged, Not flagged, Failed, All tracks. 501 이면 서버가 통합 문서를 만들지 못한 것이니 CSV 를 쓰세요.

공유 리포트

검사 페이지의 무료 검사는 report_url (GET /r/{id})과 배지(GET /r/{id}/badge.svg)를 돌려줍니다. 리포트에는 판정, 근거 등급, 표기된 생성기, 길이, 시각, SHA-256 이 담기며 파일명과 오디오는 담기지 않습니다. 링크를 가진 사람은 열 수 있고 검색에는 잡히지 않습니다. 자동 검사 한 번의 기록일 뿐 누가 만들었는지를 인증하지 않습니다.

오탐 신고

POST /v1/reports  {"batch_id":"…","filename":"…","note":"…"}

오류

정확도와 측정 조건은 측정 방법과 알려진 한계에 있습니다. 자동 삭제 경로에 물리기 전에 반드시 읽어주십시오.