WaveSpeedAI

fal.ai 'User is locked'(Admin lock, Exhausted balance): 의미와 대처 방법

fal.ai 키가 403 'User is locked. Reason: Admin lock' 또는 'Exhausted balance'를 반환하나요? 각 사유의 의미, 잠금 해제 방법, 그동안 앱을 계속 운영하는 방법을 안내합니다.

By WaveSpeedAI8 min read

만약 fal.ai 요청이 갑자기 403으로 실패하고 응답 본문에 User is locked라고 표시된다면, 차단된 것은 요청이 아니라 계정입니다. 재시도해도 해제되지 않으며, 대부분의 사례에서 새 API 키를 발급받아도 해제되지 않습니다. 이후 대응은 메시지에 적힌 사유에 따라 달라집니다. Exhausted balance는 충전하면 풀리도록 되어 있는 결제 잠금이고, Admin lock은 fal 측에서 건 잠금이라 fal 지원팀만 해제할 수 있습니다.

이 가이드는 각 사유가 무엇을 의미하는지, 계정 잠금을 가장 빨리 푸는 단계별 순서, 그리고 기다리는 동안 서비스를 계속 운영하는 방법을 다룹니다.

출처 확인일 2026년 11월 22일: fal 공식 문서와 GitHub fal-ai/fal 저장소의 공개 이슈 트래커.

오류는 어떤 모습인가

API는 HTTP 403과 detail 문자열로 응답합니다. 공개된 제보에 나타나는 세 가지 변형은 다음과 같습니다.

{"detail": "User is locked. Reason: Exhausted balance. Top up your balance at fal.ai/dashboard/billing."}
{"detail": "User is locked. Reason: Admin lock. Please contact support@fal.ai."}
{"detail": "User is locked. Reason: TOP_UP."}
메시지의 사유의미해제할 수 있는 주체
Exhausted balance결제 잠금입니다. fal의 FAQ에는 다음과 같이 적혀 있습니다. “When your credit balance drops below your account’s lock threshold, your account is locked and API requests will be rejected.”사용자가 크레딧을 추가하면 됩니다. 충전 후에도 잠금이 유지되면 fal 지원팀이 해제합니다.
TOP_UPfal 문서에는 설명이 없습니다. 제보에서는 같은 계정에서 Exhausted balance 메시지와 함께 나타나므로, 동일한 결제 잠금으로 취급하는 것이 좋습니다.위와 동일합니다.
Admin lockfal 측에서 설정한 잠금입니다. 메시지 자체가 지원팀에 문의하라고 안내합니다. fal은 기준을 공개하지 않습니다.fal 지원팀만 가능합니다.

시작하기 전에 알아 둘 두 가지가 있습니다.

  • FAQ는 0이 아니라 잠금 임계값을 언급합니다. 대시보드에 몇 달러가 남아 있다고 해서 내 계정의 임계값 이상이라는 증거는 아닙니다.
  • 같은 FAQ에 따르면 청구서 결제 방식의 엔터프라이즈 고객은 “자동 잠금 대상이 아닙니다”. 종량제의 유연성보다 중단 없는 서비스가 더 중요하다면, fal에 문의해 볼 만한 플랜입니다.

다른 종류의 403: “Access denied”

fal이 반환하는 모든 403이 계정 잠금은 아닙니다. 본문에 접근이 거부되었다거나 엔드포인트를 사용할 권한이 없다고 되어 있고 User is locked라는 문구가 없다면, 계정은 열려 있지만 해당 키 또는 엔드포인트가 허용되지 않은 것입니다. fal의 인증 문서는 이런 종류의 403을 API 키의 권한 프리셋과 연결해 설명합니다. 실패하는 서비스가 어떤 키를 쓰는지, 그 키를 어떤 프리셋으로 만들었는지 확인하세요. 사용자 쪽에서 바뀐 것이 없는데 어제까지 잘 되던 키가 엔드포인트 계열 전체에서 거부된다면, 엔드포인트 ID와 전체 오류 본문을 첨부해 fal 지원팀에 문의할 사안입니다.

혼자만 겪는 일이 아닙니다

