API ドキュメント

Image Optimizer

画像をWebPとAVIFに変換し、ファイルサイズを最大80%削減します。完全なREST API、WordPressプラグイン、グローバルなCDN配信を提供します。

80%

平均削減率

50ms

レスポンス時間

20+

CDN ロケーション

99.9%

稼働時間SLA

概要

Jetweb Image Optimizerは、画像を最新のWebPおよびAVIF形式に変換する高性能画像変換サービスです。当社のAPIはミリ秒単位で画像を処理し、グローバルなCDNを通じて高速な読み込みを実現します。

WordPressサイト、eコマースプラットフォーム、カスタムWebアプリケーションの構築を問わず、Jetwebはあらゆる規模で最適化された画像を配信するためのツールを提供します。

機能

WebP変換

全世界で97%以上のブラウザサポート

AVIF形式

次世代圧縮（Starterプラン以上）

バッチ処理

1リクエストあたり最大10画像

グローバルCDN

全世界20以上のエッジロケーション

署名付きURL

暗号学的に安全な配信

WordPressプラグイン

ワンクリックインストール

サポート形式

最適化された圧縮アルゴリズムにより、主要な画像形式をすべてサポートしています：

入力形式	出力形式	典型的な削減率	最大サイズ
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 プラグイン

公式のWordPressプラグインで数分で始められます。設定不要で全てのメディアアップロードを自動最適化。

インストール

ダウンロード Jetweb Dashboardからプラグインをダウンロード

アップロード WordPress 管理画面 → プラグイン → 新規追加 → プラグインのアップロード

有効化 Jetweb Image Optimizer プラグインを有効化

設定設定 → Jetweb Image Optimizer で設定

APIキーの入力 APIキーページからAPIキーを入力

プラグイン設定

Setting	Description	Default
APIキー	あなたのJetwebアクセストークン (jw_で始まります)	必須
出力形式	WebP (全プラン) または AVIF (Starter+)	WebP
品質	圧縮品質 1-100	85
自動最適化	アップロード時に画像を最適化	有効
CDNを使用	Jetweb CDNから配信	有効

REST API

REST APIを使用してカスタム統合を構築できます。すべてのリクエストには、X-Access Tokenヘッダーによる認証が必要です。

認証

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

単一画像変換

                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=...
              

一括変換

                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
}
              

CDN統合

変換されたすべての画像は、当社のグローバルCDNに自動的に保存されます。提供される署名付きURLを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>
            

品質設定

用途に基づいて最適な品質設定を選択してください:

品質	用途	ファイルサイズ	画質
90-100	写真、商品画像	大きめ	ロスレス/ニアロスレス
80-90	一般的なウェブ画像	バランス型	優れている（推奨）
60-80	サムネイル、背景	小さめ	良好
<60	最大圧縮	最小	許容範囲

レート制限と料金

APIのレート制限および月間クォータはプランにより異なります：

Free

0€/mo

50 画像/月

WebP only
10 req/min
No CDN

Starter

2,99€/mo

500 画像/月

WebP + AVIF
30 req/min
CDN included

Pro

5,99€/mo

月2,000画像

WebP + AVIF
60 req/min
CDN + Priority

Business

9,99€/mo

月10,000画像

All formats
120 req/min
Priority support

レート制限ヘッダー: X-RateLimit-Remaining, X-RateLimit-Reset

エラーコード

APIは標準的なHTTPステータスコードと説明文を含むエラーメッセージを返します:

コード	エラー	説明
400	不正なリクエスト	無効なパラメータまたは必須フィールドの欠落
401	認証エラー	APIキーが欠落しているか無効です
403	アクセス拒否	プランの制限を超過したか、機能が利用できません
413	ペイロードが大きすぎます	ファイルが50MBの制限を超えています
415	未対応のメディア	サポートされていないファイル形式です
429	リクエストが多すぎます	レート制限を超過しました
500	サーバーエラー	内部処理エラー

トラブルシューティング

"月間変換制限を超過しました"

ご利用プランの月間クォータに達しました。プランをアップグレードするか、次の請求サイクル（毎月1日にリセット）までお待ちください。

"無効なアクセストークン"

APIキーページでAPIキーをご確認ください。キーはjw_で始まる必要があります。

"ファイルが大きすぎます"

最大ファイルサイズは50MBです。アップロード前に画像のサイズを変更するか、まず圧縮ツールをご利用ください。

"レート制限を超過しました"

レート制限ウィンドウがリセットされる（X-RateLimit-Resetヘッダーに表示）までお待ちいただくか、プランをアップグレードしてください。

よくある質問

WebPは97%以上のブラウザサポートで優れた圧縮を提供します。AVIFは20〜30%優れた圧縮を提供しますが、ブラウザサポートは約92%です。最大限の互換性にはWebPを、最新ブラウザを対象とする場合はAVIFを推奨します。

変換された画像は、最終アクセス日から30日間保存されます。アクティブな画像（30日以内にアクセスされたもの）は無期限に保持されます。署名付きURLは1年間有効です。

はい！当社のREST APIはあらゆるフレームワークで動作します。Next.jsの場合、ビルド時のサーバーサイド変換、またはJetweb URLに対してnext/imageの最適化を無効にした上でCDN URLを直接使用することを推奨します。

デフォルトでは、ファイルサイズの削減とプライバシー保護のため、EXIFメタデータを除去します。保持するには、リクエストにpreserve_metadata=trueを追加してください。

はい！高容量（月50,000画像以上）のニーズについては、カスタム価格と専用サポートについて[email protected]までお問い合わせください。

最適化の準備はできていますか？

数分で画像変換を開始できます。無料プランでは月50画像までご利用いただけます。

無料で始めるサポートに問い合わせる