WaveSpeedAI

fal.ai 'User is locked' (Admin lock, Exhausted balance): Arti dan Apa yang Harus Dilakukan

Kunci fal.ai Anda mengembalikan 403 'User is locked. Reason: Admin lock' atau 'Exhausted balance'. Arti dari masing-masing alasan, cara agar akun dibuka kembali, dan cara menjaga aplikasi Anda tetap berjalan selama menunggu.

By WaveSpeedAI10 min read

Jika permintaan fal.ai Anda tiba-tiba gagal dengan 403 dan isi responsnya berbunyi User is locked, blokirnya ada pada akun Anda, bukan pada permintaan Anda. Mencoba ulang tidak akan membukanya, dan menurut sebagian besar laporan, kunci API baru juga tidak membukanya. Langkah selanjutnya bergantung pada alasan di dalam pesan: Exhausted balance adalah kunci penagihan yang seharusnya terbuka setelah top-up, sedangkan Admin lock adalah kunci yang dipasang di sisi fal dan hanya bisa dilepas oleh dukungan fal.

Panduan ini menjelaskan arti setiap alasan, urutan langkah yang paling cepat membuka kembali akun, dan cara menjaga produk Anda tetap berjalan selama menunggu.

Sumber diperiksa pada 22 November 2026: dokumentasi fal dan issue tracker publik repositori fal-ai/fal di GitHub.

Seperti apa tampilan errornya

API menjawab dengan HTTP 403 dan string detail. Berikut tiga varian yang muncul dalam laporan publik:

{"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."}
Alasan dalam pesanArtinyaSiapa yang bisa membukanya
Exhausted balanceKunci penagihan. FAQ fal menyatakan: “When your credit balance drops below your account’s lock threshold, your account is locked and API requests will be rejected.”Anda, dengan menambah kredit. Jika tetap terkunci setelah top-up, dukungan fal.
TOP_UPTidak dijelaskan dalam dokumentasi fal. Dalam laporan, alasan ini muncul bersama pesan Exhausted balance pada akun yang sama, jadi anggap sebagai kunci penagihan yang sama.Sama seperti di atas.
Admin lockKunci yang dipasang di sisi fal. Pesannya sendiri meminta Anda menghubungi dukungan. fal tidak mempublikasikan kriterianya.Hanya dukungan fal.

Ada dua hal yang perlu diketahui sebelum Anda mulai:

  • FAQ tersebut menyebut ambang kunci, bukan nol. Dasbor yang masih menunjukkan beberapa dolar tidak membuktikan bahwa Anda berada di atas ambang untuk akun Anda.
  • FAQ yang sama menyatakan bahwa pelanggan enterprise dengan penagihan berbasis faktur “are not subject to automatic locking”. Jika layanan tanpa gangguan lebih penting daripada fleksibilitas bayar sesuai pemakaian, itulah paket yang perlu Anda tanyakan ke fal.

403 yang berbeda: “Access denied”

Tidak semua 403 dari fal adalah kunci akun. Jika isi responsnya menyatakan akses ditolak atau Anda tidak punya izin untuk menggunakan suatu endpoint, dan tidak ada teks User is locked, berarti akunnya terbuka tetapi kunci atau endpoint ini tidak diizinkan. Dokumentasi autentikasi fal mengaitkan 403 semacam ini dengan preset izin pada kunci API. Periksa kunci mana yang dipakai layanan yang gagal dan dengan preset apa kunci itu dibuat. Jika tidak ada yang berubah di sisi Anda dan seluruh keluarga endpoint mulai menolak kunci yang kemarin masih berfungsi, itu pertanyaan untuk dukungan fal, lengkap dengan id endpoint dan seluruh isi error.

Anda bukan satu-satunya

Issue tracker fal-ai/fal memuat lebih dari 25 issue tentang akun terkunci yang dibuka antara Maret dan November 2026. Issue-issue itu terbagi menjadi dua kelompok.

Terkunci padahal saldo positif. Pengguna melaporkan kunci Exhausted balance saat dasbor menunjukkan adanya kredit, misalnya #922, #1112, #1163, dan #1269. Pada #1163, pelapor menulis bahwa akunnya terkunci lagi beberapa menit setelah dibuka secara manual.

Admin lock tak lama setelah top-up. Beberapa laporan menggambarkan akun baru atau akun yang jarang dipakai terkena admin lock tepat setelah pembayaran pertamanya, misalnya #1183, #1248, #1254, dan #1281. Laporan lain, #1061, berasal dari seorang pengembang yang pemakaiannya melonjak saat pengujian end-to-end sebelum peluncuran.

Agar adil bagi fal: ini adalah laporan individual, bukan ukuran seberapa sering hal ini terjadi, dan di dalam thread tersebut staf fal mengonfirmasi bahwa akun-akun itu dibuka oleh dukungan. Pelapor #1281 dibuka sehari setelah mengirim email. Pelapor lain mengatakan harus menunggu beberapa hari untuk balasan pertama. Staf juga menyatakan di thread-thread itu bahwa GitHub tidak dipantau untuk dukungan akun.

