{"openapi":"3.1.0","info":{"title":"DJ-prod","version":"0.1.0"},"paths":{"/user/signup":{"post":{"tags":["User"],"summary":"Sign User Up","operationId":"sign_user_up_user_signup_post","requestBody":{"content":{"application/json":{"schema":{"type":"object","title":"Request"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/user/signin":{"post":{"tags":["User"],"summary":"Sign User In","operationId":"sign_user_in_user_signin_post","requestBody":{"content":{"application/x-www-form-urlencoded":{"schema":{"$ref":"#/components/schemas/Body_sign_user_in_user_signin_post"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/user/info":{"get":{"tags":["User"],"summary":"Get User Info","operationId":"get_user_info_user_info_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","title":"Response Get User Info User Info Get"}}}}}}},"/user/users":{"get":{"tags":["User"],"summary":"Get Users","operationId":"get_users_user_users_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"items":{},"type":"array","title":"Response Get Users User Users Get"}}}}}}},"/user/delete":{"delete":{"tags":["User"],"summary":"Delete User By Id","operationId":"delete_user_by_id_user_delete_delete","parameters":[{"name":"user_id","in":"query","required":true,"schema":{"type":"string","title":"User Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/user/approve_id":{"post":{"tags":["User"],"summary":"Delete User By Id","operationId":"delete_user_by_id_user_approve_id_post","parameters":[{"name":"user_id","in":"query","required":true,"schema":{"type":"string","title":"User Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/user/approve_username":{"post":{"tags":["User"],"summary":"Delete User By Id","operationId":"delete_user_by_id_user_approve_username_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/search/sentence/":{"post":{"tags":["특허 검색 API"],"summary":"자연어 텍스트로 특허 검색","description":"자연어 텍스트나 검색식을 입력받아 관련 특허를 검색합니다.\n    \n    **검색 방식:**\n    1. **검색식 모드**: 필드 지정자(tl:, ab: 등)가 포함된 경우\n    2. **자연어 모드**: 일반 텍스트를 AI로 분석하여 검색\n    \n    **AI 기능:**\n    - 중요 키워드 자동 추출\n    - Boolean 쿼리 자동 생성\n    - 임베딩 기반 유사도 검색\n    - 의미적 유사성 분석\n    \n    **응답 포함 항목:**\n    - results: 검색된 특허 목록 (유사도 점수 포함)\n    - keywords: AI가 추출한 중요 키워드","operationId":"sentence_search_search_sentence__post","parameters":[{"name":"user","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"User"}},{"name":"access_token","in":"cookie","required":false,"schema":{"type":"string","title":"Access Token"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UploadRequest"}}}},"responses":{"200":{"description":"검색 결과와 추출된 키워드","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SentenceResponse"},"examples":{"자연어 검색 결과":{"summary":"자연어 입력에 대한 검색 결과","value":{"results":[{"applicationNumber":"KR1020170134345","similarity":85,"year":"2017","applicationDate":"20171025","applicants":"삼성전자주식회사","inventors":"김철수","cpc":"G06F"}],"keywords":["인공지능","데이터처리","머신러닝"]}},"검색식 검색 결과":{"summary":"검색식 입력에 대한 검색 결과","value":{"results":[{"applicationNumber":"KR1020180056789","year":"2018","applicationDate":"20180515","applicants":"엘지전자주식회사","inventors":"이영희","cpc":"H04L"}],"keywords":["통신","네트워크","5G"]}}}}}},"404":{"description":"Not found"},"500":{"description":"Internal server error"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/search/sentence_jp/":{"post":{"tags":["특허 검색 API"],"summary":"일본어 텍스트로 특허 검색 (JP 우선)","description":"일본어 자연어 텍스트나 검색식을 입력받아 JP 인덱스를 우선 검색하고,\n    필요 시 KR/US 인덱스도 함께 검색합니다.\n\n    - DSL 모드: 입력 검색식을 JP 인덱스에 원문으로 적용\n    - 자연어 모드: 일본어 키워드/불린 쿼리를 생성하여 임베딩+불린 하이브리드 검색 수행","operationId":"sentence_search_jp_search_sentence_jp__post","parameters":[{"name":"user","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"User"}},{"name":"access_token","in":"cookie","required":false,"schema":{"type":"string","title":"Access Token"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UploadRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SentenceResponse"}}}},"404":{"description":"Not found"},"500":{"description":"Internal server error"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/search/filter/":{"post":{"tags":["특허 검색 API"],"summary":"이전 검색 결과를 필터링","description":"이전에 검색된 특허 목록에서 추가 조건으로 필터링을 수행합니다.\n    \n    **주요 기능:**\n    - 출원번호 목록을 기반으로 한 필터링\n    - 다양한 검색 조건 지원 (제목, 요약, 청구항, 출원인 등)\n    - source_list를 통한 선택적 필드 반환\n    \n    **검색 조건:**\n    - tl: 제목 검색\n    - ab: 요약 검색  \n    - cl: 청구항 검색\n    - ap: 출원인 검색\n    - cpc: CPC 분류 검색\n    - 날짜 범위: pdRanges, adRanges, gdRanges\n    \n    **조건 연산자:** AND, OR","operationId":"filter_search_filter__post","parameters":[{"name":"user","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"User"}},{"name":"access_token","in":"cookie","required":false,"schema":{"type":"string","title":"Access Token"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FilterRequest"}}}},"responses":{"200":{"description":"필터링된 특허 정보","content":{"application/json":{"schema":{},"examples":{"제목 필터링 결과":{"summary":"제목에 '인공지능'이 포함된 특허 필터링 결과","value":[{"applicationNumber":"KR1020170134345","inventionTitleKorean":"인공지능 기반 데이터 처리 방법","abstract":"본 발명은 인공지능을 이용하여...","registed":true,"Country":"KR"}]}}}}},"404":{"description":"Not found"},"500":{"description":"Internal server error"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/search/filter_dsl/":{"post":{"tags":["특허 검색 API"],"summary":"DSL 검색식으로 특허 필터링","description":"DSL(Domain Specific Language) 검색식을 사용하여 특정 특허 목록을 필터링합니다.\n    \n    **DSL 검색식 문법:**\n    - 필드 지정: tl:(제목), ab:(요약), cl:(청구항)\n    - 논리 연산자: AND, OR, NOT\n    - 괄호 그룹핑: (조건1 AND 조건2) OR 조건3\n    - 와일드카드: * (단어 끝)\n    \n    **예시 검색식:**\n    - `tl:(인공지능 OR AI) AND ab:데이터`\n    - `cl:알고리즘 AND NOT tl:게임`\n    - `(ap:삼성 OR ap:엘지) AND cpc:G06F*`","operationId":"filter_dsl_search_filter_dsl__post","parameters":[{"name":"access_token","in":"cookie","required":false,"schema":{"type":"string","title":"Access Token"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","title":"Request"}}}},"responses":{"200":{"description":"필터링된 출원번호 목록","content":{"application/json":{"schema":{"type":"array","items":{"type":"string"},"title":"Response Filter Dsl Search Filter Dsl  Post"},"examples":{"DSL 필터링 결과":{"summary":"DSL 검색식으로 필터링된 출원번호들","value":["KR1020170134345","KR1020180056789","KR1020190012345"]}}}}},"404":{"description":"Not found"},"500":{"description":"Internal server error"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/search/compare_claims/":{"post":{"tags":["특허 검색 API"],"summary":"특허 청구항 유사도 비교","description":"기준 발명과 여러 특허의 청구항을 비교하여 유사도를 분석합니다.\n    \n    **주요 기능:**\n    - AI 기반 청구항 유사도 분석\n    - 다중 특허 동시 비교\n    - 구체적인 유사도 점수 제공\n    - 회피 설계 지원\n    - 다국어 지원 (한국어, 영어, 일본어)\n    \n    **입력 형식:**\n    - invention: 기준이 되는 발명 설명\n    - avoidPatent: 비교할 특허들 (특별한 형식으로 구분)\n    - lang: 언어 설정 (kr: 한국어, en: 영어, jp: 일본어, 기본값: kr)\n    \n    **용도:**\n    - 특허 침해 분석\n    - 회피 설계\n    - 선행기술 조사","operationId":"compare_claims_search_compare_claims__post","parameters":[{"name":"user","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"User"}},{"name":"access_token","in":"cookie","required":false,"schema":{"type":"string","title":"Access Token"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompareClaimsRequest"}}}},"responses":{"200":{"description":"청구항 유사도 비교 결과","content":{"application/json":{"schema":{},"examples":{"청구항 비교 결과":{"summary":"발명과 기존 특허들의 유사도 분석 결과","value":[{"id":"1","similarity_score":0.85,"analysis":"구성요소가 매우 유사함","risk_level":"높음"},{"id":"2","similarity_score":0.45,"analysis":"일부 구성요소만 유사함","risk_level":"낮음"}]}}}}},"404":{"description":"Not found"},"500":{"description":"Internal server error"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/search/differentiation_point/":{"post":{"tags":["특허 검색 API"],"summary":"발명 아이디어 차별화 포인트 생성","description":"발명 설명, 유사 특허, 청구항 비교 결과를 기반으로 우림 선행기술조사 보고서용 차별화 포인트 문구를 생성합니다.","operationId":"differentiation_point_search_differentiation_point__post","parameters":[{"name":"user","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"User"}},{"name":"access_token","in":"cookie","required":false,"schema":{"type":"string","title":"Access Token"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DifferentiationPointRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DifferentiationPointResponse"}}}},"404":{"description":"Not found"},"500":{"description":"Internal server error"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/search/numbers/":{"post":{"tags":["특허 검색 API"],"summary":"특허 출원번호로 특허 정보 조회","description":"특허 출원번호 목록을 받아 해당 특허들의 정보를 조회합니다.\n    \n    **주요 기능:**\n    - 한국(KR) 및 미국(US) 특허 지원\n    - source_list를 통한 선택적 필드 반환\n    - 대용량 요청 처리 지원\n    \n    **source_list 옵션:**\n    - 지정하지 않으면: 모든 필드 반환\n    - 지정하면: 해당 필드만 반환\n    - 잘못된 필드는 \"invalid\" 값으로 표시\n    \n    **사용 가능한 필드:** ApplicationNumber, Title, Summary, MainCPC, ApplicantName, InventorName, Claims, OpenDate, RegisterDate 등","operationId":"numbers_search_numbers__post","parameters":[{"name":"user","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"User"}},{"name":"access_token","in":"cookie","required":false,"schema":{"type":"string","title":"Access Token"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NumbersRequest"}}}},"responses":{"200":{"description":"성공적으로 조회된 특허 정보","content":{"application/json":{"schema":{},"examples":{"기본 정보만 조회 결과":{"summary":"기본 정보만 요청했을 때의 응답","value":[{"applicationNumber":"KR1020170134345","inventionTitleKorean":"인공지능 기반 데이터 처리 방법","applicants":["삼성전자주식회사"],"registed":true,"_score":1.0,"Country":"KR"}]},"전체 정보 조회 결과":{"summary":"모든 필드를 요청했을 때의 응답","value":[{"applicationNumber":"KR1020170134345","cpc":"G06F17/30","publicNumber":"1020190048123","publicDate":"20190425","applicationDate":"20171025","applicants":["삼성전자주식회사"],"inventors":["김철수","이영희"],"inventionTitleKorean":"인공지능 기반 데이터 처리 방법","abstract":"본 발명은 인공지능을 이용하여...","claims":"1. 데이터를 입력받는 단계...","registed":true,"_score":1.0,"Country":"KR"}]}}}}},"404":{"description":"Not found"},"500":{"description":"Internal server error"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/search/fields/":{"get":{"tags":["특허 검색 API"],"summary":"사용 가능한 필드 목록 조회","description":"source_list에서 사용할 수 있는 모든 필드 목록과 설명을 제공합니다.\n    \n    **필드 카테고리:**\n    - 기본 정보: 출원번호, 제목, 요약 등\n    - 출원인 정보: 출원인, 발명자, 대리인\n    - 날짜 정보: 출원일, 공개일, 등록일\n    - 기술 정보: CPC 분류, 청구항, 상세설명\n    - 법적 정보: 등록 여부, 공개번호 등","operationId":"get_available_fields_search_fields__get","parameters":[{"name":"access_token","in":"cookie","required":false,"schema":{"type":"string","title":"Access Token"}}],"responses":{"200":{"description":"사용 가능한 필드 목록과 설명","content":{"application/json":{"schema":{},"example":{"KR":{"basic_info":{"ApplicationNumber":"출원번호","Title":"발명의 명칭","Summary":"요약"},"applicant_info":{"ApplicantName":"출원인명","InventorName":"발명자명","AgentNames":"대리인명"},"date_info":{"ApplicationDate":"출원일","OpenDate":"공개일","RegisterDate":"등록일"},"technical_info":{"MainCPC":"주요 CPC 분류","Claims":"청구항","Background":"배경기술","Problem":"해결과제","Embodiment":"실시예","Effects":"발명의 효과"}},"US":{"basic_info":{"ApplicationNumber":"출원번호","Title":"발명의 명칭","Summary":"요약"},"applicant_info":{"ApplicantName":"출원인명","InventorName":"발명자명","AssigneeName":"양수인명"}}}}}},"404":{"description":"Not found"},"500":{"description":"Internal server error"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/patent/numbers/":{"post":{"tags":["특허 정보 조회 API"],"summary":"특허 출원번호로 특허 정보 조회 (인증 필요)","operationId":"get_patents_by_numbers_patent_numbers__post","parameters":[{"name":"access_token","in":"cookie","required":false,"schema":{"type":"string","title":"Access Token"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NumbersRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"404":{"description":"Not found"},"500":{"description":"Internal server error"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/patent/numbers/":{"post":{"tags":["특허 정보 조회 API (Public v1)"],"summary":"특허 출원번호로 특허 정보 조회 (v1 공개 API)","operationId":"get_patents_by_numbers_v1_v1_patent_numbers__post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NumbersRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"404":{"description":"Not found"},"500":{"description":"Internal server error"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/patent/expression/":{"post":{"tags":["특허 정보 조회 API (Public v1)"],"summary":"DSL 검색식으로 특허 상세 정보 조회","operationId":"expression_search_v1_patent_expression__post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExpressionRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExpressionResponse"}}}},"404":{"description":"Not found"},"500":{"description":"Internal server error"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/patent/sentence/":{"post":{"tags":["특허 정보 조회 API (Public v1)"],"summary":"[Data Layer] 특허 검색 (데이터 전용)","description":"임베딩 벡터와 키워드를 받아 로컬 DB를 검색합니다.","operationId":"sentence_search_v1_v1_patent_sentence__post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SentenceDataRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SentenceResponse"}}}},"404":{"description":"Not found"},"500":{"description":"Internal server error"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/patent/similar/":{"post":{"tags":["특허 정보 조회 API (Public v1)"],"summary":"[Data Layer] 시드 문헌 기반 유사 검색 (PS-1454)","description":"시드 출원번호의 기존 dense 청크 벡터들을 재사용(다중 쿼리 max-fusion)해 동일 국가 유사 문헌을 반환합니다. 응답 형태는 /sentence/와 동일. 에러: 404 seed_not_found / 422 seed_out_of_coverage.","operationId":"similar_document_search_v1_v1_patent_similar__post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SimilarDocumentRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SentenceResponse"}}}},"404":{"description":"Not found"},"500":{"description":"Internal server error"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/patent/sentence/gemini/":{"post":{"tags":["특허 정보 조회 API (Public v1)"],"summary":"Gemini 자연어 특허 검색 및 재정렬","description":"Gemini 임베딩으로 Milvus 후보를 최대 400건 검색합니다. Gemini 점수 30%와 TF-IDF 70%로 합산하고, Laya가 설정되면 상위 100건을 재정렬합니다. GEMINI_SEARCH_ENABLED=true일 때만 결과를 반환합니다. 호출당 Gemini API 과금 발생. countries(PS-1745, 예: [\"KR\",\"US\"])면 국가별 Milvus를 병렬 검색해 점수로 병합합니다(기본 [\"KR\"]). 응답에 unavailable_countries(기동 시 미연결이라 제외된 국가 목록)가 항상 실립니다. 에러: 503 embedding_engine_unavailable(엔진 미기동·Gemini 실패) / 503 milvus_unavailable(요청 국가 전부 Milvus 미연결) / 504 embedding_engine_timeout / 500 search_engine_error.","operationId":"sentence_search_gemini_v1_v1_patent_sentence_gemini__post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GeminiSentenceRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"404":{"description":"Not found"},"500":{"description":"Internal server error"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/patent/multimodal/gemini/":{"post":{"tags":["특허 정보 조회 API (Public v1)"],"summary":"[도면 검색] 다중 도면 멀티모달 Gemini 검색","description":"도면 이미지 최대 5장(+선택 텍스트)을 받아 임베딩 + Milvus dense 검색을 수행합니다. fuse=true(기본) 도면 융합 1회 검색 / false 도면별 검색 후 RRF(순위 기반) 병합(도면별 점수 보존, rrf_score 노출). 통합 결과(results/numbers/similarities/stats) + 한국어 통합 도면 해석(drawing_description) + mode 반환. 호출당 Gemini API 과금 발생.","operationId":"multimodal_search_gemini_v1_v1_patent_multimodal_gemini__post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GeminiMultimodalRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"404":{"description":"Not found"},"500":{"description":"Internal server error"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/download/{file_name}":{"get":{"tags":["Download"],"summary":"Download File","operationId":"download_file_download__file_name__get","parameters":[{"name":"file_name","in":"path","required":true,"schema":{"type":"string","title":"File Name"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/history/user_search":{"post":{"tags":["History"],"summary":"User Search","operationId":"user_search_history_user_search_post","parameters":[{"name":"access_token","in":"cookie","required":false,"schema":{"type":"string","title":"Access Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/HistorySearch"},"title":"Response User Search History User Search Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/history/search":{"post":{"tags":["History"],"summary":"Search","operationId":"search_history_search_post","parameters":[{"name":"access_token","in":"cookie","required":false,"schema":{"type":"string","title":"Access Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/HistorySearch"},"title":"Response Search History Search Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/history/description":{"post":{"tags":["History"],"summary":"Description","operationId":"description_history_description_post","parameters":[{"name":"access_token","in":"cookie","required":false,"schema":{"type":"string","title":"Access Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TokenResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/write/write_claims/":{"post":{"tags":["Write"],"summary":"Write Claim","operationId":"write_claim_write_write_claims__post","parameters":[{"name":"access_token","in":"cookie","required":false,"schema":{"type":"string","title":"Access Token"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/routes__write__WriteClaimsRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/write/write_claims_v2/":{"post":{"tags":["Write"],"summary":"Write Claim V2","description":"V2 테스트: 통합 프롬프트로 GPT 호출 횟수 4→2 줄인 버전","operationId":"write_claim_v2_write_write_claims_v2__post","parameters":[{"name":"access_token","in":"cookie","required":false,"schema":{"type":"string","title":"Access Token"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/routes__write__WriteClaimsRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/write/write_specification/possible_ids":{"get":{"tags":["Write"],"summary":"Get Possible Ids","operationId":"get_possible_ids_write_write_specification_possible_ids_get","parameters":[{"name":"access_token","in":"cookie","required":false,"schema":{"type":"string","title":"Access Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PossibleIDsResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/write/write_specification/all_exclude":{"post":{"tags":["Write"],"summary":"Write Specification All Exclude","operationId":"write_specification_all_exclude_write_write_specification_all_exclude_post","parameters":[{"name":"access_token","in":"cookie","required":false,"schema":{"type":"string","title":"Access Token"}}],"requestBody":{"content":{"application/x-www-form-urlencoded":{"schema":{"allOf":[{"$ref":"#/components/schemas/Body_write_specification_all_exclude_write_write_specification_all_exclude_post"}],"title":"Body"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/write/write_specification_Embodiment/":{"post":{"tags":["Write"],"summary":"Write Specification","operationId":"write_specification_write_write_specification_Embodiment__post","parameters":[{"name":"access_token","in":"cookie","required":false,"schema":{"type":"string","title":"Access Token"}}],"requestBody":{"content":{"application/x-www-form-urlencoded":{"schema":{"allOf":[{"$ref":"#/components/schemas/Body_write_specification_write_write_specification_Embodiment__post"}],"title":"Body"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/write/write_specification/prior_patent":{"post":{"tags":["Write"],"summary":"Write Specification Prior Patent","operationId":"write_specification_prior_patent_write_write_specification_prior_patent_post","parameters":[{"name":"access_token","in":"cookie","required":false,"schema":{"type":"string","title":"Access Token"}}],"requestBody":{"content":{"application/x-www-form-urlencoded":{"schema":{"allOf":[{"$ref":"#/components/schemas/Body_write_specification_prior_patent_write_write_specification_prior_patent_post"}],"title":"Body"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/write/write_specification/{id}":{"post":{"tags":["Write"],"summary":"Write Specification","operationId":"write_specification_write_write_specification__id__post","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","title":"Id"}},{"name":"access_token","in":"cookie","required":false,"schema":{"type":"string","title":"Access Token"}}],"requestBody":{"content":{"application/x-www-form-urlencoded":{"schema":{"allOf":[{"$ref":"#/components/schemas/Body_write_specification_write_write_specification__id__post"}],"title":"Body"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/write/save_history_description/":{"post":{"tags":["Write"],"summary":"Save History Description","operationId":"save_history_description_write_save_history_description__post","parameters":[{"name":"access_token","in":"cookie","required":false,"schema":{"type":"string","title":"Access Token"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","title":"Request"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/write/write_Description/":{"post":{"tags":["Write"],"summary":"Write Claims","operationId":"write_claims_write_write_Description__post","parameters":[{"name":"access_token","in":"cookie","required":false,"schema":{"type":"string","title":"Access Token"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","title":"Request"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/write/save_and_download/":{"post":{"tags":["Write"],"summary":"Write Claims","operationId":"write_claims_write_save_and_download__post","parameters":[{"name":"access_token","in":"cookie","required":false,"schema":{"type":"string","title":"Access Token"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","title":"Request"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/write/write_draft/":{"get":{"tags":["Write"],"summary":"Write Draft Page","operationId":"write_draft_page_write_write_draft__get","responses":{"200":{"description":"Successful Response","content":{"text/html":{"schema":{"type":"string"}}}}}},"post":{"tags":["Write"],"summary":"Write Draft","operationId":"write_draft_write_write_draft__post","requestBody":{"content":{"application/json":{"schema":{"type":"object","title":"Body"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/write/cpc_eval/":{"post":{"tags":["Write"],"summary":"Cpc Eval","description":"CPC 추론값과 분류 근거(설명)·사용 프롬프트까지 반환하는 평가용 엔드포인트.\n\n명세서 생성 플로우에 영향을 주지 않는 순수 추가 엔드포인트로,\nlang 에 맞는 핸들러의 get_cpc_chatgpt_detail 을 1회 호출해\nCPC 분류 첫 글자와 함께 LLM 이 내놓은 설명, 그리고 실제 사용한\n프롬프트 템플릿 문자열을 함께 돌려준다.\n어떤 예외가 나도 500 을 내지 않고 error 필드에 메시지를 담아 200 으로 graceful 반환한다.\n\n호출자는 error 가 비어있지 않으면 실패로 간주하므로,\nerror 는 실제 추론 실패(예외/빈 text)일 때만 채우고 성공 시에는 None 으로 둔다.\n폴백 안내문은 실패 여부와 무관한 별도 필드 note 로 분리한다.\n\nprompt_used 는 {text} 가 치환되지 않은 CPC_CLASSIFICATION 원본 템플릿 문자열로,\n\"로직 기반 확인\"용 정적 노출이다. lang 이 jp 면 JP 템플릿, 그 외에는\nkr 핸들러로 폴백하므로 Common 템플릿을 노출한다.","operationId":"cpc_eval_write_cpc_eval__post","parameters":[{"name":"access_token","in":"cookie","required":false,"schema":{"type":"string","title":"Access Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/write_en/write_claims/":{"post":{"tags":["Write_en"],"summary":"Write Claim","operationId":"write_claim_write_en_write_claims__post","parameters":[{"name":"access_token","in":"cookie","required":false,"schema":{"type":"string","title":"Access Token"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/routes__write_en__WriteClaimsRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/write_en/write_specification/possible_ids":{"get":{"tags":["Write_en"],"summary":"Get Possible Ids","operationId":"get_possible_ids_write_en_write_specification_possible_ids_get","parameters":[{"name":"access_token","in":"cookie","required":false,"schema":{"type":"string","title":"Access Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PossibleIDsResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/write_en/write_specification/all":{"post":{"tags":["Write_en"],"summary":"Write Specification All","operationId":"write_specification_all_write_en_write_specification_all_post","parameters":[{"name":"access_token","in":"cookie","required":false,"schema":{"type":"string","title":"Access Token"}}],"requestBody":{"content":{"application/x-www-form-urlencoded":{"schema":{"allOf":[{"$ref":"#/components/schemas/Body_write_specification_all_write_en_write_specification_all_post"}],"title":"Body"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/write_en/write_specification/all_exclude":{"post":{"tags":["Write_en"],"summary":"Write Specification All Exclude","description":"미국(USPTO) 영문 명세서. 한국어 all_exclude와 같은 입력·같은 응답 키를 쓴다.\n\n섹션별 생성 파이프라인을 영문 프롬프트로 돌리며, 실패하면 한국어 레거시로 내려가지 않고 오류를 돌려준다.","operationId":"write_specification_all_exclude_write_en_write_specification_all_exclude_post","parameters":[{"name":"access_token","in":"cookie","required":false,"schema":{"type":"string","title":"Access Token"}}],"requestBody":{"content":{"application/x-www-form-urlencoded":{"schema":{"allOf":[{"$ref":"#/components/schemas/Body_write_specification_all_exclude_write_en_write_specification_all_exclude_post"}],"title":"Body"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/write_en/write_specification/{id}":{"post":{"tags":["Write_en"],"summary":"Write Specification","operationId":"write_specification_write_en_write_specification__id__post","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","title":"Id"}},{"name":"access_token","in":"cookie","required":false,"schema":{"type":"string","title":"Access Token"}}],"requestBody":{"content":{"application/x-www-form-urlencoded":{"schema":{"allOf":[{"$ref":"#/components/schemas/Body_write_specification_write_en_write_specification__id__post"}],"title":"Body"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/write_en/save_history_description/":{"post":{"tags":["Write_en"],"summary":"Save History Description","operationId":"save_history_description_write_en_save_history_description__post","parameters":[{"name":"access_token","in":"cookie","required":false,"schema":{"type":"string","title":"Access Token"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","title":"Request"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/write_en/write_Description/":{"post":{"tags":["Write_en"],"summary":"Write Claims","operationId":"write_claims_write_en_write_Description__post","parameters":[{"name":"access_token","in":"cookie","required":false,"schema":{"type":"string","title":"Access Token"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","title":"Request"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/write_cn/write_claims/":{"post":{"tags":["Write_cn"],"summary":"Write Claim","operationId":"write_claim_write_cn_write_claims__post","parameters":[{"name":"access_token","in":"cookie","required":false,"schema":{"type":"string","title":"Access Token"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/routes__write_cn__WriteClaimsRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/write_cn/write_specification/possible_ids":{"get":{"tags":["Write_cn"],"summary":"Get Possible Ids","operationId":"get_possible_ids_write_cn_write_specification_possible_ids_get","parameters":[{"name":"access_token","in":"cookie","required":false,"schema":{"type":"string","title":"Access Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PossibleIDsResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/write_cn/write_specification/all":{"post":{"tags":["Write_cn"],"summary":"Write Specification All","operationId":"write_specification_all_write_cn_write_specification_all_post","parameters":[{"name":"access_token","in":"cookie","required":false,"schema":{"type":"string","title":"Access Token"}}],"requestBody":{"content":{"application/x-www-form-urlencoded":{"schema":{"allOf":[{"$ref":"#/components/schemas/Body_write_specification_all_write_cn_write_specification_all_post"}],"title":"Body"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/write_cn/write_specification/{id}":{"post":{"tags":["Write_cn"],"summary":"Write Specification","operationId":"write_specification_write_cn_write_specification__id__post","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","title":"Id"}},{"name":"access_token","in":"cookie","required":false,"schema":{"type":"string","title":"Access Token"}}],"requestBody":{"content":{"application/x-www-form-urlencoded":{"schema":{"allOf":[{"$ref":"#/components/schemas/Body_write_specification_write_cn_write_specification__id__post"}],"title":"Body"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/write_cn/save_history_description/":{"post":{"tags":["Write_cn"],"summary":"Save History Description","operationId":"save_history_description_write_cn_save_history_description__post","parameters":[{"name":"access_token","in":"cookie","required":false,"schema":{"type":"string","title":"Access Token"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","title":"Request"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/write_cn/write_Description/":{"post":{"tags":["Write_cn"],"summary":"Write Claims","operationId":"write_claims_write_cn_write_Description__post","parameters":[{"name":"access_token","in":"cookie","required":false,"schema":{"type":"string","title":"Access Token"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","title":"Request"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/write_jp/write_claims/":{"post":{"tags":["Write_jp"],"summary":"Write Claim","operationId":"write_claim_write_jp_write_claims__post","parameters":[{"name":"access_token","in":"cookie","required":false,"schema":{"type":"string","title":"Access Token"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/routes__write_jp__WriteClaimsRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/write_jp/write_specification/possible_ids":{"get":{"tags":["Write_jp"],"summary":"Get Possible Ids","operationId":"get_possible_ids_write_jp_write_specification_possible_ids_get","parameters":[{"name":"access_token","in":"cookie","required":false,"schema":{"type":"string","title":"Access Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PossibleIDsResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/write_jp/write_specification/all_exclude":{"post":{"tags":["Write_jp"],"summary":"Write Specification All Exclude","operationId":"write_specification_all_exclude_write_jp_write_specification_all_exclude_post","parameters":[{"name":"access_token","in":"cookie","required":false,"schema":{"type":"string","title":"Access Token"}}],"requestBody":{"content":{"application/x-www-form-urlencoded":{"schema":{"allOf":[{"$ref":"#/components/schemas/Body_write_specification_all_exclude_write_jp_write_specification_all_exclude_post"}],"title":"Body"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/write_jp/write_specification_Embodiment/":{"post":{"tags":["Write_jp"],"summary":"Write Specification","operationId":"write_specification_write_jp_write_specification_Embodiment__post","parameters":[{"name":"access_token","in":"cookie","required":false,"schema":{"type":"string","title":"Access Token"}}],"requestBody":{"content":{"application/x-www-form-urlencoded":{"schema":{"allOf":[{"$ref":"#/components/schemas/Body_write_specification_write_jp_write_specification_Embodiment__post"}],"title":"Body"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/write_jp/write_specification/{id}":{"post":{"tags":["Write_jp"],"summary":"Write Specification","operationId":"write_specification_write_jp_write_specification__id__post","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","title":"Id"}},{"name":"access_token","in":"cookie","required":false,"schema":{"type":"string","title":"Access Token"}}],"requestBody":{"content":{"application/x-www-form-urlencoded":{"schema":{"allOf":[{"$ref":"#/components/schemas/Body_write_specification_write_jp_write_specification__id__post"}],"title":"Body"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/write_jp/save_history_description/":{"post":{"tags":["Write_jp"],"summary":"Save History Description","operationId":"save_history_description_write_jp_save_history_description__post","parameters":[{"name":"access_token","in":"cookie","required":false,"schema":{"type":"string","title":"Access Token"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","title":"Request"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/write_jp/write_Description/":{"post":{"tags":["Write_jp"],"summary":"Write Claims","operationId":"write_claims_write_jp_write_Description__post","parameters":[{"name":"access_token","in":"cookie","required":false,"schema":{"type":"string","title":"Access Token"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","title":"Request"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/write_jp/save_and_download/":{"post":{"tags":["Write_jp"],"summary":"Write Claims","operationId":"write_claims_write_jp_save_and_download__post","parameters":[{"name":"access_token","in":"cookie","required":false,"schema":{"type":"string","title":"Access Token"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","title":"Request"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/write_jp/write_draft/":{"post":{"tags":["Write_jp"],"summary":"Write Draft","operationId":"write_draft_write_jp_write_draft__post","requestBody":{"content":{"application/json":{"schema":{"type":"object","title":"Request"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/hc/backend/":{"get":{"tags":["hc"],"summary":"Backend","operationId":"backend_hc_backend__get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/hc/kr_es_db":{"get":{"tags":["hc"],"summary":"Get Kr Es Db","operationId":"get_kr_es_db_hc_kr_es_db_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/hc/us_es_db":{"get":{"tags":["hc"],"summary":"Get Us Es Db","operationId":"get_us_es_db_hc_us_es_db_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/hc/kr_milvus_db":{"get":{"tags":["hc"],"summary":"Get Kr Milvus Db","operationId":"get_kr_milvus_db_hc_kr_milvus_db_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/hc/us_milvus_db":{"get":{"tags":["hc"],"summary":"Get Us Milvus Db","operationId":"get_us_milvus_db_hc_us_milvus_db_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/hc/us_gemini_milvus_db":{"get":{"tags":["hc"],"summary":"Get Us Gemini Milvus Db","description":"PS-1740: 온프레미스 US Gemini Milvus 연결 상태. 기동 시 Loaded로 확인된 US 컬렉션을 보여준다.\n\n기존 /hc/*와 같은 200+fail 메시지 설계. 재접속을 시도하지 않고 기동 시점 스냅샷을 반환하므로\nUS Milvus가 기동 후 복구됐다면 서비스 재시작이 필요하다 (KR Gemini 경로와 동일한 제약).","operationId":"get_us_gemini_milvus_db_hc_us_gemini_milvus_db_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/hc/embedding":{"get":{"tags":["hc"],"summary":"Get Embedding Engine","description":"gw 실경로가 쓰는 임베딩 엔진(generator) 가용 상태. 미초기화면 검색이 503을 반환한다.\n\n기존 /hc/*는 200+fail 메시지 설계지만, 이 엔드포인트는 신규라 표준(503)을 따른다.","operationId":"get_embedding_engine_hc_embedding_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/hc/do_fail":{"get":{"tags":["hc"],"summary":"Do Fail","operationId":"do_fail_hc_do_fail_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/convert/upload/":{"post":{"tags":["Convert"],"summary":"Convert File","operationId":"convert_file_convert_upload__post","parameters":[{"name":"access_token","in":"cookie","required":false,"schema":{"type":"string","title":"Access Token"}}],"requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_convert_file_convert_upload__post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/make_report/write_report/":{"post":{"tags":["Make Report"],"summary":"Write Report","operationId":"write_report_make_report_write_report__post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WriteReportRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/clouddraft/generate":{"post":{"summary":"Generate","operationId":"generate_clouddraft_generate_post","requestBody":{"content":{"application/json":{"schema":{"type":"object","title":"Survey"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/patent/es-v2/health/":{"get":{"tags":["특허 정보 조회 API (ES v2 병행 테스트)"],"summary":"ES v2 연결 상태 확인 (KR·US·JP)","operationId":"es_v2_health_v1_patent_es_v2_health__get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/patent/es-v2/numbers/":{"post":{"tags":["특허 정보 조회 API (ES v2 병행 테스트)"],"summary":"[ES v2] 특허 출원번호로 특허 정보 조회 — 기존 /v1/patent/numbers/ 와 응답 계약 동일","operationId":"get_patents_by_numbers_v2_v1_patent_es_v2_numbers__post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NumbersRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/patent/es-v2/expression/":{"post":{"tags":["특허 정보 조회 API (ES v2 병행 테스트)"],"summary":"[ES v2] DSL 검색식 조회 — 기존 /v1/patent/expression/ 과 응답 계약 동일","operationId":"expression_search_v2_v1_patent_es_v2_expression__post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExpressionRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/log":{"post":{"summary":"Log","operationId":"log_log_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LogData"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/signup":{"get":{"summary":"Register Page","operationId":"register_page_signup_get","responses":{"200":{"description":"Successful Response","content":{"text/html":{"schema":{"type":"string"}}}}}}},"/signin":{"get":{"summary":"Login Page","operationId":"login_page_signin_get","responses":{"200":{"description":"Successful Response","content":{"text/html":{"schema":{"type":"string"}}}}}}},"/users":{"get":{"summary":"Users Page","operationId":"users_page_users_get","parameters":[{"name":"access_token","in":"cookie","required":false,"schema":{"type":"string","title":"Access Token"}}],"responses":{"200":{"description":"Successful Response","content":{"text/html":{"schema":{"type":"string"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/files":{"get":{"summary":"Read Files","operationId":"read_files_files_get","parameters":[{"name":"access_token","in":"cookie","required":false,"schema":{"type":"string","title":"Access Token"}}],"responses":{"200":{"description":"Successful Response","content":{"text/html":{"schema":{"type":"string"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}},"components":{"schemas":{"Body_convert_file_convert_upload__post":{"properties":{"file":{"type":"string","format":"binary","title":"File"}},"type":"object","required":["file"],"title":"Body_convert_file_convert_upload__post"},"Body_sign_user_in_user_signin_post":{"properties":{"grant_type":{"anyOf":[{"type":"string","pattern":"password"},{"type":"null"}],"title":"Grant Type"},"username":{"type":"string","title":"Username"},"password":{"type":"string","title":"Password"},"scope":{"type":"string","title":"Scope","default":""},"client_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Client Id"},"client_secret":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Client Secret"}},"type":"object","required":["username","password"],"title":"Body_sign_user_in_user_signin_post"},"Body_write_specification_all_exclude_write_en_write_specification_all_exclude_post":{"properties":{"text":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Text"},"application_number":{"items":{"type":"string"},"type":"array","title":"Application Number","default":[]},"drawings":{"items":{"type":"string"},"type":"array","title":"Drawings","default":[]},"drawings_simpledescription":{"items":{"type":"string"},"type":"array","title":"Drawings Simpledescription","default":[]},"user":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"User"},"invention":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Invention"}},"type":"object","title":"Body_write_specification_all_exclude_write_en_write_specification_all_exclude_post"},"Body_write_specification_all_exclude_write_jp_write_specification_all_exclude_post":{"properties":{"text":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Text"},"application_number":{"items":{"type":"string"},"type":"array","title":"Application Number","default":[]},"drawings":{"items":{"type":"string"},"type":"array","title":"Drawings","default":[]},"user":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"User"},"invention":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Invention"}},"type":"object","title":"Body_write_specification_all_exclude_write_jp_write_specification_all_exclude_post"},"Body_write_specification_all_exclude_write_write_specification_all_exclude_post":{"properties":{"text":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Text"},"application_number":{"items":{"type":"string"},"type":"array","title":"Application Number","default":[]},"drawings":{"items":{"type":"string"},"type":"array","title":"Drawings","default":[]},"drawings_simpledescription":{"items":{"type":"string"},"type":"array","title":"Drawings Simpledescription","default":[]},"user":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"User"},"invention":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Invention"}},"type":"object","title":"Body_write_specification_all_exclude_write_write_specification_all_exclude_post"},"Body_write_specification_all_write_cn_write_specification_all_post":{"properties":{"text":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Text"}},"type":"object","title":"Body_write_specification_all_write_cn_write_specification_all_post"},"Body_write_specification_all_write_en_write_specification_all_post":{"properties":{"text":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Text"}},"type":"object","title":"Body_write_specification_all_write_en_write_specification_all_post"},"Body_write_specification_prior_patent_write_write_specification_prior_patent_post":{"properties":{"application_number":{"items":{"type":"string"},"type":"array","title":"Application Number","default":[]}},"type":"object","title":"Body_write_specification_prior_patent_write_write_specification_prior_patent_post"},"Body_write_specification_write_cn_write_specification__id__post":{"properties":{"text":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Text"}},"type":"object","title":"Body_write_specification_write_cn_write_specification__id__post"},"Body_write_specification_write_en_write_specification__id__post":{"properties":{"text":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Text"}},"type":"object","title":"Body_write_specification_write_en_write_specification__id__post"},"Body_write_specification_write_jp_write_specification_Embodiment__post":{"properties":{"text":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Text"},"drawings":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Drawings"}},"type":"object","title":"Body_write_specification_write_jp_write_specification_Embodiment__post"},"Body_write_specification_write_jp_write_specification__id__post":{"properties":{"text":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Text"}},"type":"object","title":"Body_write_specification_write_jp_write_specification__id__post"},"Body_write_specification_write_write_specification_Embodiment__post":{"properties":{"text":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Text"},"drawings":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Drawings"}},"type":"object","title":"Body_write_specification_write_write_specification_Embodiment__post"},"Body_write_specification_write_write_specification__id__post":{"properties":{"text":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Text"}},"type":"object","title":"Body_write_specification_write_write_specification__id__post"},"CompareClaimsRequest":{"properties":{"invention":{"type":"string","title":"Invention","description":"기준이 되는 발명 설명"},"avoidPatent":{"type":"string","title":"Avoidpatent","description":"비교할 특허들 (특별한 형식으로 구분)"},"lang":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Lang","description":"언어 설정 (kr: 한국어, en: 영어, jp: 일본어)","default":"kr"}},"type":"object","required":["invention","avoidPatent"],"title":"CompareClaimsRequest"},"DifferentiationComparedPatent":{"properties":{"inventionTitle":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Inventiontitle","description":"비교 특허명"},"applicationNumber":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Applicationnumber","description":"출원번호"},"claims":{"items":{"type":"string"},"type":"array","title":"Claims","description":"비교 청구항"},"compare":{"items":{"$ref":"#/components/schemas/DifferentiationComparisonItem"},"type":"array","title":"Compare","description":"청구항 비교 결과"}},"type":"object","title":"DifferentiationComparedPatent"},"DifferentiationComparisonItem":{"properties":{"id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Id","description":"청구항 번호"},"설명":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"설명","description":"유사 구성 설명"},"유사도":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"유사도","description":"유사도"},"차이점":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"차이점","description":"차이점"}},"type":"object","title":"DifferentiationComparisonItem"},"DifferentiationPatent":{"properties":{"inventionTitle":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Inventiontitle","description":"발명의 명칭"},"inventionTitleKorean":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Inventiontitlekorean","description":"발명의 명칭(한국어)"},"applicationNumber":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Applicationnumber","description":"출원번호"},"applicationDate":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Applicationdate","description":"출원일"},"abstract":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Abstract","description":"요약"},"claims":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"string"},{"type":"null"}],"title":"Claims","description":"청구항"}},"type":"object","title":"DifferentiationPatent"},"DifferentiationPointRequest":{"properties":{"invention":{"type":"string","title":"Invention","description":"분석 대상 발명 설명"},"patents":{"items":{"$ref":"#/components/schemas/DifferentiationPatent"},"type":"array","title":"Patents","description":"유사 특허 목록"},"compared_claims":{"items":{"$ref":"#/components/schemas/DifferentiationComparedPatent"},"type":"array","title":"Compared Claims","description":"청구항 비교 분석 결과"},"keywords":{"items":{"type":"string"},"type":"array","title":"Keywords","description":"핵심 키워드"},"lang":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Lang","description":"언어 설정","default":"kr"}},"type":"object","required":["invention"],"title":"DifferentiationPointRequest"},"DifferentiationPointResponse":{"properties":{"differentiation_point":{"type":"string","title":"Differentiation Point","description":"발명 아이디어의 차별화 포인트 본문"},"points":{"items":{"type":"string"},"type":"array","title":"Points","description":"차별화 포인트 요약"},"source":{"type":"string","title":"Source","description":"생성 출처","default":"ai"}},"type":"object","required":["differentiation_point"],"title":"DifferentiationPointResponse"},"ExpressionData":{"properties":{"applicationNumber":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Applicationnumber","description":"출원번호 (국가코드 포함)"},"similarity":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Similarity","description":"유사도 점수 (0-100)"},"year":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Year","description":"출원연도"},"applicationDate":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Applicationdate","description":"출원일"},"applicants":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"string"},{"type":"null"}],"title":"Applicants","description":"출원인"},"inventors":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"string"},{"type":"null"}],"title":"Inventors","description":"발명자"},"cpc":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cpc","description":"CPC 분류코드"}},"type":"object","required":["applicationNumber","similarity","year","applicationDate","applicants","inventors","cpc"],"title":"ExpressionData"},"ExpressionRequest":{"properties":{"query":{"type":"string","title":"Query","description":"검색어"}},"type":"object","required":["query"],"title":"ExpressionRequest"},"ExpressionResponse":{"properties":{"data":{"items":{"$ref":"#/components/schemas/ExpressionData"},"type":"array","title":"Data","description":"검색 결과"},"numbers":{"items":{"type":"string"},"type":"array","title":"Numbers","description":"출원번호 목록"},"stats":{"items":{"type":"object"},"type":"array","title":"Stats","description":"통계 결과"},"sims":{"items":{"anyOf":[{"type":"integer"},{"type":"null"}]},"type":"array","title":"Sims","description":"유사도 점수"}},"type":"object","required":["data","numbers","stats","sims"],"title":"ExpressionResponse"},"FilterRequest":{"properties":{"text":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Text","description":"필터링할 텍스트"},"keywords":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Keywords","description":"키워드 목록"},"keywordsCondition":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Keywordscondition","description":"키워드 조건"},"tl":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Tl","description":"발명의 명칭"},"tlCondition":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Tlcondition","description":"발명의 명칭 조건"},"ab":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Ab","description":"요약"},"abCondition":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Abcondition","description":"요약 조건"},"cl":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Cl","description":"청구항"},"clCondition":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Clcondition","description":"청구항 조건"},"ds":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Ds","description":"상세설명"},"dsCondition":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Dscondition","description":"상세설명 조건"},"cpc":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Cpc","description":"CPC 분류코드"},"cpcCondition":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cpccondition","description":"CPC 조건"},"an":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"An","description":"출원인"},"anCondition":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ancondition","description":"출원인 조건"},"gn":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Gn","description":"발명자"},"gnCondition":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Gncondition","description":"발명자 조건"},"cpn":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Cpn","description":"대리인"},"cpnCondition":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cpncondition","description":"대리인 조건"},"pn":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Pn","description":"공개번호"},"pnCondition":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Pncondition","description":"공개번호 조건"},"pdRanges":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Pdranges","description":"공개일 범위"},"adRanges":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Adranges","description":"출원일 범위"},"gdRanges":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Gdranges","description":"등록일 범위"},"opdRanges":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Opdranges","description":"공개일 범위"},"ap":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Ap","description":"출원인"},"apCondition":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Apcondition","description":"출원인 조건"},"in_":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"In ","description":"발명자"},"inCondition":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Incondition","description":"발명자 조건"},"ag":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Ag","description":"대리인"},"agCondition":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Agcondition","description":"대리인 조건"},"applicationNumbers":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Applicationnumbers","description":"출원번호 목록"},"pd":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Pd","description":"공개일"},"ad":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Ad","description":"출원일"},"gd":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Gd","description":"등록일"},"opn":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Opn","description":"공개번호"}},"type":"object","required":["text"],"title":"FilterRequest"},"GeminiMultimodalRequest":{"properties":{"text":{"anyOf":[{"type":"string","maxLength":10000},{"type":"null"}],"title":"Text","description":"자연어 검색 텍스트 (선택, 없으면 이미지 단독 검색)"},"images_base64":{"items":{"type":"string"},"type":"array","title":"Images Base64","description":"base64 인코딩 이미지 목록 (1~5장, 필수)"},"media_types":{"items":{"type":"string"},"type":"array","title":"Media Types","description":"각 이미지 MIME 목록 (images_base64와 동일 길이, 미제공 시 전부 image/jpeg)"},"fuse":{"type":"boolean","title":"Fuse","description":"검색 방식 — True(기본): 도면 융합 1회 검색(한번에) / False: 도면별 검색 후 RRF 병합(각각+합치기)","default":true},"top_k":{"anyOf":[{"type":"integer","maximum":1000.0,"minimum":1.0},{"type":"null"}],"title":"Top K","description":"반환 후보 특허 수 상한","default":200}},"type":"object","title":"GeminiMultimodalRequest"},"GeminiSentenceRequest":{"properties":{"text":{"type":"string","maxLength":10000,"minLength":3,"title":"Text","description":"자연어 검색 텍스트 (원문 또는 refined_query)"},"top_k":{"anyOf":[{"type":"integer","maximum":1000.0,"minimum":1.0},{"type":"null"}],"title":"Top K","description":"반환 후보 특허 수 상한 (Gemini 자연어 검색은 최대 400건)","default":400},"rerank_query":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Rerank Query","description":"Laya 재정렬에 사용할 자연어 원문 질의"},"country":{"type":"string","enum":["KR","US"],"title":"Country","description":"(하위호환) 검색 대상 국가 단일값. countries가 있으면 무시","default":"KR"},"countries":{"anyOf":[{"items":{"type":"string","enum":["KR","US"]},"type":"array","minItems":1},{"type":"null"}],"title":"Countries","description":"검색 대상 국가 목록 (예: [\"KR\",\"US\"]). 국가별 Milvus를 병렬 검색해 서버에서 점수 병합. 일부 국가 미연결이면 200 + unavailable_countries, 전부 미연결이면 503 milvus_unavailable"}},"type":"object","required":["text"],"title":"GeminiSentenceRequest"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"HistorySearch":{"properties":{"_id":{"anyOf":[{"type":"string","example":"5eb7cf5a86d9755df3a6c593"},{"type":"null"}],"title":" Id","description":"MongoDB document ObjectID"},"username":{"type":"string","title":"Username"},"timestamp":{"type":"string","format":"date-time","title":"Timestamp","default":"2026-11-20T16:32:03.119545"},"query":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Query"},"refinedQuery":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Refinedquery"},"results":{"anyOf":[{"items":{},"type":"array"},{"type":"null"}],"title":"Results","default":[]}},"type":"object","required":["username"],"title":"HistorySearch"},"LogData":{"properties":{"level":{"type":"string","title":"Level"},"message":{"type":"string","title":"Message"},"data":{"type":"object","title":"Data"}},"type":"object","required":["level","message"],"title":"LogData"},"NumbersRequest":{"properties":{"data":{"items":{"type":"string"},"type":"array","title":"Data","description":"출원번호 목록 (국가코드 + 출원번호 형식)","example":["KR1020170134345","US20170134345A1"]},"source_list":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Source List","description":"검색할 필드 목록 (선택사항). 가능한 필드: 'primary_key', 'ApplicationNumber', 'MainCPC', 'IPC_MAIN', 'OpenNumber', 'OpenDate', 'RegisterNumber', 'RegisterDate', 'ApplicationDate', 'ApplicantName', 'InventorName', 'AgentNames', 'Title', 'Summary', 'Background', 'Problem', 'Embodiment', 'Effects', 'BriefDescriptionOfDrawings', 'Claims', 'image', 'Country'"},"preview_chars":{"anyOf":[{"type":"integer","maximum":300.0,"minimum":1.0},{"type":"null"}],"title":"Preview Chars","description":"목록 전용 본문 7종 프리뷰 길이(1~300자). 생략하면 전문 계약 유지. 지정 시 source_list 필수이며 구조화 전문 배열은 제외합니다."}},"type":"object","required":["data"],"title":"NumbersRequest"},"PossibleIDsResponse":{"properties":{"possible_ids":{"items":{"type":"string"},"type":"array","title":"Possible Ids"}},"type":"object","required":["possible_ids"],"title":"PossibleIDsResponse"},"SentenceDataRequest":{"properties":{"candidate_limit":{"anyOf":[{"type":"integer","maximum":5000.0,"minimum":1.0},{"type":"null"}],"title":"Candidate Limit","description":"레그별 후보 및 최종 결과 상한. 비회원 경량 검색은 3을 쓰고, 회원 검색 후보 풀 상한(PS-1598)은 2000을 쓴다. 응답 건수도 이 값으로 잘리므로 회원 경로는 800 이상을 전달할 것"},"vector":{"items":{"type":"number"},"type":"array","title":"Vector","description":"임베딩 벡터"},"boolean_query":{"type":"string","title":"Boolean Query","description":"불린 검색식"},"important_keywords":{"items":{"type":"string"},"type":"array","title":"Important Keywords","description":"중요 키워드 목록"},"rerank_query":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Rerank Query","description":"Laya 재정렬에 사용할 자연어 원문 질의"},"is_expression":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Is Expression","description":"불린 검색식이 표현식인지 여부","default":false},"with_snippets":{"type":"boolean","title":"With Snippets","description":"결과별 초록 스니펫·하이라이트 오프셋 생성 여부","default":false},"fragment_size":{"type":"integer","maximum":500.0,"minimum":30.0,"title":"Fragment Size","description":"스니펫 fragment 길이(자)","default":150},"number_of_fragments":{"type":"integer","maximum":5.0,"minimum":1.0,"title":"Number Of Fragments","description":"문서당 fragment 수","default":2},"snippet_limit":{"type":"integer","maximum":300.0,"minimum":1.0,"title":"Snippet Limit","description":"스니펫 생성 대상 상위 결과 수","default":100}},"type":"object","required":["vector","boolean_query","important_keywords"],"title":"SentenceDataRequest"},"SentenceResponse":{"properties":{"applicationNumber":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Applicationnumber","description":"특허 출원번호","example":"KR1020170134345"},"similarity":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Similarity","description":"유사도 점수 (0-100)","example":85},"results":{"anyOf":[{"items":{"$ref":"#/components/schemas/SentenceResult"},"type":"array"},{"type":"null"}],"title":"Results","description":"검색 결과 목록"},"numbers":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Numbers","description":"출원번호 목록"},"similarities":{"anyOf":[{"items":{"type":"number"},"type":"array"},{"type":"null"}],"title":"Similarities","description":"유사도 점수 목록"},"stats":{"anyOf":[{"items":{"type":"object"},"type":"array"},{"type":"null"}],"title":"Stats","description":"통계 목록"},"keywords":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Keywords","description":"키워드 목록"},"engine_partial":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Engine Partial","description":"Milvus 일부 실패로 부분 결과일 때 true"},"skipped_collections":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Skipped Collections","description":"실패·건너뛴 Milvus 컬렉션 목록 (COUNTRY:collection 또는 COUNTRY:(no_available_clients))"}},"type":"object","title":"SentenceResponse"},"SentenceResult":{"properties":{"applicationNumber":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Applicationnumber","description":"특허 출원번호","example":"KR1020170134345"},"cpc":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cpc","description":"CPC 분류코드","example":"G06F17/30"},"publicNumber":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Publicnumber","description":"공개번호","example":"1020190048123"},"publicDate":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Publicdate","description":"공개일자","example":"20190425"},"applicationDate":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Applicationdate","description":"출원일자","example":"20171025"},"registNumber":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Registnumber","description":"등록번호","example":"1019876543"},"registDate":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Registdate","description":"등록일자","example":"20191225"},"applicants":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"string"},{"type":"null"}],"title":"Applicants","description":"출원인명","example":["삼성전자주식회사","엘지전자주식회사"]},"inventors":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"string"},{"type":"null"}],"title":"Inventors","description":"발명자명","example":["김철수","이영희"]},"agents":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"string"},{"type":"null"}],"title":"Agents","description":"대리인명","example":["특허법인 세종"]},"inventionTitleKorean":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Inventiontitlekorean","description":"발명의 명칭","example":"인공지능 기반 데이터 처리 방법 및 시스템"},"abstract":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Abstract","description":"요약","example":"본 발명은 인공지능을 이용하여 대용량 데이터를 효율적으로 처리하는 방법에 관한 것이다..."},"background":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Background","description":"배경기술","example":"종래 기술에서는 데이터 처리 속도가 느린 문제가 있었다..."},"problem":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Problem","description":"해결하려는 과제","example":"본 발명은 데이터 처리 속도를 향상시키는 것을 목적으로 한다..."},"embodiment":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Embodiment","description":"실시예","example":"도 1을 참조하면, 본 발명의 실시예에 따른 시스템이 도시되어 있다..."},"effects":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Effects","description":"발명의 효과","example":"본 발명에 의하면 데이터 처리 속도가 50% 향상된다..."},"briefDescriptionOfDrawings":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Briefdescriptionofdrawings","description":"도면의 간단한 설명","example":"도 1은 본 발명의 실시예에 따른 시스템 구성도이다..."},"claims":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Claims","description":"청구항","example":"1. 데이터를 입력받는 단계; 2. 인공지능 모델로 처리하는 단계; ..."},"image":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Image","description":"이미지 URL","example":"http://example.com/patent_image.png"},"similarity":{"anyOf":[{"type":"integer"},{"type":"number"},{"type":"null"}],"title":"Similarity","description":"유사도 점수 (0-100)"},"snippet":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Snippet","description":"초록의 질의 매칭 구간 스니펫 (매칭 없으면 null — 다운스트림 선두 절단 폴백)","example":"…전고체 배터리의 고체전해질 계면 저항을 낮추는 보호층…"},"snippet_offsets":{"anyOf":[{"items":{"$ref":"#/components/schemas/SnippetOffset"},"type":"array"},{"type":"null"}],"title":"Snippet Offsets","description":"스니펫 문자열 내 하이라이트 오프셋 배열 (기준: 스니펫 내부)"},"registed":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Registed","description":"등록 여부","example":true},"Country":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Country","description":"국가 코드","example":"KR"},"year":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Year","description":"출원연도","example":"2020"}},"type":"object","title":"SentenceResult"},"SimilarDocumentRequest":{"properties":{"application_number":{"type":"string","pattern":"^[A-Za-z0-9특실]{4,32}$","title":"Application Number","description":"시드 출원번호 (국가 prefix 포함, 예: KR1020200050941 — 숫자로 시작하면 KR로 간주)"},"top_k":{"type":"integer","maximum":800.0,"minimum":1.0,"title":"Top K","description":"반환 후보 상한","default":800}},"type":"object","required":["application_number"],"title":"SimilarDocumentRequest","description":"PS-1454: 시드 출원번호 기반 유사 문헌 검색 요청"},"SnippetOffset":{"properties":{"start":{"type":"integer","title":"Start","description":"하이라이트 시작 인덱스 (스니펫 내)"},"end":{"type":"integer","title":"End","description":"하이라이트 끝 인덱스 (exclusive, 스니펫 내)"}},"type":"object","required":["start","end"],"title":"SnippetOffset","description":"PS-1453: 스니펫 문자열 내 하이라이트 구간 (기준 = 스니펫 내부 문자 인덱스)"},"TokenResponse":{"properties":{"access_token":{"type":"string","title":"Access Token"},"token_type":{"type":"string","title":"Token Type"}},"type":"object","required":["access_token","token_type"],"title":"TokenResponse"},"UploadRequest":{"properties":{"text":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Text","description":"검색할 텍스트"},"file":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"File","description":"업로드된 파일"},"keywords":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Keywords","description":"키워드 목록"},"keywordsCondition":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Keywordscondition","description":"키워드 조건"},"tl":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Tl","description":"발명의 명칭"},"tlCondition":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Tlcondition","description":"발명의 명칭 조건"},"ab":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Ab","description":"요약"},"abCondition":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Abcondition","description":"요약 조건"},"cl":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Cl","description":"청구항"},"clCondition":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Clcondition","description":"청구항 조건"},"ds":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Ds","description":"상세설명"},"dsCondition":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Dscondition","description":"상세설명 조건"},"cpc":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Cpc","description":"CPC 분류코드"},"cpcCondition":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cpccondition","description":"CPC 조건"},"an":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"An","description":"출원인"},"anCondition":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ancondition","description":"출원인 조건"},"gn":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Gn","description":"발명자"},"gnCondition":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Gncondition","description":"발명자 조건"},"cpn":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Cpn","description":"대리인"},"cpnCondition":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cpncondition","description":"대리인 조건"},"pn":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Pn","description":"공개번호"},"pnCondition":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Pncondition","description":"공개번호 조건"},"pdRanges":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Pdranges","description":"공개일 범위"},"adRanges":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Adranges","description":"출원일 범위"},"gdRanges":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Gdranges","description":"등록일 범위"},"opdRanges":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Opdranges","description":"공개일 범위"},"ap":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Ap","description":"출원인"},"apCondition":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Apcondition","description":"출원인 조건"},"in_":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"In ","description":"발명자"},"inCondition":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Incondition","description":"발명자 조건"},"ag":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Ag","description":"대리인"},"agCondition":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Agcondition","description":"대리인 조건"},"applicationNumbers":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Applicationnumbers","description":"출원번호 목록"},"pd":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Pd","description":"공개일"},"ad":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Ad","description":"출원일"},"gd":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Gd","description":"등록일"},"opn":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Opn","description":"공개번호"}},"type":"object","required":["text"],"title":"UploadRequest"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"},"WriteReportRequest":{"properties":{"sentence":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Sentence"},"avoidPatentNumbers":{"items":{"type":"string"},"type":"array","title":"Avoidpatentnumbers","default":[]},"avoidPatentCountry":{"items":{"type":"string"},"type":"array","title":"Avoidpatentcountry","default":[]}},"type":"object","required":["sentence"],"title":"WriteReportRequest"},"routes__write__WriteClaimsRequest":{"properties":{"sentence":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Sentence"},"avoidPatent":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Avoidpatent"},"avoidPatentNumbers":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Avoidpatentnumbers"},"claim_number":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Claim Number","default":12}},"type":"object","required":["sentence"],"title":"WriteClaimsRequest"},"routes__write_cn__WriteClaimsRequest":{"properties":{"sentence":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Sentence"},"avoidPatent":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Avoidpatent"},"avoidPatentNumbers":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Avoidpatentnumbers"}},"type":"object","required":["sentence"],"title":"WriteClaimsRequest"},"routes__write_en__WriteClaimsRequest":{"properties":{"sentence":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Sentence"},"avoidPatent":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Avoidpatent"},"avoidPatentNumbers":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Avoidpatentnumbers"}},"type":"object","required":["sentence"],"title":"WriteClaimsRequest"},"routes__write_jp__WriteClaimsRequest":{"properties":{"sentence":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Sentence"},"avoidPatent":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Avoidpatent"},"avoidPatentNumbers":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Avoidpatentnumbers"},"claim_number":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Claim Number","default":12}},"type":"object","required":["sentence"],"title":"WriteClaimsRequest"}},"securitySchemes":{"APIKeyHeader":{"type":"apiKey","in":"header","name":"X-API-KEY"}}}}