Cosa fa
Passa esattamente uno tra photo_id (una singola foto, restituisce {"photo_id", "adjustments"}) e photo_ids (un elenco, applica le stesse regolazioni a ciascuna in modo indipendente e restituisce {"results": [...], "applied", "failed"}, una voce per foto così un id sbagliato nell'elenco non fa perdere il resto del batch). adjustments associa i nomi dei cursori a numeri, per esempio {"exposure": 20, "contrast": 10, "temperature": 5}. I cursori, tutti da -100 a 100 con 0 che significa nessuna modifica, salvo diverso intervallo indicato: luce: exposure, contrast, highlights, shadows, whites, blacks colore: temperature, tint, vibrance, saturation, e per ogni colore hsl_hue_<c>, hsl_sat_<c>, hsl_lum_<c> con c tra red, orange, yellow, green, aqua, blue, purple, magenta presenza: texture, clarity, dehaze dettaglio: sharp_amount (0..150), sharp_radius (10..200), nr_luminance (0..100), nr_color (0..100) viraggio: split_shadow_hue, split_highlight_hue (0..360), split_shadow_sat, split_highlight_sat (0..100), split_balance effetti: vignette_amount, vignette_midpoint (10..90), grain_amount (0..100, grana della pellicola) look: color_grade (una chiave di grade da list_presets), color_grade_intensity (0..100), fx_preset (una chiave di preset sperimentale da list_presets, oppure "none"), fx_amount (0..100) tone_curve_<luminance|red|green|blue>: un elenco di punti [x, y] in 0..1 crop_x, crop_y, crop_w, crop_h (pixel) Per ritagliare per proporzioni senza calcoli in pixel, usa crop_photo; per modificare solo una parte dell'inquadratura, usa mask_adjust. I valori sono posizioni assolute dei cursori, non variazioni, e una foto analizzata che nessuno ha modificato si trova già ai valori del suo preset di scena: per una richiesta relativa («uno stop più luminosa» = exposure +50, «un po' più calda»), leggi il valore attuale con get_photo_edits e aggiungici sopra. I valori vengono limitati all'intervallo e i nomi sconosciuti vengono rifiutati con l'elenco di quelli validi. I nuovi valori sovrascrivono quelli precedenti per ogni cursore; gli altri cursori mantengono le loro impostazioni. I cursori funzionano come in Lightroom: highlights negativo recupera le zone chiare, exposure +50 è uno stop. Una foto modificata con il motore legacy di imagic viene prima portata su quello attuale, mantenendo il suo look, così questi valori hanno lo stesso significato su ogni foto.
Parametri
| Nome | Tipo | Obbligatorio |
|---|---|---|
photo_id |
int | None |
opzionale |
adjustments |
dict | None |
opzionale |
photo_ids |
list[int] | None |
opzionale |
Come chiederlo
Non lo richiami per nome. Dici cosa vuoi e l'agente sceglie lo strumento:
Applica il look film caldo a ogni foto tenuta in questa cartella ed esporta JPEG con qualità 92.
Gli altri strumenti di editing
Flussi di lavoro che lo usano
- Modifica in batch file RAW con un agente AI — modificare in batch file RAW con l'AI
Dove gira
Sul tuo computer. Il server MCP di imagic è un processo locale avviato dal tuo client AI; le foto non lasciano mai il tuo disco e nulla viene caricato. Vale per ogni strumento del riferimento, questo compreso.
Per richiamarlo serve un client MCP collegato a imagic. La configurazione richiede circa tre minuti per Claude Code, Cursor, VS Code, Codex, Gemini CLI e altri dieci.
Dai alla tua AI l'intera pipeline
apply_adjustments è uno dei 25 strumenti di imagic Max. La prova gratuita da 500 esportazioni li include tutti.