Cara agar akun dibuka, berurutan

1. Baca alasannya dan berhenti mencoba ulang

Catat seluruh isi 403. Akun yang terkunci bukan kegagalan sementara, jadi keluarkan dari jalur retry Anda. Mencoba ulang pada akun terkunci hanya memenuhi antrean Anda dan menunda peringatan bahwa seseorang perlu bertindak.

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:
        # Tidak bisa dicoba ulang: beri tahu manusia dan beralih ke penyedia cadangan.
        raise AccountLocked(resp.json().get("detail", resp.text))
    resp.raise_for_status()

2. Periksa penagihan lebih dulu

Buka dasbor penagihan dan pastikan tiga hal: saldo kredit, tidak ada faktur yang belum dibayar, dan metode pembayaran masih valid. Jika alasannya Exhausted balance atau TOP_UP, tambahkan kredit. Lalu kirim satu permintaan uji beberapa menit kemudian.

3. Kirim email ke dukungan dari alamat akun

Jika alasannya Admin lock, atau kunci penagihan bertahan setelah top-up, satu-satunya saluran yang disebut fal adalah support@fal.ai, dan staf meminta Anda menulis dari alamat email akun yang terkunci. Sertakan semua yang mereka butuhkan di pesan pertama agar tidak ada bolak-balik yang sia-sia:

  • Email akun dan, jika Anda memakainya, nama tim.
  • String detail yang persis sama dan waktu permintaan pertama yang gagal.
  • Nomor tanda terima atau faktur dari top-up terakhir Anda.
  • Satu atau dua kalimat tentang apa yang dilakukan produk Anda dan mengapa pemakaian berubah, jika memang berubah (peluncuran, uji beban, fitur baru).

4. Hal-hal yang tidak membantu

  • Mengganti kunci API. Kuncinya ada pada akun. Pelapor yang membuat kunci baru mendapat 403 yang sama.
  • Membuka akun kedua. Jika kunci itu berasal dari tinjauan pembayaran atau risiko, akun duplikat dengan kartu yang sama biasanya membuat tinjauan lebih lambat, bukan lebih cepat.
  • Mengirim email yang sama setiap hari. Balaslah di thread yang sudah ada agar riwayatnya tetap dalam satu tiket.
  • Membuat issue GitHub sebagai ganti email. Cara ini bisa menambah visibilitas, tetapi staf menutup issue semacam ini dan mengarahkan ke email.

Jika Anda sebuah tim: satu akun, bukan satu akun per orang

Pola yang muncul dalam pertanyaan komunitas adalah perusahaan yang memberi tiap karyawan akun pribadi dan mendanai semuanya dengan kartu yang sama. Banyak akun baru yang dibayar dari satu kartu persis jenis pola yang dirancang untuk dideteksi oleh sistem risiko pembayaran, di platform mana pun. Cara yang didokumentasikan fal untuk ini adalah tim: ruang kerja bersama dengan penagihan sendiri, di mana “API keys belong to the team, not to individual members” dan admin mengundang anggota lewat email, atau lewat CSV untuk kelompok yang lebih besar. Jika akun Anda sudah terkunci karena cara ini, sampaikan dengan jelas dalam email ke dukungan dan minta untuk digabungkan ke satu tim.

Jaga produk Anda tetap berjalan selama menunggu

Kunci akun adalah satu-satunya kegagalan yang tidak bisa diatasi oleh retry, backoff, maupun kunci API kedua. Jika pelanggan berbayar bergantung pada pipeline generasi Anda, perlindungan praktisnya adalah platform kedua yang menyediakan keluarga model yang sama, sudah terintegrasi dan sudah terisi saldo, yang bisa Anda alihkan dengan satu flag konfigurasi.

Beberapa aturan membuat perawatannya murah:

  • Simpan pilihan model di balik antarmuka Anda sendiri, sehingga pemanggil meminta “text to image, 1024 × 1024” dan bukan URL vendor.
  • Klasifikasikan error tingkat akun (terkunci, ditangguhkan, kredit habis) secara terpisah dari error tingkat permintaan, dan lakukan failover hanya untuk jenis yang pertama.
  • Kirim sebagian kecil lalu lintas nyata melalui cadangan setiap hari. Cadangan yang sebulan tidak dipanggil cenderung rusak justru saat Anda membutuhkannya.

Menggunakan WaveSpeedAI sebagai platform kedua

