{"openapi":"3.0.3","info":{"title":"APICK 한글 발음 변환 AI","version":"1.0.0","description":"숫자·단위·기호·영문이 섞인 한국어 문장을 음성 합성기가 정확히 읽을 수 있는 한글 문장으로 바꿉니다. 5마리는 다섯 마리, 400km는 사백 킬로미터처럼 문맥에 맞는 읽기로 풀어 쓰며, 필요하면 소리 나는 대로 적은 문장도 받을 수 있습니다."},"servers":[{"url":"https://apick.app"}],"paths":{"/rest/llm/text_pronunciation":{"post":{"summary":"한글 발음 변환 AI","description":"숫자·단위·기호·영문이 섞인 한국어 문장을 음성 합성기가 정확히 읽을 수 있는 한글 문장으로 바꿉니다. 5마리는 다섯 마리, 400km는 사백 킬로미터처럼 문맥에 맞는 읽기로 풀어 쓰며, 필요하면 소리 나는 대로 적은 문장도 받을 수 있습니다.","security":[{"bearerAuth":[]}],"parameters":[],"responses":{"200":{"description":"서비스별 성공·처리 상태 응답","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"text":{"type":"string","description":"변환된 문장"},"mode":{"type":"string","description":"적용된 변환 모드 (normalize 또는 phonetic)"},"input_length":{"type":"integer","description":"과금 기준 입력 글자 수 (앞뒤 공백 제외)"},"output_length":{"type":"integer","description":"변환 결과 글자 수"},"ic_id":{"nullable":true},"result":{"type":"integer"},"msg":{"type":"string"},"success":{"type":"integer"},"ic_id / result / msg / success":{"type":"string","description":"공통 래퍼 필드 (ic_id=null, result=success=1, msg=\"\")","nullable":true}}},"api":{"type":"object","properties":{"success":{"type":"boolean","description":"API 처리 성공 여부"},"cost":{"type":"integer","description":"실제 차감된 포인트 (실패 시 0)"},"ms":{"type":"integer","description":"서버 처리 소요시간(ms)"},"pl_id":{"type":"integer","description":"PaymentLog ID","nullable":true}}}}}}}},"default":{"description":"HTTP 상태 및 서비스 오류코드 확인","content":{"application/json":{"schema":{"type":"object"}}}}},"requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"type":"object","properties":{"text":{"type":"string","description":"변환할 원문 텍스트 (최대 2,000자) (string)","example":"서울에서 부산까지는 5시간이 넘게 걸리고 거리는 400km쯤 된다. 5번 버스를 타고 가서 버튼을 5번 누르세요."},"mode":{"type":"string","description":"normalize(기본) 또는 phonetic (string)"}},"required":["text"]}}}}}}},"x-code-tables":[{"title":"에러 코드","columns":["HTTP","의미"],"rows":[["400","text 누락, 2,000자 초과, 지원하지 않는 mode"],["402","잔액 부족 (선불 회원, 해당 요청의 과금액 이상 필요)"],["500","서버 설정 오류"],["502","변환 처리 중 일시적 오류 (과금되지 않으며 다시 요청할 수 있습니다)"]]}],"x-service-errors":[],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer"}}}}