uploadcenter

Official Python SDK for the UploadCenter API — presigned uploads, file processing, transforms, webhooks, and more, fully typed and generated from UploadCenter's OpenAPI schema.

Install

pip install uploadcenter

Usage

import httpx

from uploadcenter import create_client
from uploadcenter.generated.api.uploads import (
    complete_upload_endpoint_v1_uploads_complete_post as complete_upload,
)
from uploadcenter.generated.api.uploads import (
    presign_upload_endpoint_v1_uploads_presign_post as presign_upload,
)
from uploadcenter.generated.models import CompleteUploadRequest, PresignUploadRequest

client = create_client(
    base_url="https://api.uploadcenter.com",
    token="sk_live_...",  # an API key from your project settings
)

presigned = presign_upload.sync(
    client=client,
    body=PresignUploadRequest(
        project_id="project_...",
        filename="photo.jpg",
        size_bytes=len(file_bytes),
        mime_type="image/jpeg",
        visibility="private",
    ),
)

httpx.put(
    presigned.upload_url,
    content=file_bytes,
    headers={"Content-Type": "image/jpeg"},
)

complete_upload.sync(
    client=client,
    body=CompleteUploadRequest(file_id=presigned.file_id),
)

Async equivalents (presign_upload.asyncio, complete_upload.asyncio, ...) are available for every endpoint — use them with httpx.AsyncClient and await your own PUT request.

Every module under uploadcenter.generated.api.<group> mirrors an OpenAPI tag (uploads, files, folders, projects, organizations, api_keys, domains, webhooks, notifications, usage, billing, auth), and exposes four functions per endpoint: sync, sync_detailed, asyncio, asyncio_detailed. Request/response models live under uploadcenter.generated.models and mirror the OpenAPI schema directly.

License

MIT