SmallPict LogoSmallPict
공식 연동 및 SDK

FastAPI, Django 및 Flask를 위한 비동기 이미지 최적화

httpx와 Pillow 폴백을 갖춘 최신 비동기 Python 클라이언트. Django 모델, FastAPI 엔드포인트 또는 Celery / RQ 워커에서 간편하게 이미지를 처리하세요.

설치:pip install smallpict
PYTHON 패키지

구현 예제

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로 설치

PyPI에서 pip install smallpict로 공식 패키지를 설치합니다.

22. 클라이언트 초기화

동기 애플리케이션은 SmallPictClient, ASGI에는 AsyncSmallPictClient를 사용합니다.

33. 업로드 핸들러에 적용

Django FileField 또는 FastAPI 파일 스트림을 client.optimize()로 래핑합니다.

핵심 장점

  • httpx 연결 재사용을 통한 네이티브 asyncio 비동기 지원
  • Django 모델 필드 통합 (SmallPictImageField)
  • Celery 및 RQ 큐 실행을 위한 태스크 데코레이터 제공
  • Pydantic 기반의 완벽한 타입 힌트 지원
공식 개발자 문서

상세 구현 가이드와 API 규격이 필요하신가요?

공식 Python & Django 패키지 가이드에서 파라미터 규격, 인증, 에러 코드, 로컬 테스트 방법을 확인하세요.

Python & Django 패키지 문서 읽기

Python & Django 패키지 이미지 파이프라인 성능 극대화

애플리케이션에서 50ms 미만의 초고속 AVIF 및 WebP 최적화를 경험하세요. 설치 비용 없이 샌드박스 키를 즉시 발급합니다.