Python SDK

官方 smallpict Python 包，深度支持 Django, FastAPI, Flask 与自动化数据处理流水线。

SmallPict 官方 Python SDK 原生支持同步与异步工作流，包含完整的 PEP 484 类型标注。

安装方式

Shell

pip install smallpict# 或使用 Poetrypoetry add smallpict

快速上手示例

Python

import osfrom smallpict import SmallPict
client = SmallPict(    api_key=os.environ["SMALLPICT_API_KEY"],    secret_key=os.environ["SMALLPICT_SECRET_KEY"],    max_retries=3)
# 1. 优化本地图片文件with open("banner.jpg", "rb") as f:    result = client.optimize(        source=f.read(),        format="avif",        quality=80,        strip_metadata=True    )
print(f"优化后 CDN 地址: {result.url}")print(f"节省比例: {result.savings_percentage}%")
# 2. 查询当期配额quota = client.get_quota()print(f"当前已用用量: {quota.bytes_used} 字节")