1API 요청
POST
/rest/llm/sessions/create요청 파라미터 6개
파라미터
설명
session_id세션 ID(llms_로 시작). get·reset·delete에서 필수입니다.
system대화 전체에 적용할 지시문(최대 100,000자). create에서 저장하고, reset에서 보내면 바꿉니다. 비워 두면 한국어로 답하도록 하는 기본 지시문을 씁니다.
- 예시
당신은 쇼핑몰 반품 상담원입니다. 존댓말로 짧게 답합니다.
titlecreate에서 붙이는 세션 이름(최대 100자). 생략하면 첫 질문 앞부분으로 정해집니다.
- 예시
반품 상담
modelcreate에서 기록해 둘 모델 ID. 실제 대화의 모델은 대화 요청의 model이 정합니다.
limitlist에서 받을 개수. 기본 20, 최대 100. 숫자로 보내며, 허용 범위를 벗어나면 요청이 거부됩니다.
offsetlist에서 건너뛸 개수. 기본 0. 최근에 쓴 세션부터 정렬됩니다. 숫자로 보내며, 허용 범위를 벗어나면 요청이 거부됩니다.
응답 필드 24개
응답 필드
설명
data요청 처리 결과 묶음입니다. 조회한 값·작업 상태·오류 설명이 이 안에 들어 있으며, 실제 하위 필드 구성은 서비스마다 다릅니다. 값이 없으면 null·빈 배열·필드 생략 중 해당 서비스의 규칙을 따릅니다.
data.session_id세션 ID(create·get·reset·delete) 문자열로 오며, 값이 없으면 빈 문자열이거나 필드가 생략됩니다. 같은 응답의 다른 필드와 함께 해석하세요.
data.title대상의 제목 또는 이름입니다. 서비스에 따라 상품명·영상 제목·페이지 제목을 뜻하며, 줄바꿈·이모지가 포함될 수 있습니다.
data.model응답을 생성한 모델 ID입니다. 요청에서 지정한 모델과 같으며, 모델 목록 API의 id 값과 비교해 확인합니다. null 허용.
data.message_count저장된 메시지 수(system 제외) 숫자로 오며, 단위·범위는 같은 응답의 다른 필드나 이 문서의 설명을 확인하세요.
data.created_at작업이 접수된 일시입니다. ISO 8601 형식이며, 결과 만료 시각을 계산할 때 기준으로 사용합니다.
data.updated_at마지막으로 대화한 시각 문자열로 오며, 값이 없으면 빈 문자열이거나 필드가 생략됩니다. 같은 응답의 다른 필드와 함께 해석하세요.
data.expires_at자동으로 지워지는 시각 문자열로 오며, 값이 없으면 빈 문자열이거나 필드가 생략됩니다. 같은 응답의 다른 필드와 함께 해석하세요.
data.system저장된 지시문(get·reset). 비어 있으면 기본 지시문을 씁니다. 문자열로 오며, 값이 없으면 빈 문자열이거나 필드가 생략됩니다. 같은 응답의 다른 필드와 함께 해석하세요.
data.messages저장된 대화(get·reset). role·content 순서대로 들어 있습니다.
data.ic_id이번 조회에 부여된 식별자입니다. 같은 요청의 결과를 추적하거나 문의할 때 사용하며, 값이 없으면 null입니다. null 허용.
data.result조회 결과 본문입니다. 서비스가 찾은 실제 데이터가 들어 있으며, 자료가 없거나 조회에 실패하면 null이거나 필드가 생략됩니다.
data.msg처리 결과를 사람이 읽을 수 있는 문장으로 설명합니다. 성공·실패 사유가 담기며, 오류 코드는 별도 필드에서 확인합니다.
data.success업무 처리 결과 코드입니다. 1은 정상 결과, 0은 실패 또는 무료 응답입니다. 서비스에 따라 2·3처럼 추가 코드를 쓰므로 같은 응답의 status·msg·error 필드도 함께 확인하세요.
data.sessionslist의 세션 목록. 항목마다 위의 session_id~expires_at가 있고 대화 내용은 없습니다.
data.totallist에서 보관 중인 전체 세션 수 숫자로 오며, 단위·범위는 같은 응답의 다른 필드나 이 문서의 설명을 확인하세요.
data.deleteddelete 성공 시 true true/false로 오며, 값이 없으면 필드가 생략되거나 null일 수 있습니다. true = 이 필드가 나타내는 조건이 성립한 경우, false = 성립하지 않은 경우입니다. 두 값 모두 정상 응답에 올 수 있으며, 값이 없으면 필드가 생략되거나 null일 수 있습니다.
apiAPI 호출 메타데이터입니다. 이번 요청의 서버 처리 성공 여부(api.success), 실제 차감 포인트(api.cost), 결제 기록 ID(api.pl_id)를 담습니다. 처리 시간(api.ms)은 응답에 포함된 경우에만 제공됩니다. 업무 결과는 data에서 확인합니다.
api.successAPI 서버가 이번 요청을 정상 처리했는지 여부입니다. true여도 업무 결과가 실패일 수 있으므로 data.success·data.status와 함께 판단합니다. 인증 실패·잘못된 입력·서버 오류 응답에서는 false입니다.
api.cost이번 호출에서 실제로 차감된 포인트입니다. 유료 성공 응답에서만 단가만큼 차감되며, 실패·무료 조회·같은 요청의 멱등 재전송은 0입니다. 화면의 표시 단가와 실제 차감액이 다를 수 있으므로 정산은 이 값을 기준으로 합니다.
api.ms서버가 요청을 받아 응답 본문을 만들기까지 걸린 처리 시간(밀리초)입니다. 네트워크 왕복 시간과 클라이언트 대기 시간은 포함되지 않습니다.
api.pl_id포인트 차감 기록 ID입니다. 차감이 발생한 호출에만 값이 있으며, 과금 내역을 문의할 때 이 번호를 사용합니다. 무과금 응답은 -1·null이거나 필드가 생략됩니다. null 허용.
하위 필드 2개 더 보기
응답 필드
설명
data.messages[].role'role' 문자열 값입니다. 값이 없으면 빈 문자열이거나 필드가 생략됩니다.
data.messages[].content'content' 문자열 값입니다. 값이 없으면 빈 문자열이거나 필드가 생략됩니다.
