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, gibt {"photo_id", "adjustments"} zurück) oder photo_ids (eine Liste, wendet dieselben Anpassungen auf jedes Foto unabhängig an und gibt {"results": [...], "applied", "failed"} zurück, ein Eintrag pro Foto, sodass eine fehlerhafte ID in der Liste nicht den Rest des Stapels verloren gehen lässt). 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, Filmkorn) looks: color_grade (ein Grade-Schlüssel aus list_presets), color_grade_intensity (0..100), fx_preset (ein experimenteller Preset-Schlüssel aus list_presets oder "none"), fx_amount (0..100), auto_color (0..100, Stärke von Auto Color; siehe apply_auto_color), auto_color_mode ("color" oder "contrast"), lut_name (eine LUT aus list_luts oder "none"), lut_strength (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, verwenden Sie crop_photo; um nur einen Teil des Bildes zu ändern, verwenden Sie mask_adjust. Die Werte sind absolute Reglerpositionen, keine Deltas, und ein analysiertes Foto, das noch niemand bearbeitet hat, steht bereits auf den Werten seines Szenen-Presets: Für eine relative Anforderung ("a stop brighter" = exposure +50, "a bit warmer") lesen Sie den aktuellen Wert mit get_photo_edits und addieren darauf. Werte werden auf den Bereich begrenzt, und unbekannte Namen werden mit der Liste der gültigen Namen abgelehnt. Neue Werte überschreiben die vorherigen pro Regler; die übrigen Regler behalten ihre Einstellungen. Die Regler arbeiten wie in Lightroom: Negative highlights holen helle Bereiche zurück, exposure +50 entspricht einer Blende. Ein Foto, das mit imagics veralteter Engine bearbeitet wurde, wird zuerst auf die aktuelle umgestellt und behält dabei seinen Look, sodass diese Werte bei 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 list_luts apply_lut apply_auto_color harmonize_series preview_mosaic 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 30 Tools in imagic Max. Die kostenlose Testphase mit 500 Exporten enthält alle.