pustaka

list_photos

Daftar foto dengan id, nama file, jalur, status, skor, deskripsi, dan waktu pengambilan.

Fungsinya

name menemukan foto berdasarkan nama file, seperti orang menyebutnya (“DSC04851”): tidak peka huruf besar-kecil, cocok dengan sebagian nama, dan menerima beberapa nama dipisah koma sekaligus. Gunakan untuk mengubah nama yang disebut pengguna menjadi id foto yang diharapkan setiap alat lain. taken adalah kapan foto diambil (waktu ISO dari EXIF): cara mengelompokkan pemotretan per hari atau per malam (“frame matahari terbenam”) ketika tidak ada deskripsi. taken_after / taken_before menyaring berdasarkan itu (ISO, inklusif; tanggal saja mencakup sepanjang hari), misalnya status="keep", taken_after="2026-09-22T18:00": pada pemotretan besar, saring, jangan mendaftar semuanya. Waktu pengambilan dibaca oleh analyze_photos, jadi jalankan dulu sebelum menyaring menurut waktu; sampai saat itu, catatan di respons menyatakan berapa banyak foto yang belum punya waktu. Saring menurut status (pending, keep, trash, culled, exported, error) atau abaikan untuk semuanya. Gunakan limit dan offset untuk menelusuri pustaka besar; respons menyertakan jumlah total yang cocok. Id foto dari daftar ini adalah yang diharapkan setiap alat per foto.

Parameter

NamaTipeWajib
status str | None opsional
limit int opsional
offset int opsional
taken_after str | None opsional
taken_before str | None opsional
name str | None opsional

Cara memintanya

Anda tidak memanggilnya dengan nama. Anda mengatakan apa yang diinginkan, dan agen memilih tool-nya:

Seleksi pemotretan pernikahan di D:/Shoots/eva_tom, simpan frame terbaik, dan beri tahu saya apa yang Anda buang.

Tool pustaka lainnya

scan_directory get_library_stats get_photo get_preview_url get_job_status

Alur kerja yang memakainya

Di mana ia berjalan

Di komputer Anda. Server MCP imagic adalah proses lokal yang dijalankan klien AI Anda; foto tidak pernah meninggalkan disk Anda dan tidak ada yang diunggah. Itu berlaku untuk setiap tool dalam referensi, termasuk yang ini.

Untuk memanggilnya, Anda memerlukan klien MCP yang terhubung ke imagic. Penyiapan memakan waktu sekitar tiga menit untuk Claude Code, Cursor, VS Code, Codex, Gemini CLI, dan sepuluh lainnya.

Beri AI Anda seluruh pipeline

list_photos adalah salah satu dari 30 tool di imagic Max. Uji coba gratis 500 ekspor mencakup semuanya.