Was es tut
Übergeben Sie genau eines von photo_id (ein einzelnes Foto, liefert {"photo_id", "adjustments"}) oder photo_ids (eine Liste, wendet dieselben Anpassungen unabhängig auf jedes an und liefert {"results": [...], "applied", "failed"}, ein Eintrag pro Foto, sodass eine ungültige ID in der Liste den Rest des Stapels nicht verliert). adjustments ordnet Reglernamen Zahlen zu, zum Beispiel {"exposure": 20, "contrast": 10, "temperature": 5}. Die Regler, alle -100..100, wobei 0 keine Änderung bedeutet, sofern kein Bereich angegeben ist: light: exposure, contrast, highlights, shadows, whites, blacks colour: temperature, tint, vibrance, saturation, und pro Farbe hsl_hue_<c>, hsl_sat_<c>, hsl_lum_<c> für c in red, orange, yellow, green, aqua, blue, purple, magenta presence: texture, clarity, dehaze detail: sharp_amount (0..150), sharp_radius (10..200), nr_luminance (0..100), nr_color (0..100) split toning: split_shadow_hue, split_highlight_hue (0..360), split_shadow_sat, split_highlight_sat (0..100), split_balance effects: vignette_amount, vignette_midpoint (10..90), grain_amount (0..100, film grain) looks: color_grade (ein Grade-Schlüssel aus list_presets), color_grade_intensity (0..100), fx_preset (ein Schlüssel für ein experimentelles Preset aus list_presets oder "none"), fx_amount (0..100) tone_curve_<luminance|red|green|blue>: eine Liste von [x, y]-Punkten in 0..1 crop_x, crop_y, crop_w, crop_h (Pixel) Um nach Seitenverhältnis ohne Pixelrechnung zuzuschneiden, nutzen Sie crop_photo; um nur einen Teil des Bildes zu ändern, nutzen Sie mask_adjust. Werte sind absolute Reglerpositionen, keine Deltas, und ein analysiertes Foto, das niemand bearbeitet hat, steht bereits auf den Werten seines Szenen-Presets: Lesen Sie für eine relative Anfrage („eine Blende heller“ = exposure +50, „etwas wärmer“) den aktuellen Wert mit get_photo_edits und addieren Sie darauf. Werte werden auf den Bereich begrenzt, und unbekannte Namen werden mit der Liste der gültigen abgelehnt. Neue Werte überschreiben vorherige Werte pro Regler; andere Regler behalten ihre Einstellungen. Die Regler arbeiten wie in Lightroom: negative highlights holt helle Bereiche zurück, exposure +50 ist eine Blende. Ein Foto, das mit der älteren Engine von imagic bearbeitet wurde, wird zuerst auf die aktuelle umgestellt, wobei sein Look erhalten bleibt, sodass diese Werte auf jedem Foto dasselbe bedeuten.
Parameter
| Name | Typ | Pflicht |
|---|---|---|
photo_id |
int | None |
optional |
adjustments |
dict | None |
optional |
photo_ids |
list[int] | None |
optional |
So fragen Sie danach
Sie rufen es nicht beim Namen auf. Sie sagen, was Sie wollen, und der Agent wählt das Tool:
Wende den warmen Filmlook auf jeden Treffer in diesem Ordner an und exportiere JPEGs mit Qualität 92.
Weitere Tools der Gruppe „Bearbeitung“
Workflows, die es nutzen
- RAW-Dateien per KI-Agent im Stapel bearbeiten — RAW-Dateien per KI im Stapel bearbeiten
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
apply_adjustments ist eines von 25 Tools in imagic Max. Die kostenlose Testphase mit 500 Exporten enthält alle.