PyPI 发布

image2url for Python — 上传图片，获取永久链接

Image2URL 官方 PyPI 包。让上传留在服务端，内置大小校验，返回可直接用的 CDN 链接与结构化 JSON，方便日志、笔记本与 CI 脚本。

查看 PyPI 在 GitHub 参与

缓存策略

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 项目

分享真实场景，完善文档、补测、提新功能（签名上传、变换等）。

查看仓库从 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，以及文件名、mimeType、大小、uploadedAt 等结构化 JSON，便于记录。

可靠性如何保证？

HTTPS 上传、大小上限、MIME 校验、缓存头，以及明确的错误信息，便于排查。