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

열	뜻
`verdict`	`AI` 또는 `Human` 두 값뿐입니다
`grade`	A — 파일이 생성 사실을 밝힘(재확인 가능). B — 음향 분석만
`sha256`	우리가 분석한 바로 그 바이트의 해시
`error`	처리 못 한 트랙에만. 과금하지 않습니다

오탐 신고

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

오류

상태	뜻
400	본문 오류이거나 쓸 수 있는 트랙이 없음
401	키 없음 또는 모르는 키
404	없는 배치이거나 내 것이 아님
413	요청당 5,000곡 초과
429	월 한도 소진

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