O que faz
Passe exatamente um entre photo_id (uma única foto, retorna {"photo_id", "adjustments"}) ou photo_ids (uma lista, aplica os mesmos ajustes a cada uma de forma independente e retorna {"results": [...], "applied", "failed"}, uma entrada por foto, para que um id ruim na lista não faça perder o resto do lote). adjustments mapeia nomes de controles para números, por exemplo {"exposure": 20, "contrast": 10, "temperature": 5}. Os controles, todos de -100..100, com 0 significando nenhuma mudança, salvo quando uma faixa é indicada: luz: exposure, contrast, highlights, shadows, whites, blacks cor: temperature, tint, vibrance, saturation e, por cor, hsl_hue_<c>, hsl_sat_<c>, hsl_lum_<c> para c em red, orange, yellow, green, aqua, blue, purple, magenta presença: texture, clarity, dehaze detalhe: 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 efeitos: vignette_amount, vignette_midpoint (10..90), grain_amount (0..100, grão de filme) looks: color_grade (uma chave de gradação de list_presets), color_grade_intensity (0..100), fx_preset (uma chave de preset experimental de list_presets, ou "none"), fx_amount (0..100) tone_curve_<luminance|red|green|blue>: uma lista de pontos [x, y] em 0..1 crop_x, crop_y, crop_w, crop_h (pixels) Para cortar por proporção sem contas de pixels, use crop_photo; para mudar só parte do quadro, use mask_adjust. Os valores são posições absolutas dos controles, e não deltas, e uma foto analisada que ninguém editou já está nos valores do seu preset de cena: para um pedido relativo (“um stop mais clara” = exposure +50, “um pouco mais quente”), leia o valor atual com get_photo_edits e some a ele. Os valores são limitados à faixa e nomes desconhecidos são rejeitados com a lista válida. Os novos valores sobrescrevem os anteriores por controle; os outros controles mantêm seus ajustes. Os controles funcionam do jeito do Lightroom: highlights negativo recupera áreas claras, exposure +50 é um stop. Uma foto editada no mecanismo legado do imagic é movida primeiro para o atual, mantendo o seu look, então esses valores significam o mesmo em qualquer foto.
Parâmetros
| Nome | Tipo | Obrigatório |
|---|---|---|
photo_id |
int | None |
opcional |
adjustments |
dict | None |
opcional |
photo_ids |
list[int] | None |
opcional |
Como pedir
Você não a chama pelo nome. Você diz o que quer, e o agente escolhe a ferramenta:
Aplique o look de filme quente a todas as escolhidas desta pasta e exporte JPEGs com qualidade 92.
As outras ferramentas de edição
Fluxos de trabalho que a usam
- Edite arquivos RAW em lote com um agente de IA — edição em lote de arquivos RAW com IA
Onde roda
Na sua máquina. O servidor MCP do imagic é um processo local que o seu cliente de IA inicia; as fotos nunca saem do seu disco e nada é enviado. Isso vale para todas as ferramentas da referência, inclusive esta.
Para chamá-la, você precisa de um cliente MCP conectado ao imagic. A configuração leva cerca de três minutos para Claude Code, Cursor, VS Code, Codex, Gemini CLI e outros dez.
Dê à sua IA o pipeline inteiro
apply_adjustments é uma das 25 ferramentas do imagic Max. O teste grátis de 500 exportações inclui todas elas.