iApp Image Upscaler

ขยายภาพ 2 เท่าหรือ 4 เท่า ได้ถึง 16.8 ล้านพิกเซล โดยสร้างขอบ พื้นผิว และตัวอักษรขึ้นใหม่แทนการเบลอ

POST/v3/store/image-generation/image-upscaler/upscaleทดลองใช้

ราคา1 ICต่อครั้ง
รองรับ1,500 ภาพ/ชั่วโมง
ให้บริการแล้ว11.1Kครั้ง

Input

file: product.jpg
scale: 4
output_format: png

OutputPOST /v3/store/image-generation/image-upscaler/upscale

status: success
model: photo
scale: 4
input: width: 800 height: 800
width: 3200
height: 3200
mime_type: image/png
bytes: 9871234
time: model: 0.61 total: 1.42
iapp: images: 1 version: 1.0.0-20260907

ฟิลด์ทั้งหมดอยู่ในหัวข้อ Response

Request

curl -X POST https://api.iapp.co.th/v3/store/image-generation/image-upscaler/upscale \
  -H "apikey: YOUR_API_KEY" \
  -F "file=@product.jpg" \
  -F "scale=4" \
  -F "output_format=png"

Response

200OK ฟิลด์อธิบายไว้ในหัวข้อ Response

{
  "status": "success",
  "model": "photo",
  "scale": 4,
  "input": { "width": 800, "height": 800 },
  "width": 3200,
  "height": 3200,
  "mime_type": "image/png",
  "bytes": 9871234,
  "image_base64": "iVBORw0KGgoAAAANSUhEUgAADIAAAAyACAIAAAB...",
  "time": { "model": 0.61, "total": 1.42 },
  "iapp": { "images": 1, "version": "1.0.0-20260907" }
}

Request

ส่งเป็น multipart/form-data ครั้งละหนึ่งภาพ คิด 1 IC ต่อภาพไม่ว่าขนาดหรืออัตราขยายใด Request ที่ถูกปฏิเสธหรือล้มเหลวไม่คิดเงิน

Headers

apikeystringrequired

API key ของคุณ สร้างได้ที่เมนู API Keys ในแผงควบคุม

Body

filefilerequired

ภาพ JPEG, PNG หรือ WebP ไม่เกิน 10 MB และ 16.8 ล้านพิกเซล ระบบหมุนภาพตาม EXIF และคงความโปร่งใส ไม่ต้องส่งถ้าส่ง image_base64 แล้ว

image_base64string

ภาพเป็น Base64 ใส่ prefix data: ได้ ใช้แทน file

scaleinteger

4 (ค่าเริ่มต้น) หรือ 2 ที่ 4 เท่า ภาพต้นทางได้ไม่เกิน 1024 × 1024 ที่ 2 เท่าไม่เกิน 2048 × 2048

modelstring

photo (ค่าเริ่มต้น) สำหรับภาพถ่าย anime สำหรับภาพวาดและงานกราฟิกแบน fast เมื่อต้องการปริมาณมากกว่ารายละเอียด

output_formatstring

png (ค่าเริ่มต้น ไม่สูญเสียคุณภาพ) jpeg หรือ webp ภาพถ่าย 4096 × 4096 เป็น PNG ราว 10 ถึง 20 MB และเป็น JPEG คุณภาพ 92 ราว 1 ถึง 3 MB

qualityinteger

1 ถึง 100 สำหรับ jpeg และ webp ค่าเริ่มต้น 92

responsestring

json (ค่าเริ่มต้น) ส่งออบเจ็กต์ตามแผงด้านข้างพร้อมภาพเป็น Base64 image ส่งไบต์ของภาพพร้อม Content-Type ที่ตรงกัน

GET /v3/store/image-generation/image-upscaler/models แสดงรายการโมเดลและข้อจำกัด ไม่คิดเงิน

Response

model และ scale ที่ใช้ ขนาด input และ width, height ของผลลัพธ์ mime_type, bytes, image_base64 และ time โดย model คือเวลาขยาย และ total รวมการถอดรหัสไฟล์ที่อัปโหลดและเข้ารหัสผลลัพธ์ ทุก Response ที่สำเร็จมี header iapp-input-images: 1 และ x-iapp-output-size

รหัสสถานะ

