image2url (PyPI)
轻量级 Python SDK + CLI，用来把本地图片上传到 image2url API，返回一个可长期访问的公开 URL。默认指向 https://www.image2url.com/api/upload，也可通过环境变量切换到你自己的部署。
功能
- 上传本地图片并返回永久 URL
- 内置 2MB 体积校验（与默认 API 对齐，可自定义）
- 自定义上传地址、超时时间与文件名
- CLI 一键上传，或在 Python 代码中调用
安装
# 发布后
pip install image2url
# 本地开发/调试
pip install -e .[dev]
Python 快速开始
from image2url import Image2URLClient, upload_image
# 方式 1：直接用便捷函数
result = upload_image("avatar.png")
print(result.url)
# 方式 2：自定义客户端
client = Image2URLClient(
endpoint="https://www.image2url.com/api/upload",
timeout=15,
max_size_mb=2,
)
result = client.upload_image("avatar.png", filename="profile.png")
print(result.url)
CLI 用法
# 最简单用法
image2url ./avatar.png
# 自定义地址、超时并输出完整 JSON
IMAGE2URL_ENDPOINT=https://your-domain.com/api/upload \
image2url ./avatar.png --timeout 30 --json
配置
IMAGE2URL_ENDPOINT：自定义上传地址（默认https://www.image2url.com/api/upload）IMAGE2URL_TIMEOUT：请求超时秒数（默认 15）max_size_mb：初始化客户端时自定义体积限制（默认 2MB）
本地开发
pip install -e .[dev]
python -m pytest
返回示例
{
"success": true,
"url": "https://www.image2url.com/images/1733090000-uuid.png",
"filename": "images/1733090000-uuid.png",
"originalName": "avatar.png",
"size": 102400,
"type": "image/png",
"uploadedAt": "2024-12-02T00:00:00.000Z"
}
1 maintainer
Metadata
1 maintainer
Release files for image2url 0.1.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| image2url-0.1.0.tar.gz | 16.7 kB | Without provenance | Details for image2url-0.1.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| image2url-0.1.0-py3-none-any.whl | Python 3 | none | any | Details for image2url-0.1.0-py3-none-any.whl |
Total release size: 22.4 kB
Release files / image2url-0.1.0.tar.gz
| Download URL | image2url-0.1.0.tar.gz |
|---|---|
| Size | 16.7 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
5d40a0f5c3c3598c3f141912ae65469c2116a62baff95c9fb2d7864dd11608bd
|
|
BLAKE2b-256 checksum How to use checksums |
8483bbfb3e2ad50e1a212fe98b319e95199d79f782383dd7bdc4bb9f5bc15075
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.12.4
|
Release files / image2url-0.1.0-py3-none-any.whl
| Download URL | image2url-0.1.0-py3-none-any.whl |
|---|---|
| Size | 5.7 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
a1056a0602b23ddb4a99452e9246cd29d6915006d90450b6005d51f44895bd3b
|
|
BLAKE2b-256 checksum How to use checksums |
0dae72d916b6c223b8e841180e151ce9fad1d6bdea3e98f87ed89bab539e3fc8
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.12.4
|
Security for image2url 0.1.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.
