텍스트 시점 추출 및 변환 모델

개요

이 API는 텍스트에서 시간을 나타내는 표현을 찾아 추출하고 "YYYY.MM.DD hh:mm' 형태로 변환하는 서비스입니다.
아래는 파이썬을 이용한 API 사용 예시입니다.

Quickstart

파이썬 예시입니다.

#&nbsp;질문&nbsp;시점&nbsp;추출
json_&nbsp;=&nbsp;{&quot;prompt&quot;:&quot;어제&nbsp;퇴근시간대에&nbsp;대구&nbsp;날씨&nbsp;어땠어?&quot;}
url&nbsp;=&nbsp;&quot;http://llm.theimc.co.kr/extract_time&quot;
res&nbsp;=&nbsp;requests.post(url=url,json=json_)
print(res.json()[&quot;body&quot;][&quot;extract_result&quot;])

&gt;&gt;&gt;&nbsp;&quot;어제&nbsp;퇴근시간대&quot;

#&nbsp;시점&nbsp;-&gt;&nbsp;datetime&nbsp;변환
json_&nbsp;=&nbsp;{&quot;prompt&quot;:f&quot;[기준&nbsp;시점]\n{time.strftime(&quot;%Y.%m.%d&nbsp;%H:%M:%S&quot;)}\n\n[변환&nbsp;기준]\n'어제&nbsp;퇴근시간대'&quot;}
url&nbsp;=&nbsp;&quot;http://llm.theimc.co.kr/convert_time&quot;
res&nbsp;=&nbsp;requests.post(url=url,json=json_)
print(res.json()[&quot;body&quot;][&quot;extract_result&quot;])

&gt;&gt;&gt;&nbsp;&quot;2025.12.11&nbsp;18:00&quot;

API 안내 내용

날짜, 시간대, 시점이 포함된 텍스트를 3가지 유형으로 분류하였고, API 요청 시 LLM이 다음과 같은 답변을 생성합니다.
- 구체적인 시간대
  - 2025년 12월 25일에 대구신세계 이벤트 알려줘 >>> "2025.12.25 00:00"
- 구체적 + 비구체적 시간대
  - 10일 밤 8시에 안개가 심했니? >>> "2025.12.10 20:00"
- 비구체적 시간대
  - 이틀 후 아침 기온은 어때? >>> "2025.12.14 08:00"

활용 분야

자연어 시간 표현 표준화를 통해 LLM의 질의 해석 정확도를 향상합니다.
모호한 시간 표현을 정규화함으로써 데이터베이스의 조회 정확도를 향상합니다.
시계열 정보가 포함된 사용자 질문을 구조화된 파라미터로 변환하여 LLM-DB 연동 효율을 개선합니다.
다양한 시간 표현 패턴을 일관된 포맷으로 통일해 LLM의 추론 오류를 줄이고 안정적인 답변이 생성 가능합니다.

API Endpoint

#&nbsp;시점&nbsp;추출
POST&nbsp;&quot;http://llm.theimc.co.kr/extract_time&quot;

#&nbsp;시점&nbsp;변환
POST&nbsp;&quot;http://llm.theimc.co.kr/convert_time&quot;

요청(Request)

Content-Type

POST /extract_time
POST /convert_time
Content-Type: application/json; charset=utf-8

Form Fields

이 엔드포인트는 폼 데이터(application/x-www-form-urlencoded, multipart/form-data)를 지원하지 않고, 모든 입력을 JSON Body로만 받습니다.

File Fields

파일 업로드를 지원하지 않으며 File 필드는 존재하지 않습니다.

Requst Fields

Field	Type	Required	Description	Example
prompt	string	Yes	시점 표현이 포함된 자연어 텍스트 또는 변환용 텍스트	"10일 밤 8시에 안개가 심했니?"

응답(Response)

요청 성공 예시

/extract/time 요청 예시

사용자가 입력한 자연어 문장(시점 표현 포함)을 그대로 prompt에 담아 전송합니다.

POST&nbsp;/extract_time
Content-Type:&nbsp;application/json

{&quot;prompt&quot;:&nbsp;&quot;10일&nbsp;밤&nbsp;8시에&nbsp;안개가&nbsp;심했니?&quot;}

&gt;&gt;&gt;&nbsp;&quot;10일&nbsp;밤&nbsp;8시&quot;

/convert/time 요청 예시

기준 시점과 변환 대상 시점 표현을 하나의 문자열로 합쳐 prompt에 담아 전송합니다.

POST&nbsp;/convert_time
Content-Type:&nbsp;application/json

{&quot;prompt&quot;:&nbsp;&quot;[기준&nbsp;시점]\n2025.12.12&nbsp;09:30\n\n[변환&nbsp;기준]\n이틀&nbsp;후&nbsp;아침&quot;}

&gt;&gt;&gt;&nbsp;&quot;2025.12.14&nbsp;08:00&quot;

요청 실패 예시

모델	설명
시점 추출	추출에 실패 했습니다.
시점 변환	변환에 실패 했습니다.

API 호출에서 발생하는 오류는 API Error code 페이지를 확인해주세요.

Contact us