PyPI launch

image2url for Python — upload images, get permanent URLs

The official PyPI package for Image2URL. Keep uploads server-side, enforce size caps, and return CDN-ready links with structured JSON for logs, notebooks, and CI scripts.

View on PyPI Contribute on GitHub

Cache policy

public, max-age=31536000

Validation

MIME + size guard

Formats

URL + metadata JSON

Python quick start

Type-safe responses

from image2url import upload_image, Image2URLClient

client = Image2URLClient(
    endpoint="https://www.image2url.com/api/upload",
    timeout=15,
    max_size_mb=2,
)

result = client.upload_image("logo.png", filename="brand-logo.png")
print(result.url)
print(result.raw)  # structured JSON with filename, size, mimeType, uploadedAt

Release timeline

Today

PyPI launch

Published image2url 0.1.0 to PyPI with typed client, CLI entrypoint, size guards, and env-driven endpoints.

Shipped

This week

Docs & samples

Add more copy-paste snippets for FastAPI, Flask, and Django; improve README and type hints.

In focus

Upcoming

Signed uploads

Optional signed upload support and resumable uploads for larger assets.

Planned

Upcoming

Transforms

Image transforms (resize/format) with CDN caching headers and deterministic URLs.

Planned

Upcoming

Telemetry hooks

Observable error codes and retry guidance for CI/CD pipelines.

Planned

Secure by default

HTTPS uploads, MIME validation, size caps, and filename encoding with cache headers tuned for CDNs.

Typed & simple

Minimal surface API: upload_image({ file, filename? }). Structured JSON for logs and dashboards.

Open roadmap

Help add signed uploads, transforms, telemetry hooks, and framework presets. Issues and PRs welcome.

Open source invitation

Join the image2url-pypi project

Share real-world patterns, improve docs, add tests, and propose features like signed uploads and transforms.

View repository Install from PyPI

FAQ

What is image2url (PyPI)?

A lightweight Python client and CLI that uploads images to the image2url endpoint and returns CDN-ready URLs plus metadata.

How do I install it?

Run pip install image2url. CLI entrypoint: image2url path/to/file.png.

Do I need API keys?

The default endpoint on image2url.com provides an IP-based free quota. You can point to your own deployment via IMAGE2URL_ENDPOINT.

Is it open source?

Yes. Contribute on GitHub at github.com/image2url/image2url-pypi. Issues and PRs are welcome.

What do I get back?

A permanent URL plus filename, mimeType, size, uploadedAt, and structured JSON suitable for logging.

How is reliability handled?

Uploads use HTTPS, size caps, MIME validation, cache headers, and explicit errors for observability.