Dokumentasyon ng API

Image Optimizer

I-convert ang mga larawan sa WebP & AVIF na may hanggang 80% na pagbawas sa laki ng file. Kumpletong REST API, WordPress plugin, at pandaigdigang paghahatid ng CDN.

80%

Karaniwang Pagtitipid

50ms

Oras ng Pagtugon

20+

Mga Lokasyon ng CDN

99.9%

Uptime SLA

Pangkalahatang-ideya

Ang Jetweb Image Optimizer ay isang mataas na performans na serbisyo ng pag-convert ng imahe na nagbabago ng iyong mga imahe sa modernong mga format na WebP at AVIF. Pinoproseso ng aming API ang mga imahe sa millisecond at inihatid ang mga ito sa pamamagitan ng isang pandaigdigang CDN para sa napakabilis na pag-load.

Maging ikaw ay gumagawa ng isang site na WordPress, platform ng ecommerce, o pasadyang web application, ang Jetweb ay nagbibigay ng mga kagamitan upang makapaghatid ng mga na-optimize na imahe sa anumang sukat.

Mga Tampok

Pag-convert sa WebP

97%+ suporta ng browser sa buong mundo

Format na AVIF

Susunod na henerasyon ng compression (Starter+)

Batch Processing

Hanggang 10 imahe bawat kahilingan

Pandaigdigang CDN

20+ lokasyon ng edge sa buong mundo

Mga Naka-sign na URL

Cryptographically secure na paghahatid

Plugin para sa WordPress

Isang-click na pag-install

Mga Suportadong Format

Sinusuportahan namin ang lahat ng pangunahing format ng imahe na may mga na-optimize na algorithm ng compression:

Input Format	Mga Format ng Output	Karaniwang Pagtitipid	Pinakamataas na Sukat
JPEG (.jpg, .jpeg)	WebP, AVIF	50-70%	50 MB
PNG (.png)	WebP, AVIF	60-80%	50 MB
GIF (.gif)	WebP (animated)	40-60%	50 MB
WebP (.webp)	AVIF	20-40%	50 MB
BMP (.bmp)	WebP, AVIF	80-95%	50 MB

WordPress Plugin

Magsimula sa loob ng ilang minuto gamit ang aming opisyal na WordPress plugin. Awtomatikong i-optimize ang lahat ng media upload nang walang pagsasaayos.

Pag-install

I-download ang plugin mula sa iyong Jetweb Dashboard

I-upload sa pamamagitan ng WordPress Admin → Mga Plugin → Magdagdag ng Bago → I-upload ang Plugin

I-activate ang Jetweb Image Optimizer plugin

I-configure sa Mga Setting → Jetweb Image Optimizer

Ilagay ang API Key mula sa iyong pahina ng API Keys

Mga Setting ng Plugin

Setting	Description	Default
API Key	Ang iyong Jetweb access token (nagsisimula sa jw_)	Kinakailangan
Format ng Output	WebP (lahat ng plano) o AVIF (Starter+)	WebP
Kalidad	Kalidad ng compression 1-100	85
Awtomatikong pag-optimize	I-optimize ang mga imahe sa pag-upload	Pinagana
Gamitin ang CDN	Ihatid mula sa Jetweb CDN	Pinagana

REST API

Bumuo ng mga pasadyang integrasyon gamit ang aming REST API. Ang lahat ng kahilingan ay nangangailangan ng pagpapatunay sa pamamagitan ng X-Access Token header.

Pagpapatunay

                headers
                
                X-Access-Token: jw_your_api_key_here
Content-Type: multipart/form-data

I-convert ang Isang Imahe

                POST /convert
                
              

                # Request
POST https://image-optimizer.api.jetweb.app/convert

# Form Data
file:    [binary]     # Image file
format:  webp         # webp | avif
quality: 85           # 1-100

# Response Headers
X-Original-Size:  156789
X-Converted-Size: 45678
X-Savings:        71%
X-CDN-URL-WebP:   https://cdn.jetweb.app/abc123.webp?sig=...
              

Batch na Pag-convert

                POST /convert/batch
                
              

                # Request (up to 10 images)
POST https://image-optimizer.api.jetweb.app/convert/batch

files[]: [image1.jpg]
files[]: [image2.png]
format:  webp
quality: 85

# Response
{
  "success": true,
  "results": [
    { "filename": "image1.jpg", "savings": "68%", "cdnUrl": "..." },
    { "filename": "image2.png", "savings": "75%", "cdnUrl": "..." }
  ],
  "totalProcessed": 2
}
              

Integrasyon ng CDN

Ang lahat ng na-convert na imahe ay awtomatikong iniimbak sa aming pandaigdigang CDN. Gamitin ang ibinigay na mga naka-sign na URL nang direkta sa iyong HTML:

              usage.html
              
            

              <!-- Modern browsers with fallback -->
<picture>
  <source srcset="https://cdn.jetweb.app/abc.avif?sig=..." type="image/avif">
  <source srcset="https://cdn.jetweb.app/abc.webp?sig=..." type="image/webp">
  <img src="/original.jpg" alt="Description" loading="lazy">
</picture>
            

Mga Setting ng Kalidad

Piliin ang pinakamainam na setting ng kalidad batay sa iyong use case:

Kalidad	Use Case	Laki ng File	Kalidad ng Biswal
90-100	Litrato, mga imahe ng produkto	Mas Malaki	Walang Pagkawala/Halos walang pagkawala
80-90	Pangkalahatang mga imahe sa web	Balansado	Napakahusay (inirerekomenda)
60-80	Mga thumbnail, mga background	Mas Maliit	Mahusay
<60	Pinakamataas na kompresyon	Pinakamaliit	Katanggap-tanggap

Mga Limitasyon sa Rate at Presyo

Nag-iiba ang mga limitasyon sa rate ng API at buwanang quota ayon sa plano:

Libre

0€/mo

50 imahe/buwan

WebP only
10 req/min
No CDN

Starter

2,99€/mo

500 imahe/buwan

WebP + AVIF
30 req/min
CDN included

Pro

5,99€/mo

2,000 larawan/buwan

WebP + AVIF
60 req/min
CDN + Priority

Business

9,99€/mo

10,000 larawan/buwan

All formats
120 req/min
Priority support

Mga header ng limitasyon sa rate: X-RateLimit-Remaining, X-RateLimit-Reset

Mga Kodigo ng Kamalian

Ang API ay nagbabalik ng mga karaniwang kodigo ng katayuang HTTP na may mga deskriptibong mensahe ng kamalian:

Kodigo	Kamalian	Paglalarawan
400	Hindi Wastong Kahilingan	Hindi wastong mga parameter o kulang sa mga kinakailangang field
401	Hindi Awtorisado	Nawawala o hindi wastong susi ng API
403	Ipinagbabawal	Na-lampasan ang limitasyon ng plano o hindi available ang feature
413	Masyadong Malaki ang Payload	Ang file ay lumampas sa limitasyong 50MB
415	Hindi Suportadong Media	Hindi suportado ang format ng file
429	Napakaraming Kahilingan	Na-exceed ang limitasyon ng rate
500	Error sa Server	Panloob na error sa pagproseso

Pagtroubleshoot

"Na-exceed ang Buwanang Limitasyon sa Pag-convert"

Naabot mo na ang buwanang quota ng iyong plan. I-upgrade ang iyong plan o maghintay para sa susunod na billing cycle (nagre-reset sa ika-1).

"Hindi Wastong Access Token"

Patunayan ang iyong API key sa pahina ng API Keys. Ang mga key ay dapat magsimula sa jw_.

"Masyadong Malaki ang File"

Ang pinakamataas na laki ng file ay 50MB. Baguhin ang laki ng iyong larawan bago i-upload o gumamit muna ng tool sa compression.

"Na-exceed ang Limitasyon ng Rate"

Maghintay hanggang sa mag-reset ang window ng rate limit (ipinapakita sa X-RateLimit-Reset header) o i-upgrade ang iyong plan.

Mga Madalas Itanong (FAQ)

Nag-aalok ang WebP ng mahusay na compression na may 97%+ na suporta ng browser. Nagbibigay ang AVIF ng 20-30% na mas mahusay na compression ngunit may ~92% na suporta ng browser. Inirerekomenda namin ang WebP para sa pinakamataas na compatibility, at ang AVIF kapag ang target ay mga modernong browser.

Ang mga na-convert na larawan ay iniimbak ng 30 araw mula sa huling pag-access. Ang mga aktibong larawan (na-akses sa loob ng 30 araw) ay pinapanatili nang walang takdang oras. Ang mga Signed URL ay nananatiling balido sa loob ng 1 taon.

Oo! Gumagana ang aming REST API sa anumang framework. Para sa Next.js, inirerekomenda namin ang server side conversion sa panahon ng build o ang direktang paggamit ng aming mga CDN URL na may naka-disable na next/image optimization para sa mga Jetweb URL.

Bilang default, tinatanggal namin ang EXIF metadata para sa mas maliit na laki ng file at privacy. Idagdag ang preserve_metadata=true sa iyong request upang panatilihin ito.

Oo! Para sa mga pangangailangan ng mataas na volume (50,000+ images/month), makipag-ugnayan sa amin sa [email protected] para sa custom pricing at dedicated support.

Handa nang mag-optimize?

Simulan ang pag-convert ng mga larawan sa loob ng ilang minuto. Kabilang sa libreng plan ang 50 images/month.

Magsimula Nang Libre Makipag-ugnayan sa Support