PyPI 發佈
Image2URL 官方 PyPI 套件。讓上傳留在伺服端,內建大小驗證,回傳可直接用的 CDN 連結與結構化 JSON,方便日誌、筆記本與 CI 腳本。
快取策略
public, max-age=31536000
驗證
MIME + 大小防護
格式
URL + metadata JSON
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)?
輕量的 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 驗證、快取標頭,以及明確錯誤,方便排查。