용어집
문서와 화면에서 반복되는 용어의 뜻과 적용 범위를 빠르게 찾으세요.
계정과 스페이스, 두 종류의 API 키, 유닛과 비용 및 작업 식별자를 구분합니다.
계정, 스페이스 및 역할
- 플랫폼
- 계정과 스페이스를 관리하고 서비스를 선택하는 공통 기반입니다. 초대받았다면 가입과 참여에서 시작합니다.
- 서비스
- 플랫폼의 계정과 스페이스를 이용하지만 각자의 자원과 결과를 제공하는 제품입니다. AI 게이트웨이와 도구 거버넌스 Preview의 제공 범위는 각각 다릅니다.
- 스페이스
- 구성원과 역할, 계약 및 결제 정보를 구분하는 범위입니다. 전환하면 다시 확인할 정보가 달라집니다.
- Admin
- 현재 스페이스의 관리자 역할입니다. 구성원 초대, 역할 변경과 제거 범위는 스페이스 구성원에서, AI 게이트웨이 API 키 권한은 서비스 권한에서 따로 확인합니다.
- Member
- 현재 스페이스에 참여한 일반 구성원 역할입니다. 서비스별 키와 유닛의 작업 범위까지 역할 이름만으로 단정하지 말고 AI 게이트웨이 구성원 권한을 확인하세요.
AI 게이트웨이, 에셋 및 유닛
- AI 게이트웨이
- 현재 스페이스에 제공된 지원 모델을 하나의 AI 게이트웨이 API 키로 호출하는 서비스입니다. 모델 코드와 지원 API를 함께 확인합니다.
- 에셋
- AI 게이트웨이에서 사용할 수 있도록 제공되는 자원입니다. 모델은 에셋의 한 종류이며 현재 상태는 에셋 화면에서 확인합니다.
- 모델 코드
- 요청의
model필드에 넣는 식별자입니다.openai/같은 공급사 prefix를 붙이지 않고 에셋에 표시된 코드를 사용합니다. - AI 게이트웨이 API 키
- 모델 호출 인증에 쓰는 비밀 값(
sk_...)입니다. 월별 사용량 조회용 관리 API 키와 다릅니다. 키 생성과 보관 - API 키 월 한도
- 키 한 개에 설정하는 월 사용 상한입니다. 한 사람이 만든 모든 개인 키의 구성원 한도와는 별개입니다. 한도 설정 범위
- 유닛 (unit)
- AI 게이트웨이 사용량과 잔액의 단위입니다. 이미 사용한 양과 현재 보유한 양은 다르며, VAT 포함 KRW 미결제 금액도 아닙니다. 잔액과 구매
API, 요청 및 결과
- 관리 API 키 (Management Key)
- 스페이스의 AI 게이트웨이 월별 사용량과 현재 잔액을 플랫폼 API로 조회할 때 쓰는
mk_...키입니다. 모델 호출에는 사용하지 않습니다. - base URL
- API 요청을 보내는 기본 주소입니다. AI 게이트웨이의 OpenAI 호환 경로는
https://gw.letsur.ai/v1, Anthropic 네이티브 경로는https://gw.letsur.ai입니다. 사용량과 잔액 조회용 플랫폼 API는 별도 주소인https://openapi.letsur.ai/v1을 사용합니다. 호출 대상에 맞는 AI 게이트웨이 인증과 URL 또는 플랫폼 API 인증을 확인하세요. - 엔드포인트 (endpoint)
- HTTP 메서드와 경로의 조합입니다(예:
POST /v1/chat/completions). SDK의 base URL에 들어간 경로를 다시 붙이지 마세요. 지원 엔드포인트 - Image Generations
- 프롬프트로 새 이미지를 만드는 OpenAI Images 호환 엔드포인트입니다. 지원 모델과 요청 형식
- Image Edits
- 입력 이미지와 프롬프트를 multipart 요청으로 보내 이미지를 바꾸는 엔드포인트입니다. 파일 조건과 결과 형식
- 작업 ID (job ID)
- 영상 생성 요청이 접수됐을 때 받는 식별자입니다. 같은 작업 조회에 사용하며 결과 파일의 미디어 ID와 구분합니다.
- 미디어 ID (media_id)
- 생성 결과 파일의 식별자입니다. 링크가 만료돼도 파일이 보관 중이면 같은 ID로 파일 링크를 다시 발급받을 수 있습니다.
- 참조 파일 (reference)
- 영상 생성의 입력으로 쓰는 이미지, 영상 또는 오디오입니다. 로컬 파일은 참조 파일 업로드 뒤 응답의
reference를 생성 요청에 사용합니다. - 스트리밍
- 생성 중 응답을 조각으로 받는 방식입니다. 지원 모델에
"stream": true로 요청하며 API별 이벤트와 종료 신호는 해당 엔드포인트를 따릅니다. - estimated_cost
- 지원되는 동기 모델 호출 응답의 호출별 비용 객체입니다. 이름에
estimated가 남아 있지만 계산할 수 있는 경우 해당 호출의 과금 기록에 쓰는 값을 반환합니다. 최종 납부 금액은 아니며 필드 위치와 비용 해석을 확인하세요.