용어집

문서와 화면에서 반복되는 용어의 정확한 의미를 빠르게 찾으세요.

플랫폼과 조직, AI 게이트웨이, API 호출과 에러에 쓰이는 용어를 영역별로 구분합니다.

계정, 스페이스 및 역할

플랫폼: Letsur가 제공하는 전체 기반입니다. 그 위에서 AI 게이트웨이 같은 서비스가 동작하며, 처음 진입하는 흐름은 플랫폼 시작하기에서 안내합니다.
서비스: 렛서 플랫폼에서 제공하는 기능 단위입니다. AI 게이트웨이가 대표 서비스입니다.
스페이스: 한 조직이나 팀이 함께 쓰는 작업 공간입니다. 스페이스 구성원과 역할 관리하기에서 참여자와 서비스 접근을 관리합니다.
Admin: 스페이스 운영과 구성원 관리를 맡는 관리자 역할입니다. 초대, 역할 변경 및 제거 범위는 스페이스 구성원 권한 보기, AI 게이트웨이 작업 범위는 AI 게이트웨이 역할별 접근 보기에서 확인합니다.
Member: 스페이스에 참여해 허용된 서비스를 사용하는 일반 구성원 역할입니다. AI 게이트웨이의 키와 유닛 작업 범위는 AI 게이트웨이 역할별 접근 보기에서 확인합니다.

AI 게이트웨이, 에셋 및 유닛

AI 게이트웨이: 여러 AI 공급사의 지원 모델을 하나의 AI 게이트웨이 API 키로 호출할 수 있는 서비스입니다. 현재 모델 코드와 지원 API 보기에서 스페이스에 배급된 범위를 확인합니다.
에셋: 게이트웨이가 공급하는 AI 자원을 통칭하는 상위 개념입니다. 모델은 에셋의 한 종류이며, 현재 사용할 수 있는 항목은 에셋에 표시됩니다.
모델 코드: 호출할 때 model 필드에 넣는 식별자입니다. openai/ 같은 공급사 prefix는 붙이지 않으며, 현재 코드는 에셋을 기준으로 합니다.
AI 게이트웨이 API 키: 게이트웨이를 호출할 때 인증에 쓰는 비밀 값입니다. API 키를 만들고 안전하게 보관하기에서 생성, 만료 및 삭제 절차를 확인합니다.
월 한도: API 키 한 개에 설정하는 월 사용 상한입니다. API 키 월 한도 정하기에서 역할별 설정 범위와 차단 동작을 확인합니다.
유닛 (unit): AI 게이트웨이의 사용량과 잔액을 나타내는 단위입니다. 유닛 잔액과 구매 방법 보기에서는 보유, 초과 및 차단 상태를, 카드, 미결제금과 거래 내역 관리하기에서는 VAT 포함 KRW 결제 정보를 다룹니다.

API, 요청 및 응답

관리 API 키 (Management Key): 플랫폼 API를 호출하는 mk_... 형식의 키입니다. 모델 호출용 AI 게이트웨이 API 키와 용도가 다릅니다.
base URL: API 요청을 보내는 기본 주소입니다. OpenAI 호환 경로는 https://gw.letsur.ai/v1, Anthropic 네이티브 경로는 https://gw.letsur.ai이며, 엔드포인트별 base URL과 경로 보기에서 구분합니다.
엔드포인트 (endpoint): base URL 뒤에 붙는 호출 경로입니다(예: OpenAI 호환 base URL 뒤의 /chat/completions). 호출 목적에 따라 달라지며 지원 엔드포인트에 전체 목록이 있습니다.
Image Generations: 프롬프트로 새 이미지를 만드는 OpenAI Images 호환 엔드포인트입니다. 현재 지원 모델과 요청 및 저장 형식은 Image Generations에서 확인합니다.
Image Edits: 입력 이미지와 프롬프트를 multipart 요청으로 보내 이미지를 바꾸는 OpenAI Images 호환 엔드포인트입니다. 파일 조건과 결과 저장 형식은 Image Edits에서 확인합니다.
스트리밍: 응답을 다 만들 때까지 기다리지 않고, 토큰을 생기는 대로 실시간(SSE)으로 받는 방식입니다. 요청에 "stream": true를 넣으며 세부 형식은 Chat Completions 스트리밍을 따릅니다.
estimated_cost: AI 게이트웨이 응답에서 호출별 비용을 제공하는 객체입니다. field 이름에는 estimated가 남아 있지만 계산 가능한 값은 billing record와 같은 resolved cost를 사용합니다. JSON 응답에서는 최상위, streaming에서는 누적 usage가 있는 event에서 확인하며 최종 납부 금액과의 차이는 요청별 비용에서 설명합니다.

API 오류

API 에러 응답: AI 게이트웨이 호출이 실패했을 때 반환되는 type, title, status, detail 및 error_ref 구조입니다. 응답 예시와 대응 기준은 에러 코드에 있습니다.
error_ref: 에러 응답마다 붙는 추적용 식별자입니다(예: err_a3f2c1d8e5b0). 문의할 때 이 값을 전달하면 문제를 추적할 수 있습니다. 에러 응답 구조와 대응 방법 보기에서 필드 위치를 확인합니다.