跳到主要内容
smallPict
免费开始
首页框架集成Python & Django 软件包

面向 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
    }

集成接入步骤

  1. pip install smallpict

    从 PyPI 安装官方包 pip install smallpict。

  2. 初始化客户端

    同步应用使用 SmallPictClient,ASGI 框架使用 AsyncSmallPictClient。

  3. 接入上传处理器

    使用 client.optimize() 包装 Django FileField 或 FastAPI 文件流。

核心优势与收益

  • 基于 httpx 连接复用的原生 asyncio 支持
  • Django 模型字段深度集成(SmallPictImageField)
  • 提供用于 Celery 与 RQ 批量队列执行的任务装饰器
  • 基于 Pydantic 模型的完整类型支持

需要完整的开发指南与 API 规范?

在官方 Python & Django 软件包 开发者指南中查阅完整的参数参考、鉴权机制、错误码说明及本地调试教程。

查阅 Python & Django 软件包 完整文档

加速您的 Python & Django 软件包 图片处理流程

在您的应用中试用 AVIF 与 WebP 图片优化。无入网费,立即获取沙箱密钥。