Dokumentasi API Konversi Gambar - REST API untuk Konversi WebP

Ringkasan

API Convert2WebP memungkinkan Anda mengonversi gambar antar format secara terprogram. Kirim permintaan multipart dengan gambar Anda dan terima file hasil konversi di body respons. Semua pemrosesan terjadi di sisi server dan biasanya memerlukan waktu kurang dari satu detik untuk sebagian besar file.

URL dasar

https://convert2webp.com/api/v1

Autentikasi

Autentikasi tidak diperlukan. API ini gratis dan terbuka. Semua permintaan dibatasi hingga 60 per menit per alamat IP.

Rate limiting

Batas diterapkan per alamat IP. Semua respons menyertakan header rate limit.

Batas	Ukuran file maksimum	Maksimum file per batch
60 permintaan / menit	10 MB per file	20 file per batch

Header rate limit disertakan di setiap respons: X-RateLimit-Remaining, X-RateLimit-Reset.

Endpoints

Mengonversi satu gambar ke format tujuan. Menerima multipart/form-data dengan file gambar dan parameter opsional.

Parameter

Nama	Tipe	Wajib	Deskripsi
file	File	Wajib	File gambar yang akan dikonversi. Mendukung PNG, JPG, GIF, BMP, TIFF, SVG, AVIF, ICO, dan WebP.
output_format	string	Opsional	Format output tujuan: webp, png, jpg, gif, bmp, atau pdf.(default: `webp`)
quality	integer	Opsional	Kualitas output dari 1 (terendah) sampai 100 (tertinggi).(default: `80`)
width	integer	Opsional	Lebar output maksimum dalam piksel. Rasio aspek dipertahankan.
height	integer	Opsional	Tinggi output maksimum dalam piksel. Rasio aspek dipertahankan.
strip_metadata	boolean	Opsional	Menghapus metadata EXIF/IPTC/XMP dari hasil keluaran.(default: `true`)

Respons

200

Data biner gambar hasil konversiimage/webp

400

Permintaan tidak valid (file hilang, format tidak didukung, dll.)application/json

413

File terlalu besarapplication/json

429

Batas terlampauiapplication/json

500

Kesalahan server internalapplication/json

Contoh kode

terminal

curl -X POST https://convert2webp.com/api/v1/convert \
  -F "file=@photo.png" \
  -F "format=webp" \
  -F "quality=80" \
  -o converted.webp

Coba

File

Tidak ada file dipilih

Format

Kualitas (80)

Mengonversi beberapa gambar dalam satu permintaan. Mengembalikan arsip ZIP berisi semua file hasil konversi.

Parameter

Nama	Tipe	Wajib	Deskripsi
files	File[]	Wajib	Daftar file gambar untuk dikonversi. Maksimum 20 file per permintaan.
format	string	Opsional	Format output yang diterapkan ke semua file.(default: `webp`)
quality	integer	Opsional	Kualitas output dari 1 sampai 100.(default: `80`)

Respons

200

Arsip ZIP berisi semua gambar yang dikonversiapplication/zip

400

Permintaan tidak validapplication/json

413

Total payload terlalu besarapplication/json

429

Batas terlampauiapplication/json

Contoh kode

terminal

curl -X POST https://convert2webp.com/api/v1/batch \
  -F "files=@image1.png" \
  -F "files=@image2.jpg" \
  -F "files=@image3.gif" \
  -F "format=webp" \
  -F "quality=80" \
  -o converted.zip

Menampilkan semua format input dan output yang didukung.

Respons

200

Objek JSON yang menampilkan format input dan output yang didukungapplication/json

Contoh kode

terminal

curl https://convert2webp.com/api/v1/formats

Contoh respons

response.json

{
  "input": [
    "png", "jpg", "jpeg", "gif", "bmp",
    "tiff", "svg", "avif", "ico", "webp"
  ],
  "output": ["webp", "png", "jpg", "gif", "bmp", "pdf"]
}

Memeriksa ketersediaan layanan.

Respons

200

Status layanan dan versiapplication/json

Contoh kode

terminal

curl https://convert2webp.com/api/v1/health

Contoh respons

response.json

{
  "status": "ok",
  "version": "1.0.0",
  "timestamp": "2026-04-04T12:00:00.000Z"
}

Kode error

Semua respons error mengembalikan body JSON dengan sebuah error objek yang menjelaskan masalahnya.

error-response.json

{
  "error": {
    "code": 429,
    "message": "Rate limit exceeded. Please wait 30 seconds before retrying."
  }
}

Kode	Nama	Deskripsi
400	Permintaan tidak valid	Permintaan tidak valid. Pastikan semua parameter wajib ada dan benar.
413	Payload terlalu besar	File yang diunggah melebihi batas 10 MB.
415	Jenis media tidak didukung	Format file yang diunggah tidak didukung untuk konversi.
429	Terlalu banyak permintaan	Anda telah melampaui batas (60 permintaan per menit). Tunggu lalu coba lagi.
500	Kesalahan server internal	Terjadi kesalahan tak terduga. Jika terus terjadi, hubungi convert2webp@deployvision.com.