flyewin

Official Python client for the flye.win APIs. No dependencies, Python 3.8+.

pip install flyewin

from flyewin import Flye

flye = Flye()  # reads FLYE_API_KEY, or Flye("flye_sk_...")

print(flye.utils.uuid(count=2))

Test keys

Keys that start with flye_test_ answer with the documented examples, need no plan and use no quota (30 requests/minute, 1,000/day). Use them while building and in CI, then switch to a flye_sk_ key. Create both at https://flye.win/dashboard/keys.

Errors

Every failure raises FlyeError with a stable code:

from flyewin import Flye, FlyeError

try:
    flye.utils.hash(text="hi")
except FlyeError as err:
    if err.code == "rate_limited":
        ...  # err.status == 429

Network errors and 5xx on GET requests are retried twice with backoff, and so is a 429 with a short Retry-After. Change it with Flye(max_retries=0).

Rate limit and quota headers of the last call are in flye.last_response.headers (x-ratelimit-remaining, x-quota-remaining).

Options

Flye(api_key=None, *, base_url="https://flye.win/v1", timeout=30.0, max_retries=2)

Every method also takes timeout= for that call.

Methods

Stickers — flye.stickers

Search stickers and animated GIFs, with ready-to-use links. Docs: https://flye.win/apis/stickers

CDN — flye.cdn

Image hosting with public links, organized in projects and folders. Docs: https://flye.win/apis/cdn

Utils — flye.utils

UUIDs, hashes, base64 and IP inspection in one call. Docs: https://flye.win/apis/utils

Uploads take bytes, an open binary file, a path, or (filename, bytes).

Full reference and the OpenAPI spec: https://flye.win/docs · https://flye.win/openapi.json