GPT Image 2.5 is live — OpenAI's newest image model, targeted edits that leave the rest of the frame alone
모든 가이드

· reAPI Team

fal User is locked 오류: 계정, 키, 잔액 확인

fal User is locked 오류가 발생하면 응답, 계정, 크레딧, 키 권한을 확인하세요. 재시도하거나 더 결제하기 전에 지원팀에 전달할 증거를 준비하세요.

fal User is locked 오류: 계정, 키, 잔액 확인

충전한 뒤에도 User is locked가 계속 나타날 수 있습니다. fal의 공개 이슈 922에서 사용자들은 대시보드에는 크레딧이 표시되는데 요청은 여전히 잠금 응답을 받는 불일치를 설명했습니다. 스레드에는 서로 다른 해결 사례와 실패 사례가 담겨 있으며, 담당자는 결국 영향을 받은 사용자에게 계정별 지원팀에 문의하라고 안내했습니다.[1]

이 이력만으로 오류 원인을 확정할 수는 없습니다. 하지만 “돈을 더 충전하기”나 “키를 하나 더 만들기”가 불완전한 답인 이유는 설명해 줍니다. 먼저 API가 반환한 전체 사유, 실행 중인 애플리케이션이 사용하는 계정, 오류가 발생한 시각을 확인하세요. 이러한 사실이 확인되지 않은 동안에는 애플리케이션의 자동 제출을 일시 중지하세요.

“Reason” 뒤에 있는 문구를 보존하세요

잔액 소진 메시지와 관리자 잠금 메시지를 같은 로그 항목으로 합쳐서는 안 됩니다. HTTP 상태, 엔드포인트, 메서드, 타임스탬프와 함께 전체 응답 본문을 보존하세요. 403만 남긴 로그는 다음 판단에 필요한 정보를 버린 것입니다.

그런 다음 어떤 작업이 실패했는지 확인하세요. 애플리케이션이 새 생성을 제출하고 있었나요, 이미 승인된 요청을 확인하고 있었나요, 아니면 결과를 가져오려 했나요? 워크플로 끝에 표시된 SDK 예외는 어느 단계에서든 발생했을 수 있습니다. 해결 방법은 실제로 거부 응답을 받은 단계에 따라 달라집니다.

가상의 순서를 생각해 보세요. 제출에서 요청 ID가 반환되고 작업자가 이를 저장한 뒤, 나중에 폴링하는 과정에서 잠금 오류를 받습니다. 이 순서만으로 이전 생성이 실패했거나 취소됐다고 입증되지는 않습니다. ID와 두 작업의 응답을 모두 보관하세요. 전체 워크플로를 다시 실행하면 기존 요청의 결과를 확인하지 못한 채 새 제출이 만들어집니다.

반대로 최초 제출이 거부되어 요청 ID가 오지 않았다면 그 구체적인 결과를 기록하세요. 작업 식별자를 지어내거나 권한 부여 메시지를 근거로 생성의 최종 상태를 지정하지 마세요. 지금 조사하는 것은 작업이 허용되었는지 여부이지, 생성된 미디어의 품질이 아닙니다.

fal 완료 상태 가이드는 알려진 요청이 최종 상태에 도달했지만 미디어가 없는 별개의 사례를 다룹니다. 이러한 경우를 구분하면 계정 문제 때문에 불필요한 재생성을 하는 일을 막을 수 있습니다.

잔액을 해석하기 전에 계정을 확인하세요

fal FAQ에 따르면 잔액이 계정 잠금 기준보다 낮아지면 계정이 잠깁니다. 이 경우에는 크레딧 추가를 권장하며 기업 인보이스 결제는 별도로 다룹니다.[2] 이 규칙은 화면에 양수 잔액이 표시되면 모든 계정이 반드시 이용 가능하다는 일반적인 보장이 아닙니다.

먼저 애플리케이션 키를 소유한 계정과 대시보드에서 선택한 계정이 일치하는지 확인하세요. 관련이 있다면 팀 컨텍스트도 포함하세요. 브라우저에는 자금이 있는 팀이 표시되지만 작업자는 개인 키를 사용할 수 있습니다. 이는 확인해야 할 문제 해결 가능성이지, 현재 요청의 원인으로 확정된 설명은 아닙니다.

평소 사용하는 시크릿 관리 도구를 통해 실행 중인 프로세스의 설정을 확인하세요. 키 이름이나 안전한 식별자로 시크릿을 출력하지 않고도 출처를 확인할 수 있습니다. 최근 누군가 자격 증명을 변경했다면 배포에 의도한 설정이 실제로 로드되었는지 확인하세요. 로컬 환경 파일을 업데이트했다고 해서 별도의 작업자가 무엇을 사용하는지 알 수 있는 것은 아닙니다.

확인된 시점의 잔액 관찰 내용과 오류를 비교하세요. 예를 들어 충전 전에 찍은 스크린샷으로는 나중에 요청이 실패했을 때 잔액이 바뀌었는지 확인할 수 없습니다. 영수증 시각, 대시보드 캡처 시각, 실패한 작업 시각을 함께 기록하세요. 날짜가 없는 스크린샷 두 장 대신 지원팀이 검토할 수 있는 순서가 생깁니다.