fal-ai/fal 이슈 트래커에는 2026년 3월부터 11월 사이에 열린, 계정 잠금에 관한 이슈가 25건 넘게 있습니다. 두 가지 유형으로 나뉩니다.

잔액이 있는데 잠긴 경우. 대시보드에 크레딧이 표시되는데도 Exhausted balance 잠금이 걸렸다는 제보입니다. 예를 들어 #922, #1112, #1163, #1269가 있습니다. #1163에서 제보자는 수동으로 잠금을 해제한 지 몇 분 만에 계정이 다시 잠겼다고 적었습니다.

충전 직후 Admin lock이 걸린 경우. 새 계정이나 사용량이 적은 계정이 첫 결제 직후 Admin lock에 걸렸다는 제보가 여러 건 있습니다. 예를 들어 #1183, #1248, #1254, #1281이 있습니다. 또 다른 #1061은 출시 전 엔드투엔드 테스트 중 사용량이 급증한 개발자가 올린 것입니다.

fal을 공정하게 평가하자면, 이는 개별 제보일 뿐 발생 빈도를 보여 주는 지표가 아닙니다. 또한 해당 스레드에서 fal 직원들은 지원팀이 계정 잠금을 해제했다고 확인합니다. #1281의 제보자는 이메일을 보낸 다음 날 잠금이 해제되었습니다. 다른 제보자들은 첫 답변까지 며칠을 기다렸다고 말합니다. 직원들은 GitHub는 계정 지원을 위해 모니터링하지 않는다고도 해당 스레드에서 밝혔습니다.

잠금을 푸는 순서

1. 사유를 읽고 재시도를 멈추기

403 본문 전체를 로그에 남기세요. 계정 잠금은 일시적인 실패가 아니므로 재시도 경로에서 제외해야 합니다. 잠긴 계정에 재시도를 계속하면 큐만 쌓이고, 누군가 조치해야 한다는 알림만 늦어집니다.

import requests

class AccountLocked(Exception):
    pass

def check_fal_response(resp: requests.Response) -> None:
    if resp.status_code == 403 and "User is locked" in resp.text:
        # Not retryable: page a human and switch to the fallback provider.
        raise AccountLocked(resp.json().get("detail", resp.text))
    resp.raise_for_status()

2. 먼저 결제 상태 확인하기

결제 대시보드를 열어 세 가지를 확인하세요. 크레딧 잔액, 미납 청구서가 없는지, 결제 수단이 유효한지입니다. 사유가 Exhausted balance 또는 TOP_UP이라면 크레딧을 추가하세요. 그런 다음 몇 분 뒤에 테스트 요청을 한 번 보내 보세요.

3. 계정 이메일 주소로 지원팀에 메일 보내기

사유가 Admin lock이거나 충전 후에도 결제 잠금이 풀리지 않는다면, fal이 안내하는 유일한 창구는 support@fal.ai입니다. 직원들은 잠긴 계정의 이메일 주소로 보내 달라고 요청합니다. 주고받는 횟수를 줄이려면 첫 메일에 필요한 정보를 모두 담으세요.

  • 계정 이메일과, 팀을 사용한다면 팀 이름.
  • 정확한 detail 문자열과 첫 실패 요청의 시각.
  • 가장 최근 충전의 영수증 또는 청구서 번호.
  • 서비스가 어떤 일을 하는지, 그리고 사용량이 달라졌다면 그 이유(출시, 부하 테스트, 새 기능 등)를 한두 문장으로.

4. 도움이 되지 않는 방법

  • API 키 교체. 잠금은 계정에 걸려 있습니다. 새 키를 만든 제보자들도 같은 403을 받았습니다.
  • 두 번째 계정 만들기. 잠금이 결제 또는 리스크 심사 때문이라면, 같은 카드로 만든 중복 계정은 심사를 빠르게 하기는커녕 늦추는 경우가 많습니다.
  • 매일 같은 메일 다시 보내기. 기록이 하나의 티켓에 모이도록 기존 스레드에 답장하세요.
  • 이메일 대신 GitHub 이슈 올리기. 가시성을 높일 수는 있지만, 직원들이 이슈를 닫고 이메일로 안내합니다.

팀이라면: 사람마다 계정을 만들지 말고 하나의 계정으로

커뮤니티 질문에서 자주 보이는 패턴은, 회사가 직원마다 개인 계정을 만들고 모두 같은 카드로 충전하는 것입니다. 하나의 카드로 결제되는 신규 계정이 많아지는 것은, 어느 플랫폼에서든 결제 리스크 시스템이 감지하도록 만들어진 바로 그 신호입니다. fal이 문서화한 방식은 팀입니다. 자체 결제 수단을 가진 공유 워크스페이스로, “API keys belong to the team, not to individual members”이며 관리자가 이메일로(대규모 그룹은 CSV로) 멤버를 초대합니다. 이미 이런 방식으로 계정이 잠겼다면, 지원 요청 메일에 그 사실을 솔직하게 밝히고 하나의 팀으로 통합해 달라고 요청하세요.

기다리는 동안 서비스를 계속 운영하기

계정 잠금은 재시도, 백오프, 두 번째 API 키로도 해결되지 않는 유일한 장애입니다. 유료 고객이 생성 파이프라인에 의존한다면, 현실적인 대비책은 같은 모델 계열을 제공하는 두 번째 플랫폼을 미리 연동하고 충전해 두어 설정 플래그 하나로 전환할 수 있게 하는 것입니다.

몇 가지 원칙을 지키면 유지 비용이 낮아집니다.

  • 모델 선택을 자체 인터페이스 뒤에 두어, 호출하는 쪽이 벤더 URL이 아니라 “텍스트-이미지, 1024 × 1024”를 요청하게 하세요.
  • 계정 수준 오류(잠금, 정지, 크레딧 소진)를 요청 수준 오류와 분리해 분류하고, 앞의 유형에서만 페일오버하세요.
  • 실제 트래픽의 일부를 매일 대체 경로로 보내세요. 한 달 동안 호출되지 않은 대체 경로는 정작 필요할 때 고장 나 있기 쉽습니다.

두 번째 플랫폼으로 WaveSpeedAI 사용하기

WaveSpeedAI는 이미지, 비디오, 오디오, 3D 모델을 위한 종량제 API입니다. 모델 카탈로그는 Seedance, Kling, Wan, Veo, FLUX, Seedream, GPT Image 등 대부분의 fal 프로젝트가 사용하는 계열을 포괄합니다. 이 문제와 관련해 중요한 점은 다음과 같습니다.

  • 크레딧은 요청마다 확인됩니다. 계정에 해당 요청을 처리할 만큼 크레딧이 있으면 요청이 수락됩니다. 충전하면 바로 다음 요청부터 통과하며, 기다려야 하는 별도의 잠금 해제 단계가 없습니다.
  • 크레딧이 소진되면 명확한 메시지를 반환합니다. API가 Insufficient credits. Please top up your account to continue를 반환하므로, 코드에서 결제 문제와 모델 실패를 구분할 수 있습니다.
  • 자동 충전. 설정한 잔액 아래로 내려가면 계정이 스스로 충전되도록 할 수 있어, 새벽 3시 장애의 가장 흔한 원인을 없애 줍니다.
  • 결제 수단. 카드, PayPal, Alipay, WeChat Pay.
  • 하나의 계정에서 팀원 사용. 대시보드에서 팀원을 초대하면 개인 계정을 따로 쓰지 않고 모두가 같은 잔액을 사용합니다.
  • 실행 전 가격 표시. 각 모델 페이지에 설정한 요청의 비용이 표시됩니다.

모든 플랫폼이 그렇듯 WaveSpeedAI에도 이용 약관과 콘텐츠 규정이 있으므로, 프로덕션 트래픽을 옮기기 전에 읽어 보세요.

요청은 이렇게 생겼습니다

작업을 제출한 다음, 반환된 id로 결과를 가져옵니다. 예시는 빠른 텍스트-이미지 모델을 사용하며, 카탈로그의 모든 모델이 같은 두 번의 호출을 따릅니다.

curl --request POST 'https://api.wavespeed.ai/api/v3/wavespeed-ai/z-image/turbo' \
  --header "Authorization: Bearer $WAVESPEED_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{"prompt": "A lighthouse on a cliff at sunrise, soft fog, 35mm photo"}'
curl --request GET "https://api.wavespeed.ai/api/v3/predictions/$PREDICTION_ID/result" \
  --header "Authorization: Bearer $WAVESPEED_API_KEY"

첫 번째 호출은 data.id를 반환합니다. 두 번째 호출은 data.status(created, processing, completed, failed)를 반환하고, 완료되면 data.outputs에 파일 URL을 담아 반환합니다.

fal에서의 매핑

falWaveSpeedAI
모델의 큐 엔드포인트에 제출POST https://api.wavespeed.ai/api/v3/<model path>
요청 상태를 폴링한 뒤 결과 가져오기GET https://api.wavespeed.ai/api/v3/predictions/<id>/result
Authorization: Key ... 헤더Authorization: Bearer ... 헤더
완료 시 웹훅지원됩니다. 문서를 참고하세요
Python 및 JavaScript 클라이언트Python 및 JavaScript SDK, 그리고 순수 REST

일부 모델은 플랫폼마다 입력 이름이 다르므로, 페이로드를 그대로 복사하지 말고 각 모델 페이지의 파라미터 목록을 확인하세요.

코드를 작성하기 전에 브라우저에서 먼저 테스트하고 싶다면, 이미지 생성기와 비디오 생성기가 API와 동일한 모델을 실행합니다.

FAQ

fal.ai에서 “User is locked. Reason: Admin lock”은 무슨 뜻인가요?

자동 잔액 확인이 아니라 fal 측에서 계정을 잠갔다는 뜻입니다. 메시지는 support@fal.ai로 문의하라고 안내합니다. 크레딧을 추가하거나 새 키를 만들어도 해제되지 않으며, fal 지원팀이 해제해야 합니다.

크레딧이 남아 있는데 왜 fal 계정이 “Exhausted balance”로 잠기나요?

fal의 FAQ에 따르면 잔액이 계정별 잠금 임계값 아래로 내려가면 잠금이 걸리며, 이 임계값은 반드시 0은 아닙니다. 이와 별개로, 충전에 성공한 뒤에도 잠금이 남아 있었다는 공개 제보가 여러 건 있으며, 그런 경우 지원팀이 수동으로 해제했습니다. 충전하고, 몇 분 기다렸다가, 한 번 테스트한 다음 지원팀에 이메일을 보내세요.

fal이 계정 잠금을 해제하는 데 얼마나 걸리나요?

공개된 소요 시간은 없습니다. 공개 스레드에서는 이메일을 보낸 지 하루 안에 해제된 사용자도 있고, 첫 답변까지 며칠을 기다렸다는 사용자도 있습니다. 더 긴 경우를 기준으로 계획하세요.

fal이 “Access denied” 또는 “You do not have permission to use this endpoint”를 반환하는 이유는 무엇인가요?

계정 잠금이 아니라 권한 오류입니다. 요청에 사용한 API 키의 권한 프리셋을 확인하세요. 키와 코드가 바뀌지 않았다면, 엔드포인트 ID와 오류 본문을 fal 지원팀에 보내세요.

하나의 카드를 쓰는 여러 fal 계정이 잠길 수 있나요?

fal은 리스크 규칙을 공개하지 않습니다. 하나의 카드로 충전되는 계정이 많은 것은 일반적으로 결제 리스크 검사의 흔한 트리거이며, fal은 여러 사람이 하나의 결제 계정을 공유하도록 팀 기능을 제공하므로 팀을 사용하세요.

새 API 키나 새 계정으로 해결되나요?

새 키로는 해결되지 않습니다. 잠금은 계정에 걸려 있기 때문입니다. 기존 계정이 심사를 받는 동안 새 계정을 만드는 것은 좋은 방법이 아닙니다.

어떤 플랫폼에서든 계정 잠금으로 인한 다운타임을 피하려면 어떻게 해야 하나요?

두 번째 공급자를 연동하고 충전해 두며, 계정 수준 오류는 재시도 불가로 취급하고 자동으로 페일오버하세요. 플랫폼이 자동 충전을 제공한다면 켜 두어, 잔액 부족이 잠금으로 이어지지 않게 하세요.

공유