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
تكبير الصور من 2x إلى 4x بدقة فائقة من Real-ESRGAN بالذكاء الاصطناعي مع الحفاظ على التفاصيل الدقيقة.	150032e99476	human	f469cd14aa46

تكبير الصورة

تحسين بدقة فائقة بالذكاء الاصطناعي باستخدام Real-ESRGAN. يكبّر الصور من 2x إلى 4x مع الحفاظ على التفاصيل.

نقطة نهاية API

POST /api/v1/tools/image/upscale

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

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

المعاملات

المعامل	النوع	مطلوب	الافتراضي	الوصف
file	file	نعم	-	ملف الصورة (متعدد الأجزاء)
scale	number	لا	`2`	عامل التكبير (مثل 2، 3، 4)
model	string	لا	`"auto"`	النموذج المراد استخدامه (مثل `auto`، أسماء نماذج محددة)
faceEnhance	boolean	لا	`false`	تطبيق تحسين الوجه أثناء التكبير
denoise	number	لا	`0`	قوة خفض الضوضاء (0 = معطّل)
format	string	لا	`"auto"`	صيغة المخرجات: `auto`، `png`، `jpg`، `webp`، `tiff`، `gif`، `avif`، `heic`، `heif`، `jxl`
quality	number	لا	`95`	جودة المخرجات (1-100)

مثال طلب

curl -X POST http://localhost:1349/api/v1/tools/image/upscale \
  -F "file=@photo.jpg" \
  -F 'settings={"scale":4,"model":"auto","faceEnhance":true,"format":"png"}'

الاستجابة

الاستجابة الأولية (202 Accepted)

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

التقدّم (SSE على `/api/v1/jobs/{jobId}/progress`)

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

النتيجة النهائية (عبر SSE)

{
  "phase": "complete",
  "percent": 100,
  "result": {
    "jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "downloadUrl": "/api/v1/download/{jobId}/photo_4x.png",
    "previewUrl": "/api/v1/download/{jobId}/preview.webp",
    "originalSize": 120000,
    "processedSize": 2400000,
    "width": 4096,
    "height": 4096,
    "method": "realesrgan-x4plus"
  }
}

ملاحظات

يتطلب تثبيت حزمة النموذج upscale-enhance (5-6 غيغابايت).
يستخدم Real-ESRGAN عند توفره؛ ويعود إلى استيفاء Lanczos إذا لم يكن نموذج الذكاء الاصطناعي متاحًا.
يطبّق خيار faceEnhance استعادة الوجه بـ GFPGAN أثناء التكبير للحصول على جودة وجه أفضل.
بالنسبة لصيغ المخرجات التي يتعذّر معاينتها في المتصفح (HEIC، JXL، TIFF)، تُولَّد معاينة WebP إلى جانب المخرجات الرئيسية.
يدعم صيغ المدخلات HEIC/HEIF وRAW وTGA وPSD وEXR وHDR عبر فك الترميز التلقائي.

3.4 KiB Raw Blame History