WaveSpeedAI adalah API bayar sesuai pemakaian untuk model gambar, video, audio, dan 3D. Katalog model-nya mencakup keluarga model yang paling banyak dipakai proyek fal, termasuk Seedance, Kling, Wan, Veo, FLUX, Seedream, dan GPT Image. Poin-poin yang penting untuk masalah ini:

  • Kredit diperiksa pada setiap permintaan. Permintaan diterima ketika akun memiliki cukup kredit untuknya. Setelah Anda top-up, permintaan berikutnya langsung berjalan; tidak ada langkah pembukaan kunci terpisah yang harus ditunggu.
  • Pesan yang jelas saat kredit habis. API mengembalikan Insufficient credits. Please top up your account to continue, sehingga kode Anda dapat membedakan masalah penagihan dari kegagalan model.
  • Top-up otomatis. Anda dapat membiarkan akun mengisi ulang sendiri ketika di bawah saldo yang Anda tentukan, yang menghilangkan penyebab paling umum dari gangguan pukul 3 pagi.
  • Opsi pembayaran. Kartu, PayPal, Alipay, dan WeChat Pay.
  • Anggota tim dalam satu akun. Undang rekan tim dari dasbor agar semua orang bekerja dari saldo yang sama, bukan akun pribadi yang terpisah.
  • Harga ditampilkan sebelum Anda menjalankan. Setiap halaman model menampilkan biaya permintaan yang Anda konfigurasikan.

Seperti platform lainnya, WaveSpeedAI memiliki ketentuan penggunaan dan aturan konten, jadi bacalah sebelum Anda memindahkan lalu lintas produksi.

Seperti apa sebuah permintaan

Kirim sebuah tugas, lalu ambil hasilnya dengan id yang dikembalikan. Contoh ini memakai model text-to-image yang cepat; setiap model di katalog mengikuti dua panggilan yang sama.

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"

Panggilan pertama mengembalikan data.id. Panggilan kedua mengembalikan data.status (created, processing, completed, atau failed) dan, saat selesai, URL file di data.outputs.

Pemetaan dari fal

Di falDi WaveSpeedAI
Kirim ke endpoint antrean sebuah modelPOST https://api.wavespeed.ai/api/v3/<model path>
Polling status permintaan, lalu ambil hasilnyaGET https://api.wavespeed.ai/api/v3/predictions/<id>/result
Header Authorization: Key ...Header Authorization: Bearer ...
Webhook saat selesaiDidukung; lihat dokumentasi
Klien Python dan JavaScriptSDK Python dan JavaScript, serta REST biasa

Nama input berbeda antarplatform untuk beberapa model, jadi periksa daftar parameter di setiap halaman model alih-alih menyalin payload begitu saja.

Jika Anda lebih suka mencoba di browser sebelum menulis kode, generator gambar dan generator video menjalankan model yang sama dengan API.

FAQ

Apa arti “User is locked. Reason: Admin lock” di fal.ai?

Artinya akun dikunci di sisi fal, bukan oleh pemeriksaan saldo otomatis. Pesan itu meminta Anda menghubungi support@fal.ai. Menambah kredit atau membuat kunci baru tidak membukanya; dukungan fal yang harus melakukannya.

Mengapa akun fal saya terkunci dengan “Exhausted balance” padahal saya masih punya kredit?

FAQ fal menyatakan bahwa kunci aktif ketika saldo turun di bawah ambang kunci yang spesifik per akun, yang belum tentu nol. Selain itu, sejumlah laporan publik menggambarkan kunci yang tetap ada setelah top-up berhasil, dan dalam kasus-kasus tersebut dukungan membukanya secara manual. Lakukan top-up, tunggu beberapa menit, uji sekali, lalu kirim email ke dukungan.

Berapa lama fal membuka kembali sebuah akun?

Tidak ada waktu yang dipublikasikan. Dalam thread publik, sebagian pengguna dibuka dalam sehari setelah mengirim email, sementara yang lain melaporkan menunggu beberapa hari untuk balasan pertama. Rencanakan untuk kasus yang lebih lama.

Mengapa fal mengembalikan “Access denied” atau “You do not have permission to use this endpoint”?

Itu error izin, bukan kunci akun. Periksa preset izin pada kunci API yang dipakai permintaan tersebut. Jika kunci dan kode Anda tidak berubah, kirimkan id endpoint dan isi error ke dukungan fal.

Apakah beberapa akun fal dengan satu kartu bisa terkunci?

fal tidak mempublikasikan aturan risikonya. Banyak akun yang didanai satu kartu adalah pemicu umum pemeriksaan risiko pembayaran secara umum, dan fal menyediakan tim untuk berbagi satu akun penagihan antarorang, jadi gunakan tim.

Apakah kunci API baru atau akun baru akan menyelesaikannya?

Kunci baru tidak, karena kuncinya ada pada akun. Akun baru adalah ide yang buruk selama akun pertama masih dalam tinjauan.

Bagaimana cara menghindari downtime akibat kunci akun di platform mana pun?

Pertahankan penyedia kedua yang sudah terintegrasi dan terisi saldo, perlakukan error tingkat akun sebagai tidak dapat dicoba ulang, dan lakukan failover otomatis saat error itu muncul. Aktifkan top-up otomatis jika platform menyediakannya agar saldo rendah tidak pernah berubah menjadi kunci.

Bagikan