fal.ai Python client
This is a Python client library for interacting with ML models deployed on fal.ai.
Getting started
To install the client, run:
pip install fal-client
To use the client, you need to have an API key. You can get one by signing up at fal.ai. Once you have it, set it as an environment variable:
export FAL_KEY=your-api-key
Now you can use the client to interact with your models. Here's an example of how to use it:
import fal_client
response = fal_client.run("fal-ai/fast-sdxl", arguments={"prompt": "a cute cat, realistic, orange"})
print(response["images"][0]["url"])
Asynchronous requests
The client also supports asynchronous requests out of the box. Here's an example:
import asyncio
import fal_client
async def main():
response = await fal_client.run_async("fal-ai/fast-sdxl", arguments={"prompt": "a cute cat, realistic, orange"})
print(response["images"][0]["url"])
asyncio.run(main())
Uploading files
If the model requires files as input, you can upload them directly to fal's CDN and pass the URLs to the client. Here's an example:
import fal_client
audio_url = fal_client.upload_file("path/to/audio.wav")
response = fal_client.run("fal-ai/whisper", arguments={"audio_url": audio_url})
print(response["text"])
Encoding files as in-memory data URLs
If you don't want to upload your file to our CDN service (for latency reasons, for example), you can encode it as a data URL and pass it directly to the client. Here's an example:
import fal_client
audio_data_url = fal_client.encode_file("path/to/audio.wav")
response = fal_client.run("fal-ai/whisper", arguments={"audio_url": audio_data_url})
print(response["text"])
Queuing requests
When you want to send a request and keep receiving updates on its status, you can use the submit method. Here's an example:
import asyncio
import fal_client
async def main():
response = await fal_client.submit_async("fal-ai/fast-sdxl", arguments={"prompt": "a cute cat, realistic, orange"})
logs_index = 0
async for event in response.iter_events(with_logs=True):
if isinstance(event, fal_client.Queued):
print("Queued. Position:", event.position)
elif isinstance(event, (fal_client.InProgress, fal_client.Completed)):
new_logs = event.logs[logs_index:]
for log in new_logs:
print(log["message"])
logs_index = len(event.logs)
result = await response.get()
print(result["images"][0]["url"])
asyncio.run(main())
Release files for fal-client 1.0.2
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| fal_client-1.0.2.tar.gz | 43.9 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| fal_client-1.0.2-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 70.8 kB
Release files / fal_client-1.0.2.tar.gz
| Download URL | fal_client-1.0.2.tar.gz |
|---|---|
| Size | 43.9 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
3f72996e5b71aa32e3a301434c83f9b15547008314953dd934596017b3146166
|
|
BLAKE2b-256 checksum How to use checksums |
5d36dbfeb84b046cea1a7b1b5ed4518cef2b77408fe441685240b840eb29dec1
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.13
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 17, 2026.
Transparency logRelease files / fal_client-1.0.2-py3-none-any.whl
| Download URL | fal_client-1.0.2-py3-none-any.whl |
|---|---|
| Size | 26.9 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
3f5705c073ded932bbdfa639f4cf61b2c8378da912c83b174acf3f4c6b49f9f3
|
|
BLAKE2b-256 checksum How to use checksums |
897e3762a05b63a9af3e2bd980bd82c137447969e82189da217616267a00aec7
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.13
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 17, 2026.
Transparency log
