Files
SnapOtter/apps/docs/th/tools/image/transparency-fixer.md
T
SnapOtterandGitHub 4963ab3bbd feat(docs-i18n): translate all documentation into 20 languages
All 181 docs markdown files translated into 20 languages (apps/docs/<locale>/**). Companion to the i18n code PR; admin-merged because the file count exceeds GitHub's per-PR CI trigger limit. Validated by pnpm i18n:check (all surfaces, 0 stale/missing) and a clean all-locale docs build.
2026-07-11 13:52:47 +08:00

4.4 KiB

description, i18n_source_hash, i18n_provenance, i18n_output_hash
description i18n_source_hash i18n_provenance i18n_output_hash
แก้ไข PNG ที่โปร่งใสปลอมด้วยการแมตต์ด้วย AI (BiRefNet) เพื่อสร้างค่า alpha ที่แท้จริง พร้อมการล้างขอบด้วย defringe 7eb748b80f93 human e4c42c6529af

PNG Transparency Fixer

แก้ไข PNG ที่โปร่งใสปลอมได้ในคลิกเดียว ใช้การแมตต์ด้วย AI (โมเดล BiRefNet HR Matting) เพื่อสร้างความโปร่งใส alpha ที่แท้จริง พร้อมการประมวลผลภายหลังด้วย defringe เพื่อล้างขอบ

API Endpoint

POST /api/v1/tools/image/transparency-fixer

การประมวลผล: แบบอะซิงโครนัส (คืนค่า 202, สำรวจ /api/v1/jobs/{jobId}/progress เพื่อดูสถานะผ่าน SSE)

ชุดโมเดล: background-removal (4-5 GB)

Parameters

Parameter Type Required Default Description
file file Yes - ไฟล์ภาพ (multipart)
defringe number No 30 ความเข้มของ defringe (0-100) ลบพิกเซลขอบกึ่งโปร่งใสรอบขอบภาพ
outputFormat string No "png" รูปแบบผลลัพธ์: png หรือ webp
removeWatermark boolean No false ใช้การประมวลผลลบลายน้ำก่อน (median filter)

Example Request

curl -X POST http://localhost:1349/api/v1/tools/image/transparency-fixer \
  -F "file=@fake-transparent.png" \
  -F 'settings={"defringe":40,"outputFormat":"png"}'

Response

การตอบกลับเริ่มต้น (202 Accepted)

{
  "jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "async": true
}

ความคืบหน้า (SSE ที่ /api/v1/jobs/{jobId}/progress)

event: progress
data: {"phase":"processing","stage":"Processing transparency...","percent":50}

ผลลัพธ์สุดท้าย (ผ่าน SSE)

{
  "phase": "complete",
  "percent": 100,
  "result": {
    "jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "downloadUrl": "/api/v1/download/{jobId}/fake-transparent_fixed.png",
    "originalSize": 180000,
    "processedSize": 150000,
    "filename": "fake-transparent.png"
  }
}

Notes

  • จำเป็นต้องติดตั้งชุดโมเดล background-removal (4-5 GB)
  • ใช้ birefnet-hr-matting เป็นโมเดลหลักสำหรับการแมตต์ alpha คุณภาพสูง จะย้อนกลับไปใช้ birefnet-general หากโมเดล HR หน่วยความจำไม่พอ
  • ตัวเลือก defringe ลบพิกเซลขอบกึ่งโปร่งใสที่การแมตต์ด้วย AI บางครั้งทิ้งไว้รอบเส้นผม ขน และขอบที่ละเอียด โดยทำงานด้วยการเบลอช่อง alpha และปรับพิกเซลที่มีความเชื่อมั่นต่ำให้เป็นศูนย์
  • ตัวเลือก removeWatermark ใช้ขั้นตอนการประมวลผลก่อนด้วย median filter เป็นการลดลายน้ำเบื้องต้น ไม่ใช่เครื่องมือลบลายน้ำโดยเฉพาะ
  • ให้ผลลัพธ์เป็น PNG หรือ WebP แบบไม่สูญเสียข้อมูลเท่านั้น (ทั้งคู่รองรับความโปร่งใส alpha)
  • รองรับรูปแบบไฟล์นำเข้า HEIC/HEIF, RAW, TGA, PSD, EXR และ HDR ผ่านการถอดรหัสอัตโนมัติ