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.4 KiB

Raw Blame History

description, i18n_source_hash, i18n_provenance, i18n_output_hash

description	i18n_source_hash	i18n_provenance	i18n_output_hash
استعادة وتحسين حدّة الوجوه المشوّشة أو منخفضة الجودة في الصور باستخدام نموذجَي الذكاء الاصطناعي GFPGAN وCodeFormer.	7f9f6af8ebda	human	9fd7af07c413

Face Enhancement

استعِد وحسّن الوجوه في الصور باستخدام نماذج الذكاء الاصطناعي (GFPGAN/CodeFormer).

API Endpoint

POST /api/v1/tools/image/enhance-faces

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

حزم النماذج: upscale-enhance (5-6 غيغابايت) وface-detection (200-300 ميغابايت)

Parameters

Parameter	Type	Required	Default	Description
file	file	Yes	-	ملف الصورة (multipart)
model	string	No	`"auto"`	النموذج المستخدم: `auto`، `gfpgan`، `codeformer`
strength	number	No	`0.8`	قوة التحسين (0-1). القيم الأعلى تنتج تحسينًا أقوى
onlyCenterFace	boolean	No	`false`	تحسين الوجه الأكثر مركزية/بروزًا فقط
sensitivity	number	No	`0.5`	حساسية اكتشاف الوجه (0-1)

Example Request

curl -X POST http://localhost:1349/api/v1/tools/image/enhance-faces \
  -F "file=@portrait.jpg" \
  -F 'settings={"model":"codeformer","strength":0.7,"onlyCenterFace":false}'

Response

Initial Response (202 Accepted)

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

Progress (SSE at `/api/v1/jobs/{jobId}/progress`)

event: progress
data: {"phase":"processing","stage":"Enhancing faces...","percent":60}

Final Result (via SSE)

{
  "phase": "complete",
  "percent": 100,
  "result": {
    "jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "downloadUrl": "/api/v1/download/{jobId}/portrait_enhanced.png",
    "previewUrl": "/api/v1/download/{jobId}/preview.webp",
    "originalSize": 350000,
    "processedSize": 600000,
    "facesDetected": 2,
    "faces": [
      {"x": 120, "y": 80, "w": 100, "h": 100},
      {"x": 350, "y": 90, "w": 95, "h": 95}
    ],
    "model": "codeformer"
  }
}

Notes

يتطلب كلًّا من حزمة النموذج upscale-enhance (5-6 غيغابايت) وحزمة النموذج face-detection (200-300 ميغابايت).
ينتج GFPGAN تحسينًا أكثر حدّة؛ ويحافظ CodeFormer على الهوية بشكل أفضل. يختار auto أفضل نموذج للمدخل.
الإخراج دائمًا بصيغة PNG لأقصى جودة.
تُولَّد معاينة WebP إلى جانب الإخراج بدقّته الكاملة لعرض أسرع في الواجهة الأمامية.
يمزج المُعامِل strength الوجه المُحسَّن مع الأصل. استخدم القيم الأقل (0.3-0.5) للتحسينات الخفيفة، والقيم الأعلى (0.7-1.0) للاستعادة الأقوى.
يدعم صيغ الإدخال HEIC/HEIF وRAW وTGA وPSD وEXR وHDR عبر فكّ الشفرة التلقائي.

3.4 KiB Raw Blame History