공식 연동 및 SDK
Ruby on Rails 및 ActiveStorage를 위한 손쉬운 이미지 처리
공식 Gem으로 Rails 이미지 업로드를 가속화하세요. ActiveStorage 변형 및 Sidekiq 백그라운드 작업과 자연스럽게 연동됩니다.
설치:
RUBY 패키지gem install smallpict-ruby구현 예제
ruby# Gemfile
gem 'smallpict-ruby'
# config/initializers/smallpict.rb
SmallPict.configure do |config|
config.api_key = ENV['SMALLPICT_API_KEY']
config.auto_format = :auto # Selects AVIF or WebP based on client
config.quality = 82
end
# In your Controller / Service:
optimized_url = SmallPict.optimize(
user.avatar.url,
width: 400,
format: :avif
)연동 단계
11. Gemfile에 추가
Gemfile에 gem 'smallpict'를 추가하고 bundle install을 실행합니다.
22. 초기화 파일 설정
config/initializers/smallpict.rb에 API 키와 기본 포맷을 설정합니다.
33. 첨부 파일 최적화
클라우드 저장 전 ActiveStorage 첨부 파일에 smallpict_optimize를 호출합니다.
핵심 장점
- 복잡한 설정 없는 네이티브 ActiveStorage 통합
- Sidekiq 및 GoodJob 백그라운드 워커 어댑터 제공
- 일시적 네트워크 장애 시의 안전한 자동 폴백 메커니즘
- 최신 포맷과 함께 원본 마스터 파일을 안전하게 동시 보관
공식 개발자 문서
상세 구현 가이드와 API 규격이 필요하신가요?
공식 Ruby & Rails Gem 가이드에서 파라미터 규격, 인증, 에러 코드, 로컬 테스트 방법을 확인하세요.
Ruby & Rails Gem 이미지 파이프라인 성능 극대화
애플리케이션에서 50ms 미만의 초고속 AVIF 및 WebP 최적화를 경험하세요. 설치 비용 없이 샌드박스 키를 즉시 발급합니다.