biblioteca

list_photos

Lista as fotografias com id, nome de ficheiro, caminho, estado, pontuação, descrição e hora de captura.

O que faz

name encontra fotografias pelo nome do ficheiro, como as pessoas lhes chamam («DSC04851»): sem distinguir maiúsculas, corresponde a parte do nome e aceita vários nomes separados por vírgulas de uma só vez. Usa-o para converter os nomes que o utilizador menciona nos ids de fotografia que todas as outras ferramentas esperam. taken é a altura em que a fotografia foi tirada (hora ISO do EXIF): a forma de agrupar uma sessão por dia ou por serão («as fotografias do pôr do sol») quando não há descrição. taken_after / taken_before filtram por ela (ISO, inclusivo; uma data simples cobre o dia inteiro), por exemplo status="keep", taken_after="2026-09-22T18:00": numa sessão grande, filtra em vez de listar tudo. As horas de captura são lidas por analyze_photos, por isso executa-o antes de filtrar por hora; até lá, a nota da resposta indica quantas fotografias ainda não têm hora. Filtra por estado (pending, keep, trash, culled, exported, error) ou omite-o para tudo. Usa limit e offset para percorrer bibliotecas grandes; a resposta inclui a contagem total de correspondências. Os ids de fotografia desta lista são o que todas as ferramentas por fotografia esperam.

Parâmetros

NomeTipoObrigatório
status str | None opcional
limit int opcional
offset int opcional
taken_after str | None opcional
taken_before str | None opcional
name str | None opcional

Como pedi-la

Não a chamas pelo nome. Dizes o que queres e o agente escolhe a ferramenta:

Seleciona a sessão de casamento em D:/Shoots/eva_tom, mantém os melhores fotogramas e diz-me o que descartaste.

As restantes ferramentas de biblioteca

scan_directory get_library_stats get_photo get_preview_url get_job_status

Fluxos de trabalho que a usam

Onde corre

No teu computador. O servidor MCP do imagic é um processo local que o teu cliente de IA inicia; as fotografias nunca saem do teu disco e nada é carregado. Isto é verdade para todas as ferramentas da referência, incluindo esta.

Para a chamares, precisas de um cliente MCP ligado ao imagic. A configuração demora cerca de três minutos para o Claude Code, o Cursor, o VS Code, o Codex, o Gemini CLI e mais dez.

Dá à tua IA o fluxo completo

list_photos é uma de 30 ferramentas do imagic Max. A avaliação gratuita de 500 exportações inclui todas.