{"openapi":"3.1.0","info":{"title":"O2O 저작권 침해 여부 탐지 API","description":"오투오 1단계 산출물 - 콘텐츠 표절 여부 AI 탐지 모듈. 본 응답 스키마는 커뮤니케이션북스(아카이빙) 및 바이칼AI(분석 보고서) 통합 기준.","version":"1.0.0"},"paths":{"/v1/health":{"get":{"tags":["meta"],"summary":"Health","operationId":"health_v1_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HealthResponse"}}}}}}},"/v1/taxonomy":{"get":{"tags":["meta"],"summary":"Taxonomy","description":"분류체계 조회 - 컴북스/바이칼이 동일 라벨링 공유용.","operationId":"taxonomy_v1_taxonomy_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TaxonomyResponse"}}}}}}},"/v1/plagiarism/detect":{"post":{"tags":["plagiarism"],"summary":"Detect","operationId":"detect_v1_plagiarism_detect_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DetectRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DetectResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/plagiarism/batch":{"post":{"tags":["plagiarism"],"summary":"Batch Create","operationId":"batch_create_v1_plagiarism_batch_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BatchRequest"}}},"required":true},"responses":{"202":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BatchCreatedResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/plagiarism/batch/{job_id}":{"get":{"tags":["plagiarism"],"summary":"Batch Status","operationId":"batch_status_v1_plagiarism_batch__job_id__get","parameters":[{"name":"job_id","in":"path","required":true,"schema":{"type":"string","title":"Job Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BatchStatusResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/corpus":{"get":{"tags":["corpus"],"summary":"Corpus List","operationId":"corpus_list_v1_corpus_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CorpusListResponse"}}}}}},"post":{"tags":["corpus"],"summary":"Corpus Upload Json","description":"JSON으로 자서전 1건 업로드. 인덱스 자동 재빌드.","operationId":"corpus_upload_json_v1_corpus_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CorpusUploadRequest"}}},"required":true},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CorpusUploadResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/corpus/file":{"post":{"tags":["corpus"],"summary":"Corpus Upload File","description":"multipart로 .txt 파일 업로드 (큰 자서전 파일용).","operationId":"corpus_upload_file_v1_corpus_file_post","requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_corpus_upload_file_v1_corpus_file_post"}}},"required":true},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CorpusUploadResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/corpus/{doc_id}":{"delete":{"tags":["corpus"],"summary":"Corpus Delete","operationId":"corpus_delete_v1_corpus__doc_id__delete","parameters":[{"name":"doc_id","in":"path","required":true,"schema":{"type":"string","title":"Doc Id"}}],"responses":{"204":{"description":"Successful Response"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}},"components":{"schemas":{"BatchCreatedResponse":{"properties":{"job_id":{"type":"string","title":"Job Id"},"status":{"type":"string","enum":["queued","running","completed","failed"],"title":"Status"},"total":{"type":"integer","title":"Total"},"created_at":{"type":"string","format":"date-time","title":"Created At"}},"type":"object","required":["job_id","status","total","created_at"],"title":"BatchCreatedResponse"},"BatchItem":{"properties":{"doc_id":{"type":"string","title":"Doc Id"},"text":{"type":"string","title":"Text"},"metadata":{"anyOf":[{"$ref":"#/components/schemas/DocumentMetadata"},{"type":"null"}]}},"type":"object","required":["doc_id","text"],"title":"BatchItem"},"BatchRequest":{"properties":{"items":{"items":{"$ref":"#/components/schemas/BatchItem"},"type":"array","maxItems":500,"minItems":1,"title":"Items"},"options":{"$ref":"#/components/schemas/DetectOptions"}},"type":"object","required":["items"],"title":"BatchRequest"},"BatchStatusResponse":{"properties":{"job_id":{"type":"string","title":"Job Id"},"status":{"type":"string","enum":["queued","running","completed","failed"],"title":"Status"},"total":{"type":"integer","title":"Total"},"processed":{"type":"integer","title":"Processed"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"finished_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Finished At"},"results":{"anyOf":[{"items":{"$ref":"#/components/schemas/DetectResponse"},"type":"array"},{"type":"null"}],"title":"Results"},"error":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error"}},"type":"object","required":["job_id","status","total","processed","created_at"],"title":"BatchStatusResponse"},"Body_corpus_upload_file_v1_corpus_file_post":{"properties":{"title":{"type":"string","title":"Title","description":"자서전 제목"},"doc_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Doc Id","description":"비우면 자동 생성"},"file":{"type":"string","contentMediaType":"application/octet-stream","title":"File","description":".txt 파일"}},"type":"object","required":["title","file"],"title":"Body_corpus_upload_file_v1_corpus_file_post"},"CorpusItem":{"properties":{"doc_id":{"type":"string","title":"Doc Id"},"title":{"type":"string","title":"Title"},"size_bytes":{"type":"integer","title":"Size Bytes","default":0},"filename":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Filename"}},"type":"object","required":["doc_id","title"],"title":"CorpusItem"},"CorpusListResponse":{"properties":{"total":{"type":"integer","title":"Total"},"docs":{"items":{"$ref":"#/components/schemas/CorpusItem"},"type":"array","title":"Docs"}},"type":"object","required":["total","docs"],"title":"CorpusListResponse"},"CorpusUploadRequest":{"properties":{"doc_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Doc Id","description":"비우면 자동 생성"},"title":{"type":"string","minLength":1,"title":"Title"},"text":{"type":"string","minLength":1,"title":"Text"}},"type":"object","required":["title","text"],"title":"CorpusUploadRequest"},"CorpusUploadResponse":{"properties":{"doc_id":{"type":"string","title":"Doc Id"},"title":{"type":"string","title":"Title"},"size_bytes":{"type":"integer","title":"Size Bytes"},"corpus_size_after":{"type":"integer","title":"Corpus Size After"},"rebuilt":{"type":"boolean","title":"Rebuilt"}},"type":"object","required":["doc_id","title","size_bytes","corpus_size_after","rebuilt"],"title":"CorpusUploadResponse"},"DetectOptions":{"properties":{"return_evidence":{"type":"boolean","title":"Return Evidence","default":true},"threshold":{"anyOf":[{"type":"number","maximum":1.0,"minimum":0.0},{"type":"null"}],"title":"Threshold","description":"None이면 서버 설정 사용. PDF VII-4 권장 0.85"},"top_k":{"type":"integer","maximum":50.0,"minimum":1.0,"title":"Top K","default":5},"autobiography_mode":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Autobiography Mode","description":"None이면 서버 설정 사용. 명시하면 요청 단위 override."}},"type":"object","title":"DetectOptions"},"DetectRequest":{"properties":{"doc_id":{"type":"string","title":"Doc Id"},"text":{"type":"string","minLength":1,"title":"Text"},"metadata":{"anyOf":[{"$ref":"#/components/schemas/DocumentMetadata"},{"type":"null"}]},"options":{"$ref":"#/components/schemas/DetectOptions"}},"type":"object","required":["doc_id","text"],"title":"DetectRequest"},"DetectResponse":{"properties":{"doc_id":{"type":"string","title":"Doc Id"},"is_infringement":{"type":"boolean","title":"Is Infringement"},"confidence":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Confidence"},"extracted_elements":{"$ref":"#/components/schemas/ExtractedElements"},"matches":{"items":{"$ref":"#/components/schemas/MatchResult"},"type":"array","title":"Matches"},"ccl_basis":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ccl Basis"},"autobiography_mode":{"type":"boolean","title":"Autobiography Mode","default":false},"candidates_before_filter":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Candidates Before Filter"},"engine_version":{"type":"string","title":"Engine Version"},"analyzed_at":{"type":"string","format":"date-time","title":"Analyzed At"}},"type":"object","required":["doc_id","is_infringement","confidence","extracted_elements","matches","engine_version","analyzed_at"],"title":"DetectResponse"},"DocumentMetadata":{"properties":{"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title"},"author":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Author"},"genre":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Genre"},"publisher":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Publisher"},"publication_year":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Publication Year"}},"type":"object","title":"DocumentMetadata"},"EvidenceSpan":{"properties":{"start":{"type":"integer","title":"Start"},"end":{"type":"integer","title":"End"},"matched":{"type":"string","title":"Matched"}},"type":"object","required":["start","end","matched"],"title":"EvidenceSpan"},"ExtractedElements":{"properties":{"characters":{"items":{"type":"string"},"type":"array","title":"Characters"},"motifs":{"items":{"type":"string"},"type":"array","title":"Motifs"},"genre":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Genre"},"keywords":{"items":{"type":"string"},"type":"array","title":"Keywords"}},"type":"object","title":"ExtractedElements"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"HealthResponse":{"properties":{"status":{"type":"string","const":"ok","title":"Status"},"engine_version":{"type":"string","title":"Engine Version"},"corpus_size":{"type":"integer","title":"Corpus Size"},"taxonomy_version":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Taxonomy Version"},"autobiography_mode":{"type":"boolean","title":"Autobiography Mode","default":false}},"type":"object","required":["status","engine_version","corpus_size"],"title":"HealthResponse"},"InfringementTag":{"properties":{"tag":{"type":"string","enum":["reproduction","public_transmission","distribution","derivative_work","publication","attribution","integrity","citation_missing","false_authorship","substandard_derivative"],"title":"Tag"},"role":{"type":"string","enum":["primary","secondary"],"title":"Role"},"label_ko":{"type":"string","title":"Label Ko"}},"type":"object","required":["tag","role","label_ko"],"title":"InfringementTag","description":"법령 기반 침해 태그. 주(primary) 또는 보조(secondary) 역할."},"MatchResult":{"properties":{"source_doc":{"type":"string","title":"Source Doc"},"source_title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source Title"},"similarity":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Similarity"},"tags":{"items":{"$ref":"#/components/schemas/InfringementTag"},"type":"array","title":"Tags"},"case_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Case Id"},"case_title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Case Title"},"infringement_type":{"type":"string","enum":["copy","transform","plot","character","background","unknown"],"title":"Infringement Type","default":"unknown"},"evidence_spans":{"items":{"$ref":"#/components/schemas/EvidenceSpan"},"type":"array","title":"Evidence Spans"},"score_breakdown":{"anyOf":[{"$ref":"#/components/schemas/ScoreBreakdown"},{"type":"null"}]}},"type":"object","required":["source_doc","similarity"],"title":"MatchResult"},"ScoreBreakdown":{"properties":{"text_sim":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Text Sim"},"lemma_sim":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Lemma Sim"},"character_sim":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Character Sim"},"motif_sim":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Motif Sim"},"lsh_jaccard":{"anyOf":[{"type":"number","maximum":1.0,"minimum":0.0},{"type":"null"}],"title":"Lsh Jaccard"}},"type":"object","required":["text_sim","lemma_sim","character_sim","motif_sim"],"title":"ScoreBreakdown"},"TaxonomyResponse":{"properties":{"meta_tags_version":{"type":"string","title":"Meta Tags Version"},"cases_version":{"type":"string","title":"Cases Version"},"meta_tags":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Meta Tags"},"cases":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Cases"}},"type":"object","required":["meta_tags_version","cases_version","meta_tags","cases"],"title":"TaxonomyResponse"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}}}}