FAQ
지금 보이는 증상에서 시작해 안전한 다음 행동을 찾으세요.
계정, API 사용과 결제 문제의 원인을 좁히고 다음 확인 경로를 안내합니다.
영상이나 Batch의 진행 상태와 파일 수령 문제는 영상 작업 확인 또는 Batch 결과와 오류 확인에서 이어갑니다.
가입, 계정 및 스페이스
계정에 로그인할 수 없습니다.
이메일과 Google 중 가입할 때 선택한 로그인 방식을 확인하고 로그인 방식에 맞는 계정 복구 안내를 따르세요.
초대 링크가 열리지 않거나 만료됐습니다.
스페이스 Admin에게 현재 사용할 링크를 요청하세요. 여러 링크를 받았다면 Admin이 다시 안내한 링크로 초대받은 스페이스에 참여합니다.
참여한 스페이스가 보이지 않습니다.
로그인한 계정과 초대 안내의 스페이스 이름을 대조하세요. 목록에 계속 없으면 Admin에게 참여 대상 계정을 확인하고 초대 참여 결과 확인으로 돌아갑니다.
Admin과 Member는 무엇이 다른가요?
역할은 현재 스페이스마다 적용됩니다. 구성원 초대, 역할 변경과 제거는 Admin이 할 수 있습니다. 먼저 현재 스페이스의 역할별 작업을 확인하세요. AI 게이트웨이 API 키의 관리 범위는 서비스에서 따로 정합니다.
API 키와 인증
AI 게이트웨이 API 키 원문을 잃어버렸습니다. 다시 볼 수 있나요?
다시 볼 수 없습니다. 원문은 생성 완료 화면에서 한 번만 표시됩니다. 새 키를 만들고 연결된 사용처 교체하기를 진행한 뒤 기존 키의 사용처를 확인하고 삭제하세요.
AI 게이트웨이 API 키가 노출됐습니다.
노출된 키를 즉시 삭제하고 새 키로 코드, 자동화와 외부 도구를 교체하세요. 다른 사용자가 만든 키라면 스페이스 Admin에게 즉시 알립니다. 노출된 키의 사용량 확인과 복구 절차를 따르세요.
401 인증 오류가 반환됩니다.
먼저 요청 주소로 어느 API를 호출했는지 확인하세요.
AI 게이트웨이 요청(https://gw.letsur.ai): sk_... 키를 사용합니다. 응답의 type이 invalid_credentials, missing_credentials, api_key_expired 중 무엇인지 확인하세요. OpenAI 호환 경로와 Anthropic Messages의 헤더가 다르므로 AI 게이트웨이의 경로별 인증 형식과 오류 원인을 대조하세요.
플랫폼 API 요청(https://openapi.letsur.ai/v1): 관리 API 키(mk_...)가 필요합니다. 플랫폼 API의 요청 주소와 Bearer 인증 헤더를 대조하세요.
AI 게이트웨이 API 키와 관리 API 키는 같은가요?
다릅니다. sk_...는 모델 호출, mk_...는 스페이스의 월별 사용량과 유닛 잔액 조회에 사용합니다. 관리 키가 필요하면 관리 API 키 발급 권한과 인증을 확인하세요.
모델과 호출
영상 생성은 성공했는데 파일을 받지 못했습니다.
작업 성공과 파일 준비는 별도입니다. 같은 작업의 파일 상태를 확인하세요. 다운로드 링크가 만료됐더라도 파일이 보관 중이면 같은 미디어 ID로 재발급할 수 있지만, 파일 보관 만료는 새 링크로 복구할 수 없습니다. 영상 작업과 파일 상태 확인을 따르세요.
모델 코드와 지원 API는 어디서 확인하나요?
AI 게이트웨이 > 에셋에서 현재 스페이스의 모델 코드와 지원 API를 확인하세요. GET /v1/models는 OpenAI 호환 모델 목록만 반환합니다. 에셋에서 모델과 API 선택하기
OpenAI SDK를 사용할 수 있나요?
지원되는 OpenAI 호환 엔드포인트에서 사용할 수 있습니다. base URL은 https://gw.letsur.ai/v1이며 AI 게이트웨이 API 키와 에셋의 모델 코드를 사용합니다. 첫 요청의 준비와 성공 확인
이미지 생성과 편집에 별도 OpenAI API 키가 필요한가요?
필요하지 않습니다. 현재 gpt-image-2는 모든 스페이스에서 기존 AI 게이트웨이 API 키로 Image Generations와 Image Edits를 호출합니다. Gemini 이미지 모델은 에셋에서 제공되는 경우 같은 키로 Chat Completions를 사용합니다. 모델별 지원 API와 요청 형식을 확인하세요.
Claude Code나 Anthropic SDK도 사용할 수 있나요?
Messages를 지원하는 모델에서 사용할 수 있습니다. Anthropic 네이티브 base URL은 https://gw.letsur.ai입니다. Claude Code 연결 조건과 설정을 따르세요.
응답을 스트리밍으로 받고 싶습니다.
모델과 엔드포인트가 스트리밍을 지원하는지 먼저 확인하세요. Chat Completions와 Responses의 이벤트와 마지막 usage 위치는 다릅니다. 지원 API별 스트리밍 계약을 확인하세요.
사용량, 한도 및 결제
영상 작업 응답에 비용이 없습니다. 무료인가요?
아닙니다. usage가 없으면 비용을 아직 확인하지 못한 상태입니다. 같은 작업을 다시 조회하고 영상 작업 비용 확인을 따르세요. 파일을 받지 못했다는 이유도 무료나 자동 환불을 뜻하지 않습니다.
이번 달 사용량은 어디서 보나요?
AI 게이트웨이 > 분석에서 월간 기준의 에셋 및 API 키별 누적 unit과 호출 수를 확인합니다. 월간 사용량 비교하기
콘솔에 자주 접속하지 않고 사용량과 잔액을 확인할 수 있나요?
관리 API 키로 플랫폼 API의 /usage에서 KST 월별 USD 비용과 호출 수를, /balance에서 현재 unit 잔액과 차단 상태를 조회할 수 있습니다. 호출별 비용은 별도로 기록해야 합니다. 플랫폼 API 조회 범위와 시작 방법
API 키의 월 한도를 비워 두면 어떻게 되나요?
그 키의 월 한도 없이 저장되지만 구성원 월 한도와 보유 유닛에 따른 제한은 유지됩니다. 운영에 연결하기 전에 키별 월 한도 설정 여부를 검토하세요.
429 usage_limit_exceeded가 반환됩니다.
해당 API 키의 월 한도에 도달한 상태입니다. 반복 재시도하지 말고 키의 한도와 최근 누적 사용량을 확인하세요.
estimated_cost, 분석 사용량과 실제 결제는 같은 값인가요?
다릅니다. 호출 한 건의 비용, 누적 unit, VAT 포함 KRW 미결제 금액은 대상, 기간과 단위가 다릅니다. 찾는 비용 값과 비교 조건을 먼저 고르세요.
결제 메뉴나 필요한 작업이 보이지 않습니다.
현재 스페이스를 확인하세요. 메뉴가 없거나 작업이 보이지 않으면 역할과 스페이스의 결제 상태를 Admin에게 확인합니다. 결제 작업의 시작 조건을 따르세요.
오류와 지원
영상 생성 요청을 보냈는데 작업 ID를 받지 못했습니다.
응답을 받지 못해도 요청이 접수됐을 수 있으므로 새 생성을 반복하지 마세요. 스페이스 이름, 요청 시각과 오류 코드로 플랫폼 내 문의 기능에서 접수 여부를 확인합니다. 영상 생성 접수와 작업 ID 확인
어떤 오류를 재시도해야 하나요?
반복해도 안전한 요청은 rate_limit_exceeded나 5xx에서 간격을 늘려 제한적으로 재시도합니다. 영상 생성의 접수 여부가 불분명하면 새 생성을 보내지 않습니다. usage_limit_exceeded는 한도를 확인하고 다른 4xx는 요청을 고칩니다. 오류 유형별 재시도 기준
안내대로 조치해도 오류가 계속되면 로그인 뒤 플랫폼 내 문의 기능을 사용합니다. 스페이스 이름, 계정 이메일, 발생 시각, 엔드포인트, HTTP 상태, 응답의 type 또는 error.code, error_ref와 확보한 작업 ID를 남기세요. API 키나 전체 인증 헤더는 보내지 마세요.