· reAPI Team
fal User is locked の対処:アカウント・キー・残高を確認
fal User is locked エラーを調べるには、応答、アカウント、クレジット、キーの権限を確認してください。再試行や追加課金の前に、サポートへ提示する証拠を準備しましょう。

チャージ後も User is locked が繰り返し表示されることがあります。fal の公開 issue 922 では、ユーザーがこの食い違いを報告しています。ダッシュボードにはクレジットが表示されている一方、リクエストはロック応答を受け取っていました。スレッドには、ユーザーが報告したさまざまな解決策と失敗例があり、最終的にメンテナーは該当ユーザーにアカウントごとのサポートへ連絡するよう案内しました。[1]
この経緯から、エラーの原因が判明するわけではありません。ただし、「もっと入金する」または「別のキーを作る」だけでは不十分な理由は分かります。まず API が返した完全な理由、実行中のアプリケーションが使用するアカウント、エラーが発生した時刻を確認してください。それらが未確認の間は、アプリケーションの自動送信を一時停止してください。
「Reason」の後ろにある文言を残す
残高が枯渇したことを示すメッセージと、管理上のロックメッセージを、同じログ項目にまとめてはいけません。HTTP ステータス、エンドポイント、メソッド、タイムスタンプとともに、完全なレスポンス本文を保存してください。403 だけを残すログでは、次の判断に必要な情報が失われています。
次に、失敗した操作を特定してください。アプリケーションは新しい生成を送信していたのか、すでに受理されたリクエストを確認していたのか、それとも結果を取得しようとしていたのか。ワークフローの最後に表示された SDK の例外は、いずれの段階でも発生する可能性があります。対処法は、実際に拒否を受け取った段階によって異なります。
仮の流れを考えてみましょう。送信時にリクエスト ID が返り、ワーカーがそれを保存し、その後のポーリングでロックエラーを受け取ります。この流れだけでは、先に送信した生成が失敗した、またはキャンセルされたとは証明できません。ID と両方の操作の応答を保存してください。ワークフロー全体を再実行すると、既存リクエストの結果が分からないまま、新しい送信が作られてしまいます。
一方、最初の送信が拒否され、リクエスト ID が返らなかった場合は、その結果を記録してください。タスク識別子を作り上げたり、操作の許可に関するメッセージから生成の最終状態を割り当てたりしないでください。ここで調べているのは操作が許可されたかどうかであり、生成メディアの品質評価ではありません。
fal の完了状態ガイドでは、既知のリクエストが終端状態に達したものの、メディアが見つからない別のケースを扱っています。これらのケースを区別すれば、アカウントの問題による不要な再生成を防げます。
残高を解釈する前にアカウントを確認する
fal の FAQ によると、残高がアカウントのロックしきい値を下回るとアカウントがロックされます。そのケースではクレジットの追加が推奨され、企業向けの請求書払いは別扱いです。[2] このルールは、表示残高が正であればすべてのアカウントが必ず利用できるという意味ではありません。
まず、アプリケーションのキーを所有するアカウントと、ダッシュボードで選択したアカウントが一致するか確認してください。該当する場合はチームのコンテキストも含めてください。ブラウザーでは資金のあるチームが表示されていても、ワーカーは個人用キーを使っている可能性があります。これは確認すべきトラブルシューティング上の可能性であり、今回のリクエストについて確定した説明ではありません。
通常のシークレット管理ツールを使って、実行中プロセスの設定を調べてください。キー名や安全な識別子があれば、シークレットを表示せずに参照元を確認できます。最近、誰かが認証情報を変更した場合は、デプロイに意図した設定が実際に読み込まれたことを確かめてください。ローカルの環境ファイルを更新しても、別のワーカーが何を使用しているかは分かりません。
既知の時刻における残高の記録とエラーを比較してください。たとえば、チャージ前に撮ったスクリーンショットでは、その後のリクエストが失敗した時点で残高が変わっていたか分かりません。領収時刻、ダッシュボードを撮影した時刻、操作の失敗時刻をまとめて記録してください。日付のないスクリーンショットが2枚あるだけでなく、サポートが確認できる一連の経過になります。
該当アカウントの残高と返された理由が、文書に記載された入金しきい値に合致する場合は、その請求案内に従ってください。完了した購入が反映されていない場合は、購入とクレジットの記録を調べてください。正しいアカウントにクレジットが表示されているのにロックの理由が分からない場合、さらに入金しても問題が解決する根拠にはなりません。
ダッシュボードへのログインと API へのアクセスも別の操作です。ワンタイムコードが届かず GitHub でサインインできない場合、fal の FAQ は GitHub アカウントのプライマリメールアドレスを確認するよう案内しています。[2] これはアカウントページへのアクセスに役立つ可能性がありますが、設定済みのアプリケーションがアカウントロック応答を受け取る理由の説明にはなりません。
残高があってもキーのポリシーが違うことがある
fal は権限プリセット、カスタム権限リスト、許可モデルの制限、キーの有効期限を文書化しています。API プリセットはホスト型モデルの利用を目的としています。[3] これらの設定が決めるのは認証情報でできる操作です。残高が示すのは存在する資金です。一方を直しても、もう一方が適切だとは確認できません。
実際に失敗した操作とキーのポリシーを照合してください。キーの使用モデルが限定されている場合は、想定したエンドポイントがその制限に該当するか確認します。有効期限が切れている場合は、クレジットを追加せず認証情報を修正してください。クライアントが想定とは別のキーを送信している場合は、アカウントの権限を変える前に設定を直してください。
見落としやすい点として、ポリシーの作成方法があります。fal によると、プリセットキーは現在のプリセット定義に従いますが、カスタムポリシーには作成時の権限リストが保持されます。モデル制限を追加すると、キーはカスタムポリシーとして保存されます。[3] したがって、同じアプリケーション用に作られた2つのキーでも、権限が常に同一だと仮定せず、個別に調べる価値があります。
エラーが変わるか確認するだけのために、すべてのキーへフルアクセスを付与しないでください。アプリケーションに必要な操作を許可し、調査メモには変更前のポリシーを残してください。複数の変更を同時に行った後でリクエストが成功しても、どの変更が影響したのか分からなくなり、アプリケーションに必要な範囲を超えるアクセスを残す可能性があります。
同様に、キーの置き換えは文書化された汎用のアカウントロック解除操作ではありません。issue 922 では、新しいキーや SDK の更新後に成功したというユーザーもいれば、それらの手順は機能しなかったと述べたユーザーもいました。[1] これは個々の観察です。SDK のバージョン、キーの移行、ロック解除の遅延が、類似するすべてのメッセージの原因だとは証明していません。
2つのクライアントを比較するときは、まず想定するアカウント、モデル、操作を一致させてください。ノートパソコンからあるモデルへのリクエストが成功しても、定期実行ワーカーから別のモデルへアクセスできるとは確認できません。修正方法を選ぶ前に、残る違いを記録してください。そうしないと、モデルやアカウントの変更をクライアントライブラリの修正と誤認する可能性があります。
証拠がクライアントを指している場合は、インストール済みクライアントのバージョンとリクエストの組み立て方を確認してください。パッケージを変更する前に、サービスの完全な応答を保存してください。そうすれば、クライアント設定の修正と、プロバイダーの対応が必要なアカウント制限を区別できます。
ホスト型モデルと Serverless のデプロイでは確認点が異なる
fal のホスト型 Model API だけを呼び出す場合、インストールガイドによれば必要なのは API キーとクライアント SDK であり、Serverless CLI ではありません。独自の Serverless アプリをデプロイするにはアカウント承認が必要ですが、ホスト型 Model API の呼び出しにその承認は不要です。[4]
検索結果から CLI のインストールやチーム切り替えの手順に進んでしまう場合、これは重要です。そうした手順が、エラーを受け取った製品とプロセスに該当するか確認してください。CLI プロファイルが機能していても、別途デプロイした Web サービスがどの認証情報を使っているかは分かりません。
ブラウザーアプリケーションについて、fal はキーをサーバー側プロキシの背後に置くことを推奨しています。[2] シークレットをブラウザーのコードに入れても、アカウントロックの修復にはなりません。認証をサーバー側に保ったまま、プロキシが実際に使う認証情報と返されたエラーを確認してください。
調査に必要なアカウントと経過を一つずつサポートに伝える
原因不明のロックについて、メンテナーは該当アカウントと同じメールアドレスを使って fal のサポートに連絡するよう案内しています。ロックのケースは個別に処理され、公開 issue へのコメントではロックを解除できません。[1]
簡潔な非公開報告は、次の形式にできます。
アカウント:[該当アカウント]。[UTC 時刻] に、[操作とエンドポイント] が[サニタイズ済みの完全なエラー]を返しました。アプリケーションは[アカウントまたはチーム]に属する[安全な認証情報識別子]を使用しています。[キャプチャ時刻] に、そのアカウントには[残高]が表示されていました。該当する場合、購入[参照番号]は[時刻]に記録されています。リクエスト [ID] がある場合は、後のエラーより前に受理されました。ここに示したアカウント制限と操作を確認してください。
クライアント名とバージョンを追加し、すでに完了した確認事項を伝えてください。認証ヘッダー、API キー、不要な支払い情報は削除します。使用したキー、受け取った応答、表示された残高など、観察した事実を明確に述べてください。記録から確認できないデータベース障害や請求上の動機を決めつけないでください。
参考にする issue があれば、メンテナーの最新の返信を読んでください。別の報告である issue 1163 は、サポートが以前そのアカウントを解決済みだとメンテナーが述べた後に終了しました。[5] それはすべてのアカウントが修復済みだという証明にはなりません。同様に、元の報告も今なお障害が続いている証明にはなりません。どちらのスレッドからも、共通の待ち時間や返金の約束を推測することはできません。
サポートからアカウントのロックが解除されたと伝えられたら、失敗した操作に戻ってください。受理済みのジョブに続いてポーリングが拒否されたという仮のケースでは、まず既存のリクエストを確認してください。アクセスが復旧すると状態を取得できる可能性がありますが、生成自体の成功が保証されるわけではありません。新しい応答を先のロックメッセージと一緒に保存してください。同じ操作が引き続き失敗する場合は、更新された時刻と応答を既存のサポート会話に送り、現在のアカウント状態について審査してもらいましょう。
アクセスが戻ったら、再開する前に一時停止した作業を確認してください。拒否された送信と、すでに ID を受け取ったジョブを区別し、後者を作り直す前に確認します。アクセス復旧のテストに使う生成は、受理された場合に課金される可能性があります。この記事ではそのようなテストを実行していません。修正後のアカウントと認証情報を記録したうえで、引き続き実行したい作業だけを再開してください。
ワークロードを移す場合もこの確認を続ける
このロックをきっかけに別のプロバイダーを検討する場合は、認証情報の問題と残高の問題が区別されているかを確認してください。reAPI では、無効なキーは HTTP 401 とコード 10003、失効したキーは 10004、クレジット不足は HTTP 402 とコード 30001 を返します。[6] ワーカーは GET /api/v1/balance で、生成を開始せずに自分のキーが属するアカウントの残高を確認できます。[7]
明確なエラーコードがあっても、上記の習慣は省けません。完全なレスポンス、発生時刻、失敗した操作を記録し、クレジットを追加する前に、デプロイされたキーがどのアカウントのものかを確認してください。
参考資料
- fal-ai/fal. Issue 922:残高が正でもアカウントがロックされる件、メンテナーの案内を含む全スレッド。2026年11月15日取得。
- fal. Model API FAQ。2026年11月15日取得。
- fal. キー認証:権限、許可モデル、有効期限。2026年11月15日取得。
- fal. インストールと設定:Model API と Serverless のアクセス。2026年11月15日取得。
- fal-ai/fal. Issue 1163:残高が正なのに残高枯渇でアカウントが再ロックされる件、メンテナーによる解決を含む。2026年11月15日取得。
- reAPI。*エラー。*2026年11月17日確認。エラーコード。
- reAPI。*残高。*2026年11月17日確認。残高リファレンス。