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

4.0 KiB

Raw Blame History

description, i18n_source_hash, i18n_provenance, i18n_output_hash

description	i18n_source_hash	i18n_provenance	i18n_output_hash
Sharp ve AI yüz algılama kullanarak görüntüleri akıllıca çerçeveleyen özne, yüz ve entropi farkındalıklı kırpma.	acbe1439c6d8	human	a0cecd8b79a9

Akıllı Kırpma

Akıllı özne farkındalıklı, yüz farkındalıklı veya kırpma tabanlı kesme. Akıllı çerçeveleme için Sharp'ın dikkat/entropi stratejilerini ve AI yüz algılamayı kullanır.

API Uç Noktası

POST /api/v1/tools/image/smart-crop

İşleme: Eşzamansız (202 döner, durum için SSE aracılığıyla /api/v1/jobs/{jobId}/progress üzerinden sorgulanır)

Model paketi: face-detection (200-300 MB) - yalnızca face modu için gereklidir

Parametreler

Parametre	Tür	Zorunlu	Varsayılan	Açıklama
file	file	Evet	-	Görüntü dosyası (multipart)
mode	string	Hayır	`"subject"`	Kırpma modu: `subject`, `face`, `trim`. (Eski değerler `attention` ve `content`, `subject` ve `trim` değerlerine eşlenir)
strategy	string	Hayır	`"attention"`	Özne modu için strateji: `attention` veya `entropy`
width	integer	Hayır	-	Piksel cinsinden hedef genişlik
height	integer	Hayır	-	Piksel cinsinden hedef yükseklik
padding	integer	Hayır	`0`	Özne çevresindeki dolgu yüzdesi (0-50)
facePreset	string	Hayır	`"head-shoulders"`	Yüz çerçeveleme ön ayarı: `closeup`, `head-shoulders`, `upper-body`, `half-body`
sensitivity	number	Hayır	`0.5`	Yüz algılama duyarlılığı (0-1)
threshold	integer	Hayır	`30`	Arka plan algılama için kırpma modu eşiği (0-255)
padToSquare	boolean	Hayır	`false`	Kırpılmış sonucu bir kareye dolgu ile tamamla
padColor	string	Hayır	`"#ffffff"`	Dolgu için arka plan rengi
targetSize	integer	Hayır	-	Dolgulu çıktı için hedef boyut (piksel)
quality	integer	Hayır	-	Çıktı kalitesi (1-100)

Örnek İstek

curl -X POST http://localhost:1349/api/v1/tools/image/smart-crop \
  -F "file=@portrait.jpg" \
  -F 'settings={"mode":"face","width":1080,"height":1080,"facePreset":"head-shoulders"}'

Yanıt

İlk Yanıt (202 Accepted)

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

İlerleme (`/api/v1/jobs/{jobId}/progress` üzerinde SSE)

event: progress
data: {"phase":"processing","percent":50}

Nihai Sonuç (SSE aracılığıyla)

{
  "phase": "complete",
  "percent": 100,
  "result": {
    "jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "downloadUrl": "/api/v1/download/{jobId}/portrait_smartcrop.jpg",
    "originalSize": 500000,
    "processedSize": 320000
  }
}

Modlar

Özne Modu

Görsel olarak en ilgi çekici bölgeyi bulmak için Sharp'ın dikkat veya entropi stratejisini kullanır ve etrafında kırpar.

Yüz Modu

AI kullanarak yüzleri algılar, ardından belirtilen facePreset kullanarak kırpmayı algılanan yüzlerin etrafında çerçeveler. Hiçbir yüz algılanmazsa özne moduna (dikkat stratejisi) geri döner.

Kırpma Modu

Görüntüden düzgün kenarlıkları/arka planı kaldırır. İsteğe bağlı olarak sonucu belirtilen bir arka plan rengi ve hedef boyutla bir kareye dolgu ile tamamlar.

Notlar

Bu araç executionHint: "long" ile createToolRoute fabrikasını kullanır, bu nedenle SSE ilerlemesiyle 202 döner.
Yüz modu face-detection model paketini gerektirir (200-300 MB).
Özne ve kırpma modları herhangi bir AI model paketi olmadan çalışır.
facePreset değeri, kırpmanın algılanan yüzleri ne kadar sıkı çerçevelediğini belirler: closeup en sıkı, half-body en geniş olanıdır.
Genişlik/yükseklik belirtilmezse varsayılan olarak 1080x1080 kullanılır.

4.0 KiB Raw Blame History Unescape Escape