library

list_photos

Ilista ang mga larawan na may id, filename, path, status, score, description at oras ng pagkuha.

Ano ang ginagawa nito

Hinahanap ng name ang mga larawan ayon sa pangalan ng file, sa paraang tinutukoy ito ng mga tao (“DSC04851”): hindi case-sensitive, tumutugma sa bahagi ng pangalan, at tumatanggap ng ilang pangalang pinaghiwalay ng kuwit nang sabay-sabay. Gamitin ito para gawing photo id ang mga pangalang binabanggit ng user, ang id na inaasahan ng bawat ibang tool. Ang taken ay kung kailan kinunan ang larawan (ISO time mula sa EXIF): ang paraan para pangkatin ang shoot ayon sa araw o gabi (“ang mga kuha sa paglubog ng araw”) kapag walang description. Sinasala ito ng taken_after / taken_before (ISO, kasama ang hangganan; ang petsa lang ay sumasaklaw sa buong araw), halimbawa status="keep", taken_after="2026-09-22T18:00": sa malaking shoot, mag-filter sa halip na ilista ang lahat. Binabasa ng analyze_photos ang mga oras ng pagkuha, kaya patakbuhin ito bago mag-filter ayon sa oras; hanggang noon, sinasabi ng note ng sagot kung ilang larawan ang wala pang oras. Mag-filter ayon sa status (pending, keep, trash, culled, exported, error) o huwag maglagay para sa lahat. Gamitin ang limit at offset para mag-page sa malalaking library; kasama sa sagot ang kabuuang bilang ng tugma. Ang mga photo id mula sa listahang ito ang inaasahan ng bawat per-photo na tool.

Mga parameter

PangalanUriKinakailangan
status str | None opsyonal
limit int opsyonal
offset int opsyonal
taken_after str | None opsyonal
taken_before str | None opsyonal
name str | None opsyonal

Paghiling nito

Hindi mo ito tinatawag sa pangalan. Sabihin mo ang gusto mo, at ang agent ang pipili ng tool:

Piliin ang mga larawan sa wedding shoot sa D:/Shoots/eva_tom, itabi ang pinakamahuhusay na frame, at sabihin kung ano ang tinanggal mo.

Ang iba pang library na tool

scan_directory get_library_stats get_photo get_preview_url get_job_status

Mga workflow na gumagamit nito

Kung saan ito tumatakbo

Sa makina mo. Ang MCP server ng imagic ay lokal na proseso na sinisimulan ng AI client mo; hindi umaalis sa disk mo ang mga larawan at walang ina-upload. Totoo ito sa bawat tool sa reference, pati sa isang ito.

Para tawagin ito, kailangan mo ng MCP client na nakakonekta sa imagic. Mga tatlong minuto ang setup para sa Claude Code, Cursor, VS Code, Codex, Gemini CLI at sampung iba pa.

Ibigay sa AI mo ang buong pipeline

Ang list_photos ay isa sa 30 tool sa imagic Max. Kasama ang lahat ng ito sa libreng pagsubok na 500 export.