API
แปลงรูปภาพผ่าน HTTP
ภาพรวม
Convert2WebP API ช่วยให้คุณสามารถแปลงรูปภาพระหว่างรูปแบบต่างๆ โดยทางโปรแกรม ส่งคำขอแบบหลายส่วนพร้อมรูปภาพของคุณ และรับไฟล์ที่แปลงแล้วในส่วนเนื้อหาการตอบกลับ การประมวลผลทั้งหมดเกิดขึ้นฝั่งเซิร์ฟเวอร์โดยมีเวลาแฝงต่ำกว่าวินาทีสำหรับไฟล์ส่วนใหญ่
Base URL
https://convert2webp.com/api/v1การยืนยันตัวตน
ไม่จำเป็นต้องมีการรับรองความถูกต้อง API เป็นอิสระและเปิดกว้าง คำขอทั้งหมดจำกัดอัตราไว้ที่ 60 คำขอต่อนาทีต่อที่อยู่ IP
การจำกัดอัตรา
มีการจำกัดอัตราตามที่อยู่ IP คำตอบทั้งหมดรวมส่วนหัวของขีดจำกัดอัตราด้วย
| ขีดจำกัด | ขนาดไฟล์สูงสุด | ไฟล์แบตช์สูงสุด |
|---|---|---|
| 60 คำขอ / นาที | 10 MB ต่อไฟล์ | 20 ไฟล์ต่อชุด |
ส่วนหัวขีดจำกัดอัตราจะรวมอยู่ในทุกคำตอบ: X-RateLimit-Remaining, X-RateLimit-Reset.
Endpoints
แปลงรูปภาพเดียวเป็นรูปแบบเป้าหมาย ยอมรับ multipart/form-data พร้อมด้วยไฟล์รูปภาพและพารามิเตอร์เสริม
พารามิเตอร์
| ชื่อ | พิมพ์ | ที่จำเป็น | คำอธิบาย |
|---|---|---|---|
| file | File | ที่จำเป็น | ไฟล์รูปภาพที่จะแปลง ยอมรับ PNG, JPG, GIF, BMP, TIFF, SVG, AVIF, ICO และ WebP |
| output_format | string | ไม่จำเป็น | รูปแบบเอาต์พุตเป้าหมาย: webp, PNG, jpg, gif, bmp หรือ pdf(ค่าเริ่มต้น: webp) |
| quality | integer | ไม่จำเป็น | คุณภาพเอาต์พุตตั้งแต่ 1 (ต่ำสุด) ถึง 100 (สูงสุด)(ค่าเริ่มต้น: 80) |
| width | integer | ไม่จำเป็น | ความกว้างเอาต์พุตสูงสุดเป็นพิกเซล อัตราส่วนภาพยังคงอยู่ |
| height | integer | ไม่จำเป็น | ความสูงเอาต์พุตสูงสุดเป็นพิกเซล อัตราส่วนภาพยังคงอยู่ |
| strip_metadata | boolean | ไม่จำเป็น | ตัดข้อมูลเมตา EXIF/IPTC/XMP ออกจากเอาต์พุต(ค่าเริ่มต้น: true) |
การตอบกลับ
ตัวอย่างโค้ด
curl -X POST https://convert2webp.com/api/v1/convert \
-F "file=@photo.png" \
-F "format=webp" \
-F "quality=80" \
-o converted.webpลองใช้งาน
แปลงภาพหลายภาพในคำขอเดียว ส่งคืนไฟล์เก็บถาวร ZIP พร้อมไฟล์ที่แปลงแล้วทั้งหมด
พารามิเตอร์
| ชื่อ | พิมพ์ | ที่จำเป็น | คำอธิบาย |
|---|---|---|---|
| files | File[] | ที่จำเป็น | อาร์เรย์ของไฟล์รูปภาพที่จะแปลง สูงสุด 20 ไฟล์ต่อคำขอ |
| format | string | ไม่จำเป็น | รูปแบบผลลัพธ์เป้าหมายที่ใช้กับไฟล์ทั้งหมด(ค่าเริ่มต้น: webp) |
| quality | integer | ไม่จำเป็น | คุณภาพผลผลิตตั้งแต่ 1 ถึง 100(ค่าเริ่มต้น: 80) |
การตอบกลับ
ตัวอย่างโค้ด
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แสดงรายการรูปแบบภาพอินพุตและเอาต์พุตที่รองรับทั้งหมด
การตอบกลับ
ตัวอย่างโค้ด
curl https://convert2webp.com/api/v1/formatsตัวอย่างการตอบกลับ
{
"input": [
"png", "jpg", "jpeg", "gif", "bmp",
"tiff", "svg", "avif", "ico", "webp"
],
"output": ["webp", "png", "jpg", "gif", "bmp", "pdf"]
}ตรวจสอบความพร้อมในการให้บริการ
การตอบกลับ
ตัวอย่างโค้ด
curl https://convert2webp.com/api/v1/healthตัวอย่างการตอบกลับ
{
"status": "ok",
"version": "1.0.0",
"timestamp": "2026-04-04T12:00:00.000Z"
}รหัสข้อผิดพลาด
การตอบสนองข้อผิดพลาดทั้งหมดส่งคืนเนื้อหา JSON ด้วย error วัตถุที่อธิบายสิ่งที่ผิดพลาด
{
"error": {
"code": 429,
"message": "Rate limit exceeded. Please wait 30 seconds before retrying."
}
}| รหัส | ชื่อ | คำอธิบาย |
|---|---|---|
| 400 | คำขอไม่ถูกต้อง | คำขอมีรูปแบบไม่ถูกต้อง ตรวจสอบว่าพารามิเตอร์ที่จำเป็นทั้งหมดมีอยู่และถูกต้อง |
| 413 | เพย์โหลดใหญ่เกินไป | ไฟล์ที่อัปโหลดเกินขีดจำกัด 10 MB |
| 415 | ประเภทสื่อที่ไม่รองรับ | รูปแบบไฟล์ที่อัปโหลดไม่รองรับการแปลง |
| 429 | คำขอมากเกินไป | คุณเกินขีดจำกัดอัตรา (คำขอ 60 รายการต่อนาที) รอและลองอีกครั้ง |
| 500 | ข้อผิดพลาดเซิร์ฟเวอร์ภายใน | เกิดข้อผิดพลาดที่ไม่คาดคิด หากยังคงอยู่ โปรดติดต่อ convert2webp@deployvision.com |