reupload-sdk 0.1.1

Official Python SDK for the Reupload public API

reupload-sdk

Official server-side Python SDK for the Reupload public API.

• Typed API aligned with @reupload/sdk (Node.js)
• Sync (Reupload) and async (AsyncReupload) clients via httpx
• CDN upload flow (session → PUT → complete) and server direct multipart upload
• Optional FastAPI route helpers

Install

pip install reupload-sdk

# FastAPI helpers
pip install "reupload-sdk[fastapi]"

Requires Python 3.10+.

Quick start

from reupload import create_reupload_from_env

client = create_reupload_from_env()
me = client.whoami()
print(me["projects"])

Environment variables

Variable	Required	Description
REUPLOAD_API_KEY	Yes	API key (ru_…)
REUPLOAD_PROJECT_ID	Yes	Default project UUID
REUPLOAD_API_BASE_URL	No	Default https://api.reupload.dev/api/v1

Manual client

from reupload import Reupload

client = Reupload(
    api_key="ru_…",
    default_project_id="your-project-uuid",
)

API overview

Method	Description
client.whoami()	Verify key and list projects
client.uploads.create_session()	Start CDN upload session
put_to_upload_url(url, body, content_type)	PUT bytes to signed CDN URL
client.uploads.complete()	Finalize CDN upload
client.uploads.upload()	Session + CDN PUT + complete
client.uploads.upload_direct()	Server multipart direct upload
client.uploads.upload_direct_batch()	Multiple files in one request
client.uploads.get_session()	Poll session status
client.uploads.wait_for_completion()	Poll until COMPLETED
client.files.get()	File metadata
client.files.access()	Signed download URL
client.files.delete()	Delete file

Use AsyncReupload and await for the same methods in async code.

CDN upload

from pathlib import Path

from reupload import Reupload, put_to_upload_url

client = Reupload(api_key="ru_…", default_project_id="…")
payload = Path("photo.jpg").read_bytes()

session = client.uploads.create_session(
    {
        "projectId": client.default_project_id,
        "filename": "photo.jpg",
        "contentType": "image/jpeg",
        "size": len(payload),
        "isPublic": True,
    },
)

put_to_upload_url(session["uploadUrl"], payload, "image/jpeg")
done = client.uploads.complete({"uploadId": session["uploadId"]})
print(done["fileId"])

Or the combined helper:

done = client.uploads.upload(
    {
        "projectId": client.default_project_id,
        "filename": "photo.jpg",
        "contentType": "image/jpeg",
        "size": len(payload),
        "file": {
            "data": payload,
            "filename": "photo.jpg",
            "contentType": "image/jpeg",
            "size": len(payload),
        },
    },
)

Direct upload

result = client.uploads.upload_direct(
    {
        "projectId": client.default_project_id,
        "isPublic": True,
        "file": {
            "data": payload,
            "filename": "photo.jpg",
            "contentType": "image/jpeg",
            "size": len(payload),
        },
    },
)

FastAPI

from fastapi import FastAPI
from reupload import create_async_reupload_from_env
from reupload.fastapi import create_async_fastapi_direct_upload_handler

app = FastAPI()
client = create_async_reupload_from_env()

@app.post("/api/upload")
async def upload(request):
    return await create_async_fastapi_direct_upload_handler(client=client)(request)

Or build the handler once:

upload_handler = create_async_fastapi_direct_upload_handler(client=client)

@app.post("/api/upload")
async def upload(request):
    return await upload_handler(request)

Accepts multipart fields: projectId, file, optional filename, optional isPublic.

Errors

from reupload import ReuploadError, is_reupload_error, is_reupload_cdn_error

try:
    client.files.get("…")
except ReuploadError as error:
    print(error.status, error.code, error.message)

Development

cd python-packages/reupload-sdk
python -m venv .venv && source .venv/bin/activate
pip install -e ".[dev]"
pytest
python -m build

License

MIT