FAQ

스페이스 Admin에게 현재 사용할 초대 링크를 요청합니다. 여러 링크를 받았다면 임의로 유효 여부를 판단하지 말고 Admin이 다시 안내한 링크를 엽니다.

다음 단계: 새 초대 링크를 받고 참여하기 →

가입 또는 로그인 뒤 안내받은 스페이스가 보이지 않으면 현재 로그인한 계정과 초대 안내의 스페이스 이름을 확인합니다. 참여 대상 계정이 불분명하거나 목록에 계속 보이지 않으면 스페이스 Admin에게 현재 참여 상태를 확인합니다.

다음 단계: 로그인 계정과 참여한 스페이스 확인하기 →

Admin과 Member는 개인 계정 전체가 아니라 현재 스페이스에 적용되는 역할입니다. 먼저 현재 스페이스와 본인 역할을 확인한 뒤, 구성원 관리와 AI 게이트웨이 API 키에 필요한 작업 범위를 각각 확인합니다.

권한별 절차: 스페이스 구성원 역할 관리하기 →, 역할별 API 키 관리 범위 보기 →

볼 수 없습니다. 키 원문은 생성 완료 화면에서 한 번만 표시됩니다. 새 키를 만들고 코드, 자동화 및 외부 도구의 값을 교체한 뒤, 기존 키가 목록에 남아 있으면 사용처를 확인하고 삭제합니다.

해결 절차: 새 API 키를 만들고 사용처 교체하기 →

추가 피해를 막기 위해 노출된 키를 즉시 삭제합니다. 새 키를 만든 뒤 연결된 사용처를 교체하고, 분석에서 노출 이후 사용량을 확인합니다. 다른 사용자가 만든 키라면 스페이스 Admin에게 즉시 알립니다.

해결 절차: 노출된 API 키 삭제하고 사용처 복구하기 →

응답의 type이 invalid_credentials, missing_credentials, api_key_expired 중 무엇인지 확인합니다. OpenAI 호환 경로는 Authorization: Bearer <API_KEY>, Anthropic Messages는 x-api-key 헤더와 키 만료일을 확인합니다.

진단 절차: 경로별 인증 헤더 확인하기 →, 401 에러 유형별 원인 찾기 →

아닙니다. AI 게이트웨이 API 키(sk_...)는 모델 호출에 사용하고, 관리 API 키(mk_...)는 스페이스의 월별 사용량과 유닛 잔액 조회에 사용합니다. 필요한 키가 보이지 않으면 현재 스페이스와 역할을 확인한 뒤 각 키 문서의 발급 위치로 이동합니다.

다음 단계: 관리 API 키의 발급 권한과 사용 범위 보기 →

AI 게이트웨이 > 에셋에서 현재 스페이스에 배급된 모델 코드, 지원 API, 컨텍스트 및 unit 단가를 확인합니다. GET /v1/models는 OpenAI 호환 모델 목록만 반환합니다.

다음 단계: 현재 사용할 수 있는 모델 코드와 지원 API 찾기 →

지원되는 OpenAI 호환 엔드포인트에서는 SDK의 base URL을 https://gw.letsur.ai/v1로 바꾸고 AI 게이트웨이 API 키와 에셋의 모델 코드를 사용합니다.

다음 단계: OpenAI SDK로 첫 요청 보내기 →

필요하지 않습니다. 현재 gpt-image-2는 모든 스페이스에 기본 제공되며 기존 AI 게이트웨이 API 키로 Image Generations와 Image Edits를 호출합니다. 인증, 월 한도, 비용과 사용량도 다른 게이트웨이 요청과 함께 관리됩니다.

요청 형식 선택: 프롬프트로 이미지 생성하기 →, 입력 이미지 편집하기 →

Anthropic Messages를 지원하는 모델에서 사용할 수 있습니다. base URL은 /v1 없이 https://gw.letsur.ai로 지정하고, 에셋에서 해당 모델이 Messages를 지원하는지 확인합니다.

설정과 계약: Claude Code를 AI 게이트웨이에 연결하기 →, Messages 요청 및 응답 형식 보기 →

먼저 선택한 모델과 엔드포인트가 스트리밍을 지원하는지 확인합니다. Chat Completions와 Responses는 이벤트 형식과 마지막 usage 위치가 다르므로 호출 중인 엔드포인트의 계약을 따릅니다.

엔드포인트별 계약: Chat Completions 스트리밍 형식 보기 →, Responses 스트리밍 이벤트 보기 →

AI 게이트웨이 > 분석에서 월간 또는 일간 기준의 에셋별, API 키별 누적 unit 사용량과 호출 수를 확인합니다.

다음 단계: 에셋별, API 키별 누적 사용량 비교하기 →

가능합니다. 관리 API 키를 사용해 Platform API의 /usage에서 KST 월별 모델 및 API 키 cost와 호출 수를 조회하고, /balance에서 현재 보유 및 초과 unit과 차단 상태를 확인합니다. 호출별 또는 고객 작업별 비용은 각 AI 게이트웨이 응답의 estimated_cost를 작업 식별자와 함께 저장합니다.

다음 단계: Platform API로 월별 사용량과 유닛 잔액 조회하기 →, 호출별 비용 저장하기 →

월 한도 없이 저장됩니다. 운영 환경에 연결하기 전에 예상 호출량을 기준으로 키별 상한이 필요한지 검토합니다.

다음 단계: API 키 월 한도 정하기 →

해당 API 키의 월 한도에 도달한 상태입니다. 반복 재시도하지 말고 키 화면에서 현재 한도와 최근 누적 사용량을 확인합니다.

해결 절차: API 키 월 한도와 최근 사용량 점검하기 →, 재시도하면 안 되는 429 오류 구분하기 →

다릅니다. estimated_cost는 이름에 estimated가 남아 있지만 호출 한 건의 비용 추적에 사용하는 값이고, 분석은 반영된 누적 unit 사용량입니다. 결제 화면은 저장 카드, VAT 포함 KRW 미결제금, 거래와 제공되는 증빙을 다룹니다. 별도 계약에 따른 정산 조정은 호출별 비용과 구분합니다.

값 구분: 요청 비용, 누적 사용량, 유닛 및 결제의 차이 보기 →

현재 스페이스에서 결제 및 거래 메뉴와 결제 작업이 표시되는지 확인합니다. 보이지 않으면 현재 역할과 스페이스의 결제 상태를 Admin에게 확인합니다. 유닛 상태와 구매 조건은 결제 내역과 다른 화면에서 확인합니다.

확인할 화면: 카드, 미결제금과 거래 내역 확인하기 →, 유닛 잔액과 차단 상태 확인하기 →

rate_limit_exceeded와 5xx는 간격을 늘려 제한적으로 재시도합니다. usage_limit_exceeded는 월 한도를 확인하고, 다른 4xx는 요청 필드, 인증 또는 모델 코드를 수정한 뒤 다시 호출합니다.

다음 단계: 에러 유형별 재시도 기준 적용하기 →