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

Raw Blame History

description, i18n_source_hash, i18n_provenance, i18n_output_hash

description	i18n_source_hash	i18n_provenance	i18n_output_hash
إزالة الكائنات غير المرغوبة من الصور بالطلاء التصحيحي بالذكاء الاصطناعي (LaMa)، بتوجيه من قناع للمنطقة المراد محوها.	8e2e42a5e4f9	human	be557633a7a0

Object Eraser

أزِل الكائنات غير المرغوبة من الصور بالطلاء التصحيحي بالذكاء الاصطناعي (نموذج LaMa). يقبل صورة وقناعًا يشير إلى المنطقة المراد محوها.

API Endpoint

POST /api/v1/tools/image/erase-object

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

حزمة النموذج: object-eraser-colorize (1-2 غيغابايت)

Parameters

Parameter	Type	Required	Default	Description
file	file	Yes	-	ملف الصورة المصدر (multipart)
mask	file	Yes	-	صورة القناع (الأبيض = المنطقة المراد محوها، الأسود = الاحتفاظ). يجب رفعها باسم الحقل `mask`
format	string	No	`"auto"`	صيغة الإخراج: `auto`، `png`، `jpg`، `jpeg`، `webp`، `tiff`، `gif`، `avif`، `heic`، `heif`، `jxl`
quality	integer	No	`95`	جودة الإخراج (1-100)

Example Request

curl -X POST http://localhost:1349/api/v1/tools/image/erase-object \
  -F "file=@photo.jpg" \
  -F "mask=@mask.png" \
  -F "format=png" \
  -F "quality=95"

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":"Inpainting...","percent":70}

Final Result (via SSE)

{
  "phase": "complete",
  "percent": 100,
  "result": {
    "jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "downloadUrl": "/api/v1/download/{jobId}/photo_erased.png",
    "previewUrl": "/api/v1/download/{jobId}/preview.webp",
    "originalSize": 245000,
    "processedSize": 230000
  }
}

Notes

يتطلب تثبيت حزمة النموذج object-eraser-colorize (1-2 غيغابايت).
يجب أن يكون القناع بالأبعاد نفسها للصورة المصدر. البكسلات البيضاء تشير إلى المناطق المراد محوها؛ يملؤها الذكاء الاصطناعي بمحتوى معقول.
يستخدم LaMa (Large Mask Inpainting) لإزالة الكائنات بجودة عالية.
لصيغ الإخراج غير القابلة للمعاينة في المتصفح، تُولَّد معاينة WebP إلى جانب الإخراج الرئيسي.
يدعم صيغ الإدخال HEIC/HEIF وRAW وTGA وPSD وEXR وHDR عبر فكّ الشفرة التلقائي.

3.1 KiB Raw Blame History