官方原生集成与 SDK
面向 FastAPI、Django 和 Flask 的异步图片处理
基于 httpx 和 Pillow 回退的现代化异步 Python 客户端。轻松在 Django 模型、FastAPI 接口或 Celery / RQ 任务中优化图片。
安装命令:
PYTHON 软件包pip install smallpict代码接入示例
python# FastAPI / Async Python Example
from fastapi import FastAPI, UploadFile, File
from smallpict import AsyncSmallPictClient, ImageFormat
app = FastAPI()
client = AsyncSmallPictClient(api_key="sp_live_key_xxxxx")
@app.post("/api/upload")
async def upload_image(file: UploadFile = File(...)):
image_bytes = await file.read()
result = await client.optimize(
image_bytes,
format=ImageFormat.AVIF,
quality=80,
max_width=1400
)
return {
"cdn_url": result.cdn_url,
"savings": f"{result.savings_percentage}%",
"original_size": result.original_size,
"optimized_size": result.new_size
}集成接入步骤
11. pip install smallpict
从 PyPI 安装官方包 pip install smallpict。
22. 初始化客户端
同步应用使用 SmallPictClient，ASGI 框架使用 AsyncSmallPictClient。
33. 接入上传处理器
使用 client.optimize() 包装 Django FileField 或 FastAPI 文件流。
核心优势与收益
- 基于 httpx 连接复用的原生 asyncio 支持
- Django 模型字段深度集成（SmallPictImageField）
- 提供用于 Celery 与 RQ 批量队列执行的任务装饰器
- 基于 Pydantic 模型的完整类型支持
官方开发者技术文档
需要完整的开发指南与 API 规范？
在官方 Python & Django 软件包 开发者指南中查阅完整的参数参考、鉴权机制、错误码说明及本地调试教程。
全面加速您的 Python & Django 软件包 图像管线
在您的应用中体验低于 50 毫秒的极速 AVIF 与 WebP 转换。零入网费，即刻获取沙箱 API Key，支持弹性扩展。