Skip to Content
용어집

용어집

문서를 읽다가 모르는 단어가 나오면 여기서 찾습니다. 각 용어는 한두 문장으로 짧게 설명하고, 더 자세히 다루는 페이지로 링크를 걸어 뒀습니다.

플랫폼·조직

  • 플랫폼: Letsur가 제공하는 전체 기반입니다. 그 위에서 AI Gateway 같은 서비스가 동작합니다. 자세히는 플랫폼 개요에서 확인합니다.
  • 서비스: 플랫폼 위에서 켜서 쓰는 기능 단위입니다. 지금은 AI Gateway가 대표 서비스입니다.
  • Space: 한 조직(팀·회사)이 쓰는 작업 공간입니다. 멤버·권한·한도가 모두 Space 단위로 묶입니다. 자세히는 Space 멤버 역할에서 확인합니다.
  • Admin: Space 안의 관리 권한 멤버입니다. 멤버 초대·서비스 활성화·한도 정책을 정합니다. 자세히는 멤버 역할에서 확인합니다.
  • Member: Space 안의 일반 권한 멤버입니다. 활성화된 서비스를 쓰고, 자기 키와 자기 사용량을 관리합니다.

AI Gateway

  • AI Gateway: 여러 AI 공급사의 모델을 하나의 주소와 키로 호출하게 해주는 서비스입니다. 자세히는 AI Gateway 퀵스타트에서 확인합니다.
  • 에셋: 카탈로그에 등록된 모델을 가리키는 말입니다. “모델” 대신 쓰는 플랫폼 용어입니다. 자세히는 에셋 카탈로그에서 확인합니다.
  • 모델 코드: 호출할 때 model 필드에 넣는 식별자입니다(예: claude-sonnet-4-6). openai/ 같은 공급사 prefix는 붙이지 않습니다. 자세히는 에셋 카탈로그에서 확인합니다.
  • 키 (Gateway 키): Gateway를 호출할 때 인증에 쓰는 비밀 값입니다(sk-...). 발급 직후 한 번만 보입니다. 자세히는 키 라이프사이클에서 확인합니다.
  • 한도: 키·멤버·Space 단위로 거는 월 지출 상한입니다. 넘으면 호출이 429 로 막힙니다. 자세히는 한도 개요에서 확인합니다.

API·호출

  • base URL: API 요청을 보내는 기본 주소입니다. OpenAI 호환 경로는 https://gw.letsur.ai/v1, Anthropic 네이티브 경로는 https://gw.letsur.ai 입니다. 자세히는 Chat Completions에서 확인합니다.
  • 엔드포인트 (endpoint): base URL 뒤에 붙는 호출 경로입니다(예: /v1/chat/completions). 무엇을 하는 호출인지에 따라 달라집니다. 자세히는 지원 엔드포인트에서 확인합니다.
  • 스트리밍: 응답을 다 만들 때까지 기다리지 않고, 토큰을 생기는 대로 실시간(SSE)으로 받는 방식입니다. 요청에 "stream": true 를 넣습니다. 자세히는 Chat Completions 스트리밍에서 확인합니다.
  • estimated_cost: Letsur가 모든 응답에 더해 주는 필드입니다. 이번 호출의 예상 원가(USD)를 담습니다. 참고값이라 실제 청구와는 차이가 날 수 있습니다. 자세히는 요금에서 확인합니다.

에러

  • RFC 7807: 에러 응답의 표준 형식입니다(type·title·status·detail). Gateway의 모든 에러가 이 형식으로 옵니다. 자세히는 에러 코드에서 확인합니다.
  • error_ref: 에러 응답마다 붙는 추적용 식별자입니다(예: err_a3f2c1d8e5b0). 문의할 때 이 값을 전달하면 정확히 추적됩니다. 자세히는 에러 코드에서 확인합니다.

다음에 볼 것

Last updated on