Bearbeitung

apply_adjustments

Setzt Reglerwerte des Editors für ein Foto oder dieselben Werte für mehrere.

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

NameTypPflicht
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“

list_presets apply_preset mask_adjust crop_photo save_preset export_photos get_photo_edits

Workflows, die es nutzen

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.