mirror of https://github.com/snapotter-hq/SnapOtter.git synced 2026-08-03 07:46:42 +02:00

Files

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

3.6 KiB

Raw Blame History

description, i18n_source_hash, i18n_provenance, i18n_output_hash

description	i18n_source_hash	i18n_provenance	i18n_output_hash
إصلاح ملفات PNG الشفافة الزائفة بالمطّ بالذكاء الاصطناعي (BiRefNet) لإنتاج شفافية حقيقية، مع تنظيف حواف بإزالة الأطراف.	7eb748b80f93	human	3956e0e60365

مصلح شفافية PNG

أصلح ملفات PNG الشفافة الزائفة بنقرة واحدة. يستخدم المطّ بالذكاء الاصطناعي (نموذج BiRefNet HR Matting) لإنتاج شفافية ألفا حقيقية، مع معالجة لاحقة لإزالة الأطراف لتنظيف الحواف.

نقطة نهاية API

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

المعالجة: غير متزامنة (تُرجع 202، مع استقصاء /api/v1/jobs/{jobId}/progress للحالة عبر SSE)

حزمة النموذج: background-removal (4-5 غيغابايت)

المعاملات

المعامل	النوع	مطلوب	الافتراضي	الوصف
file	file	نعم	-	ملف الصورة (متعدد الأجزاء)
defringe	number	لا	`30`	شدة إزالة الأطراف (0-100). يزيل بكسلات الأطراف شبه الشفافة حول الحواف
outputFormat	string	لا	`"png"`	صيغة المخرجات: `png` أو `webp`
removeWatermark	boolean	لا	`false`	تطبيق معالجة مسبقة لإزالة العلامة المائية (مرشح وسيط)

مثال طلب

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

الاستجابة

الاستجابة الأولية (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"
  }
}

ملاحظات

يتطلب تثبيت حزمة النموذج background-removal (4-5 غيغابايت).
يستخدم birefnet-hr-matting كنموذج أساسي لمطّ ألفا عالي الجودة. يعود إلى birefnet-general إذا نفدت ذاكرة نموذج HR.
يزيل خيار defringe بكسلات الأطراف شبه الشفافة التي يتركها أحيانًا المطّ بالذكاء الاصطناعي حول الشعر والفراء والحواف الدقيقة. يعمل بتمويه قناة ألفا وتصفير البكسلات منخفضة الثقة.
يطبّق خيار removeWatermark خطوة معالجة مسبقة بمرشح وسيط. إنه خفض أساسي للعلامة المائية، وليس أداة مخصصة لإزالة العلامات المائية.
يُخرج ملفات PNG أو WebP عديمة الفقد فقط (كلاهما يدعم شفافية ألفا).
يدعم صيغ المدخلات HEIC/HEIF وRAW وTGA وPSD وEXR وHDR عبر فك الترميز التلقائي.

3.6 KiB Raw Blame History