영향을 받은 계정의 잔액과 반환된 사유가 문서에 나온 충전 기준에 부합하면 해당 결제 안내를 따르세요. 완료된 구매가 반영되지 않았다면 구매 및 크레딧 기록을 조사하세요. 올바른 계정에 크레딧이 표시되는데 잠금 이유가 설명되지 않는다면, 다시 입금한다고 문제가 해결된다는 근거는 없습니다.

대시보드 로그인도 API 접근과는 다른 작업입니다. 일회용 코드가 도착하지 않아 GitHub로 로그인할 수 없다면 fal FAQ는 GitHub 계정의 기본 이메일을 확인하라고 안내합니다.[2] 이는 계정 페이지에 접근하는 데 도움이 될 수 있지만 이미 설정된 애플리케이션이 계정 잠금 응답을 받는 이유를 설명하지는 않습니다.

계정에 잔액이 있어도 키 정책이 잘못됐을 수 있습니다

fal은 권한 프리셋, 사용자 지정 권한 목록, 허용 모델 제한, 키 만료를 문서화합니다. API 프리셋은 호스팅 모델을 사용하는 용도입니다.[3] 이러한 제어 항목은 자격 증명으로 할 수 있는 작업을 정합니다. 잔액은 보유한 자금을 나타냅니다. 하나를 바로잡아도 다른 하나가 올바르다는 뜻은 아닙니다.

정확히 실패한 작업을 키 정책과 비교하세요. 키가 특정 모델로 제한되어 있다면 의도한 엔드포인트가 그 제한에 해당하는지 확인하세요. 만료됐다면 크레딧을 더하는 대신 자격 증명을 바로잡으세요. 클라이언트가 예상과 다른 키를 보내고 있다면 계정 권한을 변경하기 전에 설정을 수정하세요.

놓치기 쉬운 점은 정책이 만들어진 방식입니다. fal에 따르면 프리셋 키는 현재 프리셋 정의를 따르지만 사용자 지정 정책은 생성 당시의 권한 목록을 유지합니다. 모델 제한을 추가하면 키는 사용자 지정 정책으로 저장됩니다.[3] 따라서 같은 애플리케이션용으로 만든 두 키도 권한이 계속 같다고 가정하지 말고 각각 살펴볼 필요가 있습니다.

오류가 바뀌는지 보려고 모든 키에 전체 접근 권한을 주지 마세요. 애플리케이션에 필요한 작업만 허용하고 이전 정책은 조사 메모에 보존하세요. 여러 항목을 동시에 변경한 뒤 요청이 성공하면 어떤 변경이 영향을 주었는지 알 수 없고, 애플리케이션에 필요한 범위보다 넓은 접근 권한을 남길 수도 있습니다.

마찬가지로 키 교체는 문서화된 보편적 계정 잠금 해제 작업이 아닙니다. 이슈 922에서 새 키나 SDK 업데이트 후 성공했다고 보고한 사용자도 있었지만, 그런 단계가 효과가 없었다고 한 사용자도 있었습니다.[1] 이는 개별 관찰입니다. SDK 버전, 키 이전, 잠금 해제 지연이 모든 유사 메시지의 원인임을 입증하지 않습니다.

두 클라이언트를 비교할 때는 먼저 의도한 계정, 모델, 작업을 일치시키세요. 노트북에서 한 모델에 보낸 요청이 성공했다고 해서 예약 작업자가 다른 모델에 접근할 수 있는 것은 아닙니다. 수정 방법을 선택하기 전에 남아 있는 차이를 기록하세요. 그렇지 않으면 모델이나 계정 변경을 클라이언트 라이브러리 문제의 해결로 오인할 수 있습니다.

증거가 클라이언트를 가리킨다면 설치된 클라이언트 버전과 요청 구성을 검토하세요. 패키지를 변경하기 전에 서비스의 전체 응답을 보관하세요. 그러면 클라이언트 설정 수정과 제공업체의 조치가 필요한 계정 제한을 구분할 수 있습니다.

호스팅 모델과 Serverless 배포는 확인 사항이 다릅니다

fal의 호스팅 Model API만 호출한다면 설치 가이드에 따르면 필요한 것은 API 키와 클라이언트 SDK이지 Serverless CLI가 아닙니다. 자체 Serverless 앱을 배포하려면 계정 승인이 필요하지만 호스팅 Model API 호출에는 그 승인이 필요하지 않습니다.[4]

검색 결과가 CLI 설치나 팀 전환 절차로 안내할 때 이 점이 중요합니다. 해당 절차가 오류를 받은 제품과 프로세스에 적용되는지 확인하세요. CLI 프로필이 정상 작동한다고 해서 별도로 배포한 웹 서비스가 어떤 자격 증명을 사용하는지 알 수 있는 것은 아닙니다.

브라우저 애플리케이션의 경우 fal은 서버 측 프록시 뒤에 키를 보관하라고 권장합니다.[2] 시크릿을 브라우저 코드에 넣는 것은 계정 잠금을 해결하는 방법이 아닙니다. 인증은 서버에 유지하면서 프록시가 실제로 사용하는 자격 증명과 반환된 오류를 확인하세요.

조사할 계정 하나와 사건의 경과를 지원팀에 전달하세요

원인을 알 수 없는 잠금의 경우 담당자는 영향을 받은 계정과 같은 이메일을 사용해 fal 지원팀에 연락하라고 안내합니다. 잠금 사례는 개별적으로 처리되며 공개 이슈 댓글로는 잠금을 해제할 수 없습니다.[1]

간결한 비공개 보고서는 다음 형식을 따를 수 있습니다.

계정: [영향을 받은 계정]. [UTC 시각]에 [작업 및 엔드포인트]가 [민감 정보를 제거한 전체 오류]를 반환했습니다. 애플리케이션은 [계정 또는 팀] 소유의 [안전한 자격 증명 식별자]를 사용합니다. [캡처 시각]에 해당 계정에는 [잔액]이 표시되었습니다. 관련이 있다면 구매 [참조 번호]는 [시각]에 기록되었습니다. 요청 [ID]가 있다면 나중의 오류 전에 승인되었습니다. 여기에 표시된 계정 제한과 작업을 검토해 주세요.

클라이언트 이름과 버전을 추가하고 이미 완료한 확인 사항을 적으세요. 인증 헤더, API 키, 불필요한 결제 정보는 제거하세요. 사용한 키, 받은 응답, 표시된 잔액 등 관찰한 내용을 명확하게 설명하세요. 기록으로 입증되지 않는 데이터베이스 장애나 청구 사유를 단정하지 마세요.

배경 자료로 참고하는 이슈가 있다면 담당자의 최신 답변을 읽으세요. 별도 보고인 이슈 1163은 담당자가 지원팀이 이전에 해당 계정을 해결했다고 말한 뒤 종료되었습니다.[5] 그렇다고 모든 계정이 해결된 것은 아닙니다. 원래 보고 역시 지금도 장애가 계속되고 있음을 증명하지 않습니다. 어느 스레드에서도 보편적인 대기 시간이나 환불 약속을 추론할 수 없습니다.

지원팀이 계정 잠금이 풀렸다고 하면 실패한 작업으로 돌아가세요. 승인된 작업 뒤에 폴링이 거부된 가상 사례라면 먼저 기존 요청을 확인하세요. 접근이 복구되면 상태를 가져올 수 있지만 생성 자체가 성공했다고 보장되지는 않습니다. 새 응답을 이전 잠금 메시지와 함께 저장하세요. 같은 작업이 계속 실패하면 현재 계정 상태를 검토할 수 있도록 기존 지원 대화에 업데이트된 타임스탬프와 응답을 보내세요.

접근 권한이 돌아오면 작업을 재개하기 전에 일시 중지했던 작업을 검토하세요. 거부된 제출과 이미 ID를 받은 작업을 구분하고, 후자는 다시 만들기 전에 확인하세요. 접근 복구를 시험하기 위해 생성한 작업은 승인되면 비용이 발생할 수 있습니다. 이 글에서는 그런 테스트를 실행하지 않았습니다. 수정된 계정과 자격 증명을 기록하고 여전히 수행하려는 작업만 재개하세요.

워크로드를 옮기더라도 이 점검은 유지하세요

이번 잠금 때문에 다른 제공업체를 검토한다면, 그쪽에서도 자격 증명 문제와 잔액 문제가 구분되는지 확인하세요. reAPI에서는 유효하지 않은 키가 HTTP 401과 코드 10003, 폐기된 키가 10004, 크레딧 부족이 HTTP 402와 코드 30001을 반환합니다.[6] 워커는 생성을 시작하지 않고도 GET /api/v1/balance로 자신의 키가 속한 계정의 잔액을 확인할 수 있습니다.[7]

명확한 오류 코드가 위의 습관을 대신하지는 않습니다. 전체 응답, 시각, 실패한 작업을 기록하고, 크레딧을 추가하기 전에 배포된 키가 어느 계정에 속하는지 확인하세요.

참고 자료

  1. fal-ai/fal. 이슈 922: 잔액이 남아 있는데 계정이 잠김, 담당자 안내를 포함한 전체 스레드. 2026년 11월 15일 조회.
  2. fal. Model API FAQ. 2026년 11월 15일 조회.
  3. fal. 키 기반 인증: 권한, 허용 모델, 만료. 2026년 11월 15일 조회.
  4. fal. 설치 및 설정: Model API와 Serverless 접근. 2026년 11월 15일 조회.
  5. fal-ai/fal. 이슈 1163: 잔액이 남아 있는데 잔액이 소진되어 계정이 다시 잠김, 담당자의 해결 내용을 포함. 2026년 11월 15일 조회.
  6. reAPI. 오류. 2026년 11월 17일 검토. 오류 코드.
  7. reAPI. 잔액. 2026년 11월 17일 검토. 잔액 참조.
모든 가이드