Bearbeitung

mask_adjust

Maskiert einen Teil eines Fotos (Motiv, Himmel, Personen oder Hintergrund) und passt nur diesen Teil an (lokale Anpassungen).

Was es tut

target ist "subject", "sky", "people" oder "background": imagic findet den Bereich mit derselben Maskierung, die der Desktop-Editor nutzt (ein bis zwei Sekunden pro Foto, auf diesem Rechner). Subject, people und background nutzen ein Segmentierungsmodell: Ohne es fällt subject auf eine grobe GrabCut-Schätzung zurück und people schlägt fehl, und background ist die Umkehrung von subject. Sky nutzt kein Modell, nur eine Farb- und Positionsheuristik, die mit GrabCut verfeinert wird, prüfe also die zurückgegebene Abdeckung. adjustments nimmt dieselben Reglernamen wie apply_adjustments, zum Beispiel {"exposure": 15, "clarity": 10} auf dem Motiv und {"exposure": -20, "saturation": -15} auf dem Hintergrund, um beide zu trennen. Schlüssel auf Bildebene (crop, rotation, fx_preset) werden abgelehnt; setzen Sie diese mit apply_adjustments. mode "relative" (Standard) addiert die Werte auf den aktuellen Look des Fotos, wie eine Lightroom-Maske. mode "isolated" rendert den Bereich aus dem Original nur mit diesen Werten, sodass spätere globale Bearbeitungen ihn nicht mehr beeinflussen (der Ebenen-Standard des Editors). Jede Ebene wird als Maskenebene des Editors gespeichert, benannt nach dem Ziel (oder name): Exporte enthalten sie, und das Foto öffnet sich im Editor erneut mit der Ebene als eigenem Tab. Ein erneuter Aufruf mit demselben Ziel oder name ersetzt diese Ebene, statt eine weitere zu stapeln; remove=true löscht sie. Übergeben Sie photo_id für ein Foto oder photo_ids für mehrere (jedes erhält seine eigene Maske). Liefert die Abdeckung der Maske (Anteil des Bildes) und die Ebenenliste des Fotos; get_photo_edits listet ebenfalls Ebenen auf. Bei einer Remote-Verbindung läuft ein langer Stapel als Hintergrundauftrag: Fragen Sie get_job_status mit der zurückgegebenen job_id ab.

Parameter

NameTypPflicht
target str erforderlich
adjustments dict | None optional
photo_id int | None optional
photo_ids list[int] | None optional
mode str optional
name str | None optional
remove bool optional

So fragen Sie danach

Sie rufen es nicht beim Namen auf. Sie sagen, was Sie wollen, und der Agent wählt das Tool:

Öffne mit imagic mein Shooting und sag mir, was du findest.

Weitere Tools der Gruppe „Bearbeitung“

list_presets apply_preset list_luts apply_lut apply_auto_color harmonize_series preview_mosaic apply_adjustments crop_photo save_preset export_photos get_photo_edits

Wo es läuft

Auf Ihrem Rechner. Der MCP-Server von imagic ist ein lokaler Prozess, den Ihr KI-Client startet; die Fotos verlassen nie Ihre Festplatte, und nichts wird hochgeladen. Das gilt für jedes Tool der Referenz, auch für dieses.

Um es aufzurufen, brauchen Sie einen mit imagic verbundenen MCP-Client. Die Einrichtung dauert etwa drei Minuten für Claude Code, Cursor, VS Code, Codex, Gemini CLI und zehn weitere.

Geben Sie Ihrer KI die ganze Pipeline

mask_adjust ist eines von 30 Tools in imagic Max. Die kostenlose Testphase mit 500 Exporten enthält alle.