fal.aiの「User is locked」(Admin lock、Exhausted balance):その意味と対処法
fal.aiのキーが403「User is locked. Reason: Admin lock」または「Exhausted balance」を返す場合の対処ガイド。各理由の意味、ロック解除の方法、その間もアプリを稼働させ続ける方法を解説します。
fal.ai へのリクエストが突然 403 で失敗し、レスポンス本文に User is locked と表示された場合、ブロックされているのはリクエストではなくアカウントです。再試行しても解除されません。報告の多くでは、新しい API キーを発行しても解除されません。次に取るべき対応は、メッセージ中の理由によって変わります。Exhausted balance は課金ロックで、チャージすれば解除されるはずのものです。Admin lock は fal 側でかけられたロックで、解除できるのは fal サポートだけです。
このガイドでは、各理由の意味、アカウントを最短で解除するための手順、解除を待つ間にプロダクトを稼働させ続ける方法を説明します。
情報源の確認日: 2026年11月22日。fal のドキュメントと、GitHub の fal-ai/fal リポジトリの公開 Issue トラッカーを確認しました。
エラーの見え方
API は HTTP 403 と detail 文字列を返します。公開されている報告に見られるバリエーションは次の3つです。
{"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_UP | fal のドキュメントには記載がありません。報告では同じアカウントで Exhausted balance のメッセージと並んで現れるため、同じ課金ロックとして扱ってください。 | 上記と同じ。 |
Admin lock | fal 側でかけられたロックです。メッセージ自体がサポートへの連絡を促しています。fal は判断基準を公開していません。 | fal サポートのみ。 |
始める前に知っておくべき点が2つあります。
- FAQ が述べているのは、ゼロではなくロックのしきい値です。ダッシュボードに数ドル残っていても、そのアカウントのしきい値を上回っている証拠にはなりません。
- 同じ FAQ には、請求書払いのエンタープライズ顧客は “are not subject to automatic locking” とも書かれています。従量課金の柔軟さよりもサービスの途切れなさを重視するなら、fal に問い合わせるべきプランはこれです。
別の 403:「Access denied」
fal が返す 403 がすべてアカウントロックとは限りません。本文にアクセス拒否やエンドポイントを使う権限がないという内容があり、User is locked の文言がない場合、アカウント自体は有効で、このキーまたはこのエンドポイントが許可されていないということです。fal の認証ドキュメントは、この種の 403 を API キーの権限プリセットと結び付けています。失敗しているサービスがどのキーを使っているか、そのキーがどのプリセットで作成されたかを確認してください。自分側に変更がないのに、昨日まで使えていたキーをあるエンドポイント群がまとめて拒否し始めた場合は、エンドポイント ID とエラー本文の全文を添えて fal サポートに問い合わせてください。
あなただけではありません
fal-ai/fal の Issue トラッカーには、2026年3月から11月にかけて開かれた、ロックされたアカウントに関する Issue が25件以上あります。大きく2つのグループに分かれます。
残高がプラスなのにロックされるケース。 ダッシュボードにクレジットが表示されているのに 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:
# 再試行不可: 担当者に通知し、フォールバックのプロバイダーに切り替える。
raise AccountLocked(resp.json().get("detail", resp.text))
resp.raise_for_status()
2. まず課金を確認する
課金ダッシュボードを開き、次の3点を確認してください。クレジット残高、未払いの請求書がないこと、支払い方法が有効であることです。理由が Exhausted balance または TOP_UP の場合は、クレジットを追加します。その数分後にテストリクエストを1回送ってください。
3. アカウントのアドレスからサポートにメールする
理由が Admin lock の場合、またはチャージ後も課金ロックが残る場合、fal が案内している唯一の窓口は support@fal.ai です。スタッフは、ロックされたアカウントのメールアドレスから送るよう求めています。やり取りの往復を無駄にしないよう、最初のメッセージに必要な情報をすべて入れてください。
- アカウントのメールアドレスと、チームを使っている場合はチーム名。
detail文字列の正確な内容と、最初に失敗したリクエストの時刻。- 直近のチャージの領収書または請求書番号。
- プロダクトが何をするものか、また利用状況が変わった場合はその理由(ローンチ、負荷テスト、新機能など)を1〜2文で。
4. 効果がないこと
- API キーのローテーション。 ロックはアカウントにかかっています。新しいキーを作成した報告者も、同じ 403 を受け取りました。
- 2つ目のアカウントを作る。 ロックが支払いまたはリスクの審査によるものなら、同じカードで重複アカウントを作ると、通常は審査が速くなるどころか遅くなります。
- 毎日同じメールを送り直す。 履歴を1つのチケットにまとめるため、既存のスレッドに返信してください。
- メールの代わりに GitHub Issue を立てる。 可視性は上がるかもしれませんが、スタッフはこれらをクローズしてメールへ誘導します。
チームの場合: 1人1アカウントではなく、1つのアカウントを
コミュニティの質問によく出てくるのは、会社が従業員ごとに個人アカウントを作り、すべて同じカードで入金するパターンです。同じカードから支払われる多数の新規アカウントは、どのプラットフォームでも、決済リスクシステムが検知するよう作られているものです。fal が文書化している方法はチームです。独自の課金を持つ共有ワークスペースで、“API keys belong to the team, not to individual members” とされ、管理者はメールで、人数が多い場合は CSV でメンバーを招待します。すでにこの形でアカウントがロックされている場合は、サポートへのメールでその旨を率直に伝え、1つのチームへの統合を依頼してください。
待っている間もプロダクトを稼働させ続ける
アカウントロックは、再試行もバックオフも2つ目の API キーも解決できない、ほぼ唯一の障害です。有料の顧客が生成パイプラインに依存しているなら、現実的な備えは、同じモデルファミリーを提供する第二のプラットフォームを、あらかじめ統合し、資金を入れておき、設定フラグで切り替えられるようにしておくことです。
次のルールを守ると、維持コストを抑えられます。
- モデルの選択は自社のインターフェースの内側に置いてください。呼び出し側はベンダーの URL ではなく、「text to image、1024 × 1024」を要求します。
- アカウントレベルのエラー(ロック、停止、クレジット切れ)を、リクエストレベルのエラーとは別に分類し、フェイルオーバーは前者に対してのみ行います。
- 実トラフィックの一部を、毎日フォールバック経由で流してください。1か月呼び出されていないフォールバックは、必要なときに壊れていがちです。
第二のプラットフォームとして 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 に対応しています。
- 1つのアカウントでチームメンバーを管理。 ダッシュボードからチームメイトを招待すれば、個人アカウントをバラバラに持つ代わりに、全員が同じ残高で作業できます。
- 実行前に価格を表示。 各モデルのページには、設定したリクエストのコストが表示されます。
他のプラットフォームと同様に、WaveSpeedAI にも利用規約とコンテンツルールがあります。本番トラフィックを移す前にお読みください。
リクエストの例
タスクを送信し、返された ID で結果を取得します。この例では高速な text-to-image モデルを使っています。カタログ内のどのモデルも、同じ2つの呼び出しで動きます。
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 を返します。2番目の呼び出しは data.status(created、processing、completed、failed のいずれか)を返し、完了時にはファイルの URL を data.outputs に含めます。
fal との対応表
| fal | WaveSpeedAI |
|---|---|
| モデルのキューエンドポイントに送信 | POST https://api.wavespeed.ai/api/v3/<model path> |
| リクエストのステータスをポーリングし、結果を取得 | GET https://api.wavespeed.ai/api/v3/predictions/<id>/result |
Authorization: Key ... ヘッダー | Authorization: Bearer ... ヘッダー |
| 完了時の Webhook | 対応しています。ドキュメントを参照してください |
| 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 によると、ロックは、残高がアカウントごとのロックしきい値を下回ったときに発動します。このしきい値は必ずしもゼロではありません。これとは別に、チャージに成功したあともロックが残ったという公開報告が複数あり、そのケースではサポートが手動で解除しました。チャージして数分待ち、1回テストしてから、サポートにメールしてください。
fal がアカウントを解除するまでどのくらいかかりますか?
公表された所要時間はありません。公開スレッドでは、メールから1日以内に解除された人もいれば、最初の返信まで数日待ったと報告する人もいます。長いほうのケースを想定して計画してください。
fal が「Access denied」や「You do not have permission to use this endpoint」を返すのはなぜですか?
それはアカウントロックではなく、権限エラーです。リクエストに使った API キーの権限プリセットを確認してください。キーとコードに変更がない場合は、エンドポイント ID とエラー本文を fal サポートに送ってください。
1枚のカードに紐づく複数の fal アカウントがロックされることはありますか?
fal はリスクルールを公開していません。1枚のカードで多数のアカウントに入金することは、一般に決済リスクチェックの典型的なトリガーです。また fal には、1つの課金アカウントを複数人で共有するためのチームがあるので、チームを使ってください。
新しい API キーや新しいアカウントで解決しますか?
新しいキーでは解決しません。ロックはアカウントにかかっているためです。最初のアカウントが審査中の間に新しいアカウントを作るのは、得策ではありません。
どのプラットフォームでも、アカウントロックによるダウンタイムを避けるにはどうすればよいですか?
第二のプロバイダーを統合し、資金を入れた状態で維持してください。アカウントレベルのエラーは再試行不可として扱い、自動でフェイルオーバーします。プラットフォームが自動チャージを提供している場合はそれをオンにして、残高の不足がそもそもロックにつながらないようにしてください。
/filters:quality(82)/media/images/1773962750383987480_n3hqzHRZ.webp)