รหัส	`error_code`	ความหมาย
400	`invalid_image`	ไม่ใช่ JPEG, PNG หรือ WebP ที่อ่านได้
400	`input_too_large`	ภาพต้นทางเกิน 16.8 ล้านพิกเซล
400	`output_too_large`	ภาพ × อัตราขยายจะเกิน 16.8 ล้านพิกเซล ข้อความบอกขนาดต้นทางสูงสุดของอัตรานั้น
400	`invalid_scale`, `invalid_model`, `invalid_output_format`	ค่าของฟิลด์อยู่นอกรายการข้างต้น
413	`file_too_large`	ไฟล์เกิน 10 MB
503	`starting`	บริการกำลังเริ่มทำงาน ลองใหม่ใน 30 วินาที

รายละเอียดเพิ่มเติม

ผลการทดสอบ

โมเดล photo เทียบกับการย่อขยายแบบ bicubic บนภาพ 29 ภาพจากแกลเลอรี iApp Image Generation ขนาด 900 × 540 แต่ละภาพย่อ 4 เท่าแล้วขยายกลับ วัดเมื่อ 7 กันยายน 2569

รายการ	Bicubic	Upscaler
ระยะ LPIPS ยิ่งต่ำยิ่งดี	0.284	0.159
ภาพที่ upscaler ใกล้ต้นฉบับกว่า		29 จาก 29
PSNR ยิ่งสูงยิ่งดี	27.2 dB	25.7 dB

LPIPS วัดว่าผลลัพธ์ดูใกล้ต้นฉบับแค่ไหนในสายตาคน ส่วน PSNR ให้คะแนนความเบลอที่ปลอดภัยของการย่อขยาย การสร้างพื้นผิวใหม่จึงต้องแลกกับ PSNR เล็กน้อยเสมอ

เวลา บน GPU ระบบจริง มัธยฐาน 5 ครั้ง	โมเดล	เข้ารหัส PNG	เข้ารหัส JPEG
512 × 512 เป็น 2048 × 2048	0.23 วินาที	0.34 วินาที	0.05 วินาที
1024 × 1024 เป็น 4096 × 4096	0.98 วินาที	1.37 วินาที	0.18 วินาที
1920 × 1080 เป็น 3840 × 2160	0.41 วินาที	0.61 วินาที	0.08 วินาที
2048 × 2048 เป็น 4096 × 4096	0.78 วินาที	1.27 วินาที	0.18 วินาที

สำหรับ 1024 × 1024 เป็น 4096 × 4096 โมเดลภาพวาดใช้ 0.32 วินาที และโมเดล fast ใช้ 0.06 วินาที GPU หนึ่งตัวรองรับราว 1,500 ภาพต่อชั่วโมงที่ขนาดใหญ่สุดเป็น PNG และราว 3,000 ภาพเป็น JPEG เกินกว่านั้นต้องรอคิว

ข้อจำกัด

จำกัดต่อคีย์: 5 ครั้งต่อวินาที 60 ครั้งต่อนาที 1,200 ครั้งต่อชั่วโมง
รายละเอียดที่ไม่มีในต้นทางถูกสร้างขึ้น ไม่ใช่กู้คืน ใบหน้าหรือตัวอักษรเล็กขนาด 40 พิกเซลจะคมแต่ไม่จำเป็นต้องตรงของจริง ผลลัพธ์จึงใช้เป็นหลักฐานว่าภาพต้นทางความละเอียดต่ำแสดงอะไรไม่ได้
รอยบีบอัดและความเบลอในต้นทางถูกแก้ แต่ภาพสั่นไหวและส่วนที่หลุดโฟกัสยังคงนุ่ม

การจัดการข้อมูล

ภาพประมวลผลในหน่วยความจำและส่งกลับใน Response ไม่เขียนลงดิสก์และไม่เก็บไว้ โมเดลรันบน GPU ของไอแอพพ์เองในประเทศไทย ไม่มีภาพใดถูกส่งไปบุคคลที่สาม ส่วนการขอความยินยอมและการแจ้งเจ้าของข้อมูลตาม PDPA และ GDPR เป็นหน้าที่ของคุณในฐานะผู้ควบคุมข้อมูล

Changelog

เวอร์ชัน	วันที่	การเปลี่ยนแปลง
v1.0.0-20260907	7 ก.ย. 2569	เปิดให้บริการ: ขยาย 2 และ 4 เท่าด้วยโมเดล photo ภาพวาด และ fast ส่งออก PNG, JPEG และ WebP ได้ถึง 16.8 ล้านพิกเซล คงความโปร่งใส 1 IC ต่อภาพ

Request​

Response​

รายละเอียดเพิ่มเติม​

Request

Response

รายละเอียดเพิ่มเติม