Запуск на PyPI

image2url для Python — загружайте изображения и получайте постоянные URL

Официальный пакет Image2URL на PyPI. Держите загрузки на стороне сервера, применяйте лимиты размеров и возвращайте ссылки, готовые для CDN, с структурированным JSON для логов, ноутбуков и CI-скриптов.

Посмотреть на PyPI Внести вклад на GitHub

Политика кеша

public, max-age=31536000

Проверка

MIME + контроль размера

Форматы

URL + 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

План релизов

Сегодня

Запуск на PyPI

Выпустили image2url 0.1.0 в PyPI: типизированный клиент, CLI-эндпоинт, контроль размера и адреса через переменные окружения.

Выполнено

На этой неделе

Документация и примеры

Добавим больше готовых сниппетов для FastAPI, Flask и Django; улучшим README и подсказки типов.

В работе

Скоро

Подписанные загрузки

Опциональная поддержка подписанных и возобновляемых загрузок для крупных файлов.

Запланировано

Скоро

Трансформации

Преобразование изображений (resize/формат) с CDN-кешированием и детерминированными URL.

Запланировано

Скоро

Хуки телеметрии

Наблюдаемые коды ошибок и рекомендации по повтору для CI/CD-пайплайнов.

Запланировано

Безопасно по умолчанию

Загрузки по HTTPS, проверка MIME, лимиты размеров и кодирование имён файлов с заголовками кеша, настроенными под CDN.

Типизировано и просто

Минимальный API: upload_image({ file, filename? }). Структурированный JSON для логов и дашбордов.

Открытая дорожная карта

Помогите добавить подписанные загрузки, трансформации, хуки телеметрии и пресеты фреймворков. Issues и PR приветствуются.

Приглашение в open source

Присоединяйтесь к проекту image2url-pypi

Делитесь реальными кейсами, улучшайте документацию, добавляйте тесты и предлагайте фичи вроде подписанных загрузок и трансформаций.

Посмотреть репозиторий Установить из PyPI

FAQ

Что такое image2url (PyPI)?

Легкий Python-клиент и CLI, которые загружают изображения на endpoint image2url и возвращают CDN-готовые URL и метаданные.

Как установить?

Выполните pip install image2url. CLI: image2url path/to/file.png.

Нужны ли API-ключи?

Стандартный endpoint на image2url.com даёт бесплатную квоту по IP. Можно указать свой деплой через IMAGE2URL_ENDPOINT.

Это open source?

Да. Вносите вклад на GitHub: github.com/image2url/image2url-pypi. Issues и PR открыты.

Что я получу в ответ?

Постоянный URL плюс filename, mimeType, size, uploadedAt и структурированный JSON, пригодный для логирования.

Как обеспечивается надёжность?

Загрузки по HTTPS, лимиты размера, проверка MIME, заголовки кеша и явные ошибки для наблюдаемости.