ข้ามไปที่เนื้อหา

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 พร้อมด้วยไฟล์รูปภาพและพารามิเตอร์เสริม

พารามิเตอร์

ชื่อพิมพ์ที่จำเป็นคำอธิบาย
fileFileที่จำเป็นไฟล์รูปภาพที่จะแปลง ยอมรับ PNG, JPG, GIF, BMP, TIFF, SVG, AVIF, ICO และ WebP
output_formatstringไม่จำเป็นรูปแบบเอาต์พุตเป้าหมาย: webp, PNG, jpg, gif, bmp หรือ pdf(ค่าเริ่มต้น: webp)
qualityintegerไม่จำเป็นคุณภาพเอาต์พุตตั้งแต่ 1 (ต่ำสุด) ถึง 100 (สูงสุด)(ค่าเริ่มต้น: 80)
widthintegerไม่จำเป็นความกว้างเอาต์พุตสูงสุดเป็นพิกเซล อัตราส่วนภาพยังคงอยู่
heightintegerไม่จำเป็นความสูงเอาต์พุตสูงสุดเป็นพิกเซล อัตราส่วนภาพยังคงอยู่
strip_metadatabooleanไม่จำเป็นตัดข้อมูลเมตา EXIF/IPTC/XMP ออกจากเอาต์พุต(ค่าเริ่มต้น: true)

การตอบกลับ

200
ไบนารี่ของภาพที่แปลงแล้วimage/webp
400
คำขอไม่ถูกต้อง (ไฟล์หายไป รูปแบบที่ไม่รองรับ ฯลฯ)application/json
413
ไฟล์มีขนาดใหญ่เกินไปapplication/json
429
เกินขีดจำกัดอัตราapplication/json
500
ข้อผิดพลาดเซิร์ฟเวอร์ภายในapplication/json

ตัวอย่างโค้ด

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

ลองใช้งาน

ไม่ได้เลือกไฟล์

แปลงภาพหลายภาพในคำขอเดียว ส่งคืนไฟล์เก็บถาวร ZIP พร้อมไฟล์ที่แปลงแล้วทั้งหมด

พารามิเตอร์

ชื่อพิมพ์ที่จำเป็นคำอธิบาย
filesFile[]ที่จำเป็นอาร์เรย์ของไฟล์รูปภาพที่จะแปลง สูงสุด 20 ไฟล์ต่อคำขอ
formatstringไม่จำเป็นรูปแบบผลลัพธ์เป้าหมายที่ใช้กับไฟล์ทั้งหมด(ค่าเริ่มต้น: webp)
qualityintegerไม่จำเป็นคุณภาพผลผลิตตั้งแต่ 1 ถึง 100(ค่าเริ่มต้น: 80)

การตอบกลับ

200
ไฟล์เก็บถาวร ZIP ที่มีรูปภาพที่แปลงแล้วทั้งหมดapplication/zip
400
คำขอไม่ถูกต้องapplication/json
413
เพย์โหลดรวมใหญ่เกินไปapplication/json
429
เกินขีดจำกัดอัตราapplication/json

ตัวอย่างโค้ด

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

แสดงรายการรูปแบบภาพอินพุตและเอาต์พุตที่รองรับทั้งหมด

การตอบกลับ

200
รายการอ็อบเจ็กต์ JSON รองรับรูปแบบอินพุตและเอาต์พุตapplication/json

ตัวอย่างโค้ด

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

ตัวอย่างการตอบกลับ

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

ตรวจสอบความพร้อมในการให้บริการ

การตอบกลับ

200
สถานะและเวอร์ชันการบริการapplication/json

ตัวอย่างโค้ด

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

ตัวอย่างการตอบกลับ

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

รหัสข้อผิดพลาด

การตอบสนองข้อผิดพลาดทั้งหมดส่งคืนเนื้อหา JSON ด้วย error วัตถุที่อธิบายสิ่งที่ผิดพลาด

error-response.json
{
  "error": {
    "code": 429,
    "message": "Rate limit exceeded. Please wait 30 seconds before retrying."
  }
}
รหัสชื่อคำอธิบาย
400คำขอไม่ถูกต้องคำขอมีรูปแบบไม่ถูกต้อง ตรวจสอบว่าพารามิเตอร์ที่จำเป็นทั้งหมดมีอยู่และถูกต้อง
413เพย์โหลดใหญ่เกินไปไฟล์ที่อัปโหลดเกินขีดจำกัด 10 MB
415ประเภทสื่อที่ไม่รองรับรูปแบบไฟล์ที่อัปโหลดไม่รองรับการแปลง
429คำขอมากเกินไปคุณเกินขีดจำกัดอัตรา (คำขอ 60 รายการต่อนาที) รอและลองอีกครั้ง
500ข้อผิดพลาดเซิร์ฟเวอร์ภายในเกิดข้อผิดพลาดที่ไม่คาดคิด หากยังคงอยู่ โปรดติดต่อ convert2webp@deployvision.com