PyPI 發佈

image2url for Python — 上傳圖片,取得永久連結

Image2URL 官方 PyPI 套件。讓上傳留在伺服端,內建大小驗證,回傳可直接用的 CDN 連結與結構化 JSON,方便日誌、筆記本與 CI 腳本。

快取策略

public, max-age=31536000

驗證

MIME + 大小防護

格式

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

版本時程

今天

PyPI 發佈

image2url 0.1.0 發佈到 PyPI,包含型別化用戶端、CLI 入口、大小防護與環境變數配置的端點。

已發佈

本週

文件與範例

補充 FastAPI、Flask、Django 範例片段,完善 README 與型別提示。

進行中

即將推出

簽名上傳

可選的簽名上傳與斷點續傳,支援更大檔案。

計劃中

即將推出

圖片轉換

轉換(調整尺寸/格式)搭配 CDN 快取標頭,生成可重現的 URL。

計劃中

即將推出

可觀測性鉤子

更清晰的錯誤碼與重試指引,方便 CI/CD 觀測。

計劃中

預設安全

HTTPS 上傳、MIME 驗證、大小限制、檔名編碼,快取標頭為 CDN 調校。

型別化且簡單

精簡 API:upload_image({ file, filename? })。結構化 JSON,方便日誌與看板。

開放路線圖

一起完善簽名上傳、轉換、可觀測性鉤子、框架預設;歡迎 Issue 與 PR。

開源邀請

加入 image2url-pypi 專案

分享真實場景,完善文件、補測試、提新功能(簽名上傳、轉換等)。

FAQ

什麼是 image2url(PyPI)?

輕量的 Python 用戶端與 CLI,把圖片傳到 image2url 端點,回傳可用作 CDN 的連結與中繼資料。

如何安裝?

執行 pip install image2url。CLI 入口:image2url path/to/file.png。

需要 API Key 嗎?

image2url.com 的預設端點提供基於 IP 的免費額度,也可透過 IMAGE2URL_ENDPOINT 指向自有部署。

是開源的嗎?

是的,歡迎在 github.com/image2url/image2url-pypi 貢獻 Issue 與 PR。

會回傳什麼?

回傳永久 URL,以及 filename、mimeType、size、uploadedAt 等結構化 JSON,方便記錄。

可靠性如何保障?

HTTPS 上傳、大小上限、MIME 驗證、快取標頭,以及明確錯誤,方便排查。

Image2URL PyPI SDK | Python 用戶端與 CLI,秒傳圖片