본문으로 건너뛰기
smallPict
무료로 시작
홈연동 및 SDKRuby & Rails Gem

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
)

연동 단계

  1. Gemfile에 추가

    Gemfile에 gem 'smallpict'를 추가하고 bundle install을 실행합니다.

  2. 초기화 파일 설정

    config/initializers/smallpict.rb에 API 키와 기본 포맷을 설정합니다.

  3. 첨부 파일 최적화

    클라우드 저장 전 ActiveStorage 첨부 파일에 smallpict_optimize를 호출합니다.

핵심 장점

  • ActiveStorage와 함께 작동
  • Sidekiq 및 GoodJob 백그라운드 워커 어댑터 제공
  • 일시적 네트워크 장애 시의 안전한 자동 폴백 메커니즘
  • 최신 포맷과 함께 원본 마스터 파일을 안전하게 동시 보관

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

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

Ruby & Rails Gem 문서 읽기

Ruby & Rails Gem 이미지 파이프라인 속도 높이기

애플리케이션에서 AVIF 및 WebP 이미지 최적화를 사용해 보세요. 설치 비용 없이 샌드박스 키를 즉시 발급합니다.