drolosoft/immich-photo-manager

Добавляет существующие активы в альбом. Используйте это для подбора альбомов из результатов поиска или других списков активов. Активы могут одновременно принадлежать нескольким альбомам. Побочный эффект: изменяет членство в альбоме. Аргументы: album_id: UUID целевого альбома. asset_ids: Список UUID активов для добавления в альбом. Возвращает: JSON с album_id, количеством добавленных элементов и деталями успеха/ошибки для каждого актива.

Создает новый альбом, опционально предварительно заполненный фотографиями. Используйте это, чтобы организовать фото в коллекции. Побочный эффект: создает новый альбом в Immich. Аргументы: name: Отображаемое имя альбома (например, 'Roma, Italia', 'Birthday 2024'). description: Необязательный текст описания альбома. asset_ids: Необязательный список UUID ресурсов, добавляемых сразу при создании. Возвращает: JSON с id, name и количеством ресурсов нового альбома.

Создаёт публичную общую ссылку для альбома и делает его доступным по URL без аутентификации. Используется для публикации галереи для внешнего просмотра. Побочный эффект: создаётся общедоступный URL. Аргументы: album_id: UUID альбома, который нужно опубликовать. allow_download: Разрешить посетителям скачивать исходные файлы (по умолчанию true). show_metadata: Показывать посетителям EXIF-данные (по умолчанию true). description: Необязательное читаемое описание для ссылки. Возвращает: JSON с идентификатором ссылки, ключом, идентификатором альбома и полным общедоступным URL.

Создаёт новый тег для категоризации ресурсов. Сначала используйте list_tags, чтобы избежать дубликатов. Побочный эффект: создаёт новый тег в Immich. Аргументы: name: Отображаемое имя тега (например 'Vacation', 'Family', 'Work'). Должно быть уникальным. color: Необязательный hex-цвет для тега (например '#FF5733'). Возвращает: JSON с id, name и color нового тега.

Удаляет контейнер альбома. Фотографии внутри НЕ удаляются, они остаются в библиотеке. Используйте это, чтобы удалить нежелательные группировки альбомов. Побочный эффект: безвозвратно удаляет альбом (отменить нельзя). Аргументы: album_id: UUID альбома для удаления. Возвращает: JSON с подтверждением удаления и album_id.

Удаляет активы (мягкое удаление в корзину или безвозвратное). Используйте для удаления ненужных фотографий/видео. По умолчанию — мягкое удаление (восстанавливается через restore_assets). При force=true удаление НАВСЕГДА и НЕОБРАТИМО. Побочный эффект: перемещает/удаляет активы. Аргументы: asset_ids: Список UUID активов для удаления. force: false (по умолчанию) = перемещение в корзину (восстанавливаемо). true = удаление НАВСЕГДА (без отмены). Возвращает: JSON с количеством удалённых и указанием, использовался ли force.

Удаляет (отзывает) общую ссылку, делая публичный URL немедленно недоступным. Альбом и его фотографии не затрагиваются. Побочный эффект: навсегда удаляет ссылку. Аргументы: link_id: UUID общей ссылки для удаления. Возвращает: JSON с подтверждением удаления и link_id.

Удаляет тег и удаляет его из всех ресурсов. Сами ресурсы не затрагиваются. Побочный эффект: полностью удаляет тег (отменить нельзя). Args: tag_id: UUID удаляемого тега. Returns: JSON с подтверждением удаления и tag_id.

Удаляет навсегда ВСЕ ресурсы, находящиеся в корзине. РАЗРУШИТЕЛЬНО и НЕОБРАТИМО. Используйте это только после подтверждения, что пользователь хочет очистить все удалённые элементы. Для удаления конкретных ресурсов используйте delete_assets. Побочный эффект: навсегда уничтожает все удалённые ресурсы и освобождает хранилище. Возвращает: JSON с подтверждением успеха.

Получает полную информацию о конкретном альбоме, включая все его идентификаторы ресурсов. Используйте этот инструмент для просмотра содержимого альбома или получения идентификаторов ресурсов для дальнейших операций (миниатюры, метаданные, поворот). Для получения списка всех альбомов используйте list_albums. Только чтение. Args: album_id: UUID альбома (из list_albums или create_album). Returns: JSON с метаданными альбома и плоским списком всех asset_ids в альбоме.

Получает миниатюры фотографий из альбома в кодировке base64. Используйте это, чтобы создавать визуальные HTML-галереи из существующего альбома. Для миниатюр из результатов поиска (без альбома) используйте get_thumbnails_batch. Только для чтения. Аргументы: album_id: UUID альбома. size: 'thumbnail' (250px) или 'preview' (1440px). По умолчанию: 'thumbnail'. limit: Максимум миниатюр к возврату (1-50, по умолчанию 20). Возвращает: JSON с информацией об альбоме и массивом миниатюр (каждая содержит asset_id, данные base64, имя файла, дату).

Получает все обнаруженные лица на фотографии с их привязкой к людям. Используйте это, чтобы увидеть, кто на конкретном фото, или найти ID лиц для reassign_face. Только для чтения. Аргументы: asset_id: UUID ресурса. Возвращает: JSON-массив обнаружений лиц (каждое содержит face_id, person_id, person_name, bounding box).

Получает полные метаданные для одного актива. Используйте это, когда вам нужны EXIF-детали, координаты GPS, информация о камере или свойства файла для известного ID актива. Для поиска активов используйте search_metadata или search_smart вместо этого. Только для чтения. Аргументы: asset_id: UUID актива (из результатов поиска, списков альбомов или list_assets). Возвращает: JSON с данными EXIF, GPS, датами, размерами, размером файла, маркой/моделью камеры и владельцем.

Получает изображение миниатюры в кодировке base64 для одного ресурса. Используйте это для визуального просмотра одного фото. Для нескольких фото используйте get_thumbnails_batch (по ID) или get_album_thumbnails (по альбому). Только чтение. Аргументы: asset_id: UUID ресурса. size: 'thumbnail' (250px, быстро) или 'preview' (1440px, более высокое качество). По умолчанию: 'thumbnail'. Возвращает: JSON с полями 'data' (строка в base64) и 'type' (MIME-тип, например 'image/jpeg').

Возвращает базовый URL Immich и маскированный ключ API. Использует это для заполнения заполнителей шаблона галереи (например, {{IMMICH_URL}}). Ключ API намеренно замаскирован в целях безопасности — миниатюры используют data URI в формате base64, а не прямые вызовы API. Только чтение. Возвращает: JSON с полями base_url и api_key_masked (только первые 8 и последние 4 символа).

Получает все группы дубликатов активов, обнаруженные ML. Используйте это для просмотра потенциальных дубликатов перед их разрешением с помощью resolve_duplicates. Требует сервис Immich ML. Только для чтения. Возвращает: JSON-массив групп дубликатов (каждая с duplicateId, массивом assets и оценками сходства).

Получает GPS-маркеры на карте для всех геотегированных ресурсов. Используйте это, чтобы узнать, где были сделаны фотографии, или для построения карт путешествий. Для поиска по названию города/страны используйте search_metadata вместо этого. Только для чтения. Возвращает до 500 маркеров. Аргументы: file_created_after: Нижняя граница даты в формате ISO (например, '2023-01-01'). file_created_before: Верхняя граница даты в формате ISO. is_favorite: Если true, возвращает только избранные. Возвращает: JSON с общим количеством и массивом маркеров (каждый с идентификатором ресурса, широтой, долготой).

Получает полную информацию о конкретном человеке, включая имя, дату рождения и количество фотографий. Используйте после того, как найдете человека через list_people или search_people. Только для чтения. Args: person_id: UUID человека (из list_people или search_people). Returns: JSON с информацией о человеке (id, name, birthDate, isHidden, photoCount, thumbnailPath).

Получает миниатюру лица в формате base64 для человека. Используйте её для визуального определения личности перед объединением или переименованием. Только чтение. Аргументы: person_id: UUID человека. Возвращает: JSON с полями 'data' (строка base64 части лица) и 'type' (MIME-тип).

Получает версию сервера Immich. Используйте это для проверки совместимости или чтобы сообщить работающую версию сервера. Только для чтения. Возвращает: JSON с номерами версий major, minor и patch.

Получает полные сведения об общей ссылке, включая разрешения, срок действия и связанные ресурсы. Проверяет конфигурацию конкретной ссылки. Только для чтения. Аргументы: link_id: UUID общей ссылки (из list_shared_links). Возвращает: JSON со сведениями о ссылке, разрешениями, датой истечения срока действия и связанными ресурсами/альбомом.

Получает статистику библиотеки. Используйте для быстрого обзора размера библиотеки без перечисления отдельных ресурсов. Только чтение. Возвращает: JSON с общим количеством фотографий, видео и объёмом хранилища в байтах.

Получает детали о конкретном теге. Используйте этот инструмент, чтобы просмотреть свойства тега. Только чтение. Аргументы: tag_id: UUID тега (из list_tags). Возвращает: JSON с id тега, именем, цветом и количеством использований.

Получает миниатюры в кодировке base64 для произвольных идентификаторов ресурсов без необходимости в альбоме. Используйте это для визуального отображения результатов поиска или любого произвольного набора фотографий. Для миниатюр на основе альбома используйте get_album_thumbnails. Для одной фотографии используйте get_asset_thumbnail. Только для чтения. Аргументы: asset_ids: Список UUID ресурсов, для которых нужно получить миниатюры. size: 'thumbnail' (250 пикселей) или 'preview' (1440 пикселей). По умолчанию: 'thumbnail'. limit: Максимальное количество возвращаемых миниатюр (1–50, по умолчанию 20). Будет обработано только первые N идентификаторов. Возвращает: JSON с массивом миниатюр (каждая содержит asset_id, данные в base64, имя файла, дату).

Перечисляет все альбомы в библиотеке с краткой информацией. Используйте эту возможность, чтобы узнать о существующих альбомах перед созданием новых или для поиска ID альбома. Только для чтения. Аргументы: shared: true = только общие альбомы, false = только не общие, опустить = все альбомы. Возвращает: JSON с общим количеством и массивом альбомов (каждый содержит id, name, description, assetCount, статус shared).

Выводит список ассетов с простыми фильтрами (поисковый запрос не требуется). Используйте для просмотра библиотеки по статусу (избранное, архивированные, удалённые) или типу. Для поиска конкретного содержимого используйте search_metadata (структурированный) или search_smart (визуальный ИИ). Только чтение. Аргументы: is_favorite: true = только избранные, false = только не избранные, omit = все. is_archived: true = только архивированные, false = только не архивированные, omit = все. is_trashed: true = только удалённые, false = только активные, omit = все. asset_type: 'IMAGE' или 'VIDEO'. Omit для обоих. page: Номер страницы, начиная с 1 (по умолчанию 1). size: Результатов на странице (1-200, по умолчанию 50). Возвращает: JSON с общим количеством, текущей страницей и массивом ассетов с идентификаторами, именами файлов, датами и типами.

Перечисляет всех распознанных людей (кластеры лиц) в библиотеке. Используйте это, чтобы просмотреть, кто изображён в фототеке, или найти ID человека. Для поиска по имени используйте search_people. Только чтение. Аргументы: page: номер страницы, начиная с 1 (по умолчанию 1). size: количество результатов на странице (по умолчанию 50). with_hidden: включать людей, отмеченных как скрытые (по умолчанию false). Возвращает: JSON с общим количеством (total count), страницей (page) и массивом людей (people), каждый из которых содержит id, name, thumbnailPath, photoCount.

Выводит список всех общих ссылок (публичных URL-адресов галереи). Используйте для просмотра того, что в данный момент опубликовано, или для поиска ID ссылки для обновления/удаления. Только чтение. Возвращает: JSON с общим количеством и массивом ссылок (каждая содержит id, key, type, description, album info).

Перечисляет все теги в библиотеке. Используйте это, чтобы найти существующие теги перед созданием новых или получить ID тега для операций тегирования. Только для чтения. Возвращает: JSON с общим количеством и массивом тегов (каждый содержит id, name, color).

Объединяет несколько кластеров людей в один. Используйте это, когда один реальный человек был разделён на несколько кластеров лиц. DESTRUCTIVE и IRREVERSIBLE: объединённые люди навсегда удаляются, а все их лица переносятся в целевой элемент. Аргументы: person_id: UUID целевого человека, который нужно сохранить (получает все объединённые лица). merge_ids: Список UUID людей, которые поглощаются целевым. Эти люди навсегда удаляются. Возвращает: JSON с деталями результата объединения.

Проверяет соединение с сервером Immich. Используйте для проверки доступности сервера перед выполнением других операций. Только чтение. Возвращает: JSON со статусом 'server' ('pong' если здоров).

Переназначает обнаруженное лицо другому человеку. Используйте для исправления ошибок распознавания лиц (например, лицо, ошибочно приписанное лицу А, должно быть лицом Б). Сначала получите face_id через get_asset_faces. Побочный эффект: навсегда изменяет связь лицо-человек. Аргументы: face_id: UUID обнаружения лица (из результатов get_asset_faces). person_id: UUID правильного человека, которому нужно назначить это лицо. Возвращает: JSON с обновлённым назначением лица.

Удаляет активы из альбома, не удаляя их сами. Фотографии остаются в библиотеке и других альбомах. Используйте это, чтобы отменить курирование ошибочно добавленных активов. Побочный эффект: изменяет состав альбома. Аргументы: album_id: UUID альбома, из которого нужно удалить активы. asset_ids: Список UUID активов, которые нужно удалить из этого альбома. Возвращает: JSON с album_id, количеством удалённых и деталями результата по каждому активу.

Разрешает дубликаты групп, выбирая, какие ассеты оставить, а какие отправить в корзину. Используйте этот инструмент после просмотра результатов get_duplicates. Ассеты в корзине можно восстановить через restore_assets. Побочный эффект: перемещает отклонённые дубликаты в корзину. Аргументы: groups: Список словарей, каждый с полями: duplicateId (из get_duplicates), assetIds (UUID для СОХРАНЕНИЯ), trashIds (UUID для УДАЛЕНИЯ). Возвращает: JSON с количеством разрешённых групп.

Восстанавливает конкретные активы из корзины обратно в активную библиотеку. Используйте этот инструмент для выборочного восстановления случайно удалённых фотографий. Для восстановления всего сразу используйте restore_trash. Побочный эффект: перемещает указанные активы из корзины. Аргументы: asset_ids: список UUID активов, находящихся в корзине, которые нужно восстановить. Возвращает: JSON с количеством восстановленных активов.

Восстанавливает ВСЕ удалённые активы обратно в библиотеку. Используйте это, чтобы отменить случайное массовое удаление. Для восстановления только определённых активов используйте restore_assets. Побочный эффект: перемещает все удалённые активы обратно в активную библиотеку. Возвращает: JSON с подтверждением успеха.

Удаляет все недеструктивные изменения (поворот, кадрирование, отражение) из активов, восстанавливая исходный вид. Используйте это, чтобы отменить rotate_assets или любые другие преобразования отображения. Укажите ЛИБО asset_ids, ЛИБО album_id. Побочный эффект: удаляет все записи правок для активов. Аргументы: asset_ids: Список UUID активов для восстановления. Взаимоисключающе с album_id. album_id: Восстанавливает все активы в этом альбоме. Взаимоисключающе с asset_ids. Возвращает: JSON с количеством восстановленных и неудавшихся операций.

Применяет неразрушающий поворот по часовой стрелке к одному или нескольким активам. Используйте это для исправления проблем с ориентацией. Исходный файл никогда не изменяется — поворот только меняет отображение. Используйте revert_asset_edits для отмены. Укажите ЛИБО asset_ids, ЛИБО album_id. Побочный эффект: записывает правки поворота в Immich; накапливается с существующим поворотом. Args: angle: градусы по часовой стрелке, должно быть кратно 90 (90, 180 или 270). По умолчанию: 90. asset_ids: список UUID активов для поворота. Взаимоисключающие с album_id. album_id: повернуть все активы в этом альбоме. Взаимоисключающие с asset_ids. Возвращает: JSON с количеством повёрнутых/неудачных и применённым углом.

Ищет активы по полям метаданных EXIF. Используйте этот инструмент, когда знаете конкретные критерии, например город, модель камеры или диапазон дат. Для запросов на естественном языке о визуальном содержимом (например, «закат на пляже») используйте `search_smart`. Для просмотра без критериев используйте `list_assets`. Только чтение. Аргументы: city: Название города из обратного геокодирования GPS EXIF (case-sensitive, например 'Barcelona'). state: Название штата или региона. country: Название страны (например 'Spain', 'Egypt'). make: Производитель камеры (например 'Apple', 'Canon', 'Sony'). model: Модель камеры (например 'iPhone 14 Pro', 'EOS R5'). taken_after: ISO date — возвращает только активы, снятые после этой даты. taken_before: ISO date — возвращает только активы, снятые до этой даты. is_favorite: Если true, возвращает только избранные. asset_type: 'IMAGE' или 'VIDEO'. Не указывайте для обоих. page: Номер страницы, начиная с 1 (по умолчанию 1). size: Результатов на странице (1-200, по умолчанию 50). Возвращает: JSON с общим количеством совпадений, текущей страницей и массивом активов с идентификаторами, именами файлов и датами.

Ищет людей по имени (частичное совпадение). Используйте этот инструмент, когда знаете имя человека. Для просмотра всех людей используйте list_people. Только чтение. Аргументы: name: Полное или частичное имя для поиска (без учёта регистра). with_hidden: Включает скрытых людей в результаты (по умолчанию false). Возвращает: JSON-массив подходящих людей с полями id, name и photo count.

Визуальный поиск на основе ИИ с использованием эмбеддингов CLIP. Используется, чтобы описать внешний вид фотографии на естественном языке (например, «закат на пляже», «собака играет в мяч»). Для структурированных критериев (город, камера, дата) используйте search_metadata. Требует сервис Immich ML с включённым Smart Search. Только чтение. Аргументы: query: Описание на естественном языке визуального содержимого для поиска. city: Необязательный фильтр города для географического сужения результатов. state: Необязательный фильтр штата/региона. country: Необязательный фильтр страны. taken_after: Дата в формате ISO — только снимки, сделанные после этой даты. taken_before: Дата в формате ISO — только снимки, сделанные до этой даты. page: Номер страницы, начиная с 1 (по умолчанию 1). size: Количество результатов на странице (1-200, по умолчанию 50). Возвращает: JSON с общим количеством, страницей и активами, отсортированными по визуальной схожести с запросом.

Применяет тег к нескольким ресурсам одновременно. Используйте это для массовой категоризации фотографий (например, отметить все фотографии с отпуска). Побочный эффект: добавляет связь тега с ресурсами. Аргументы: tag_id: UUID тега для применения (из list_tags или create_tag). asset_ids: Список UUID ресурсов для тегирования. Не должен быть пустым. Возвращает: JSON с tag_id, количество тегированных и результаты по каждому ресурсу.

Удаляет тег из нескольких активов. Сам тег остаётся; удаляется только связь. Побочный эффект: удаляет связи тега с активами. Аргументы: tag_id: UUID тега, который нужно удалить из активов. asset_ids: Список UUID активов, с которых нужно снять тег. Не может быть пустым. Возвращает: JSON с tag_id, количеством снятых тегов и результатами по каждому активу.

Обновляет название или описание альбома. Используйте это, чтобы переименовать или изменить описание существующего альбома. Побочный эффект: изменяет метаданные альбома в Immich. Аргументы: album_id: UUID альбома. name: Новое название альбома. Оставьте пустым, чтобы сохранить текущее название. description: Новое описание. Оставьте пустым, чтобы сохранить текущее описание. Возвращает: JSON с обновлённым объектом альбома.

Обновляет поля метаданных для конкретного ресурса. Используйте это, чтобы исправить даты, скорректировать GPS, добавить описания или изменить статус избранного/оценки. Изменяются только переданные поля. Побочный эффект: навсегда изменяет метаданные ресурса в Immich. Аргументы: asset_id: UUID ресурса. date_time_original: дата и время в формате ISO 8601 (например, '2019-07-14T15:23:41.000Z'). latitude: широта GPS, десятичные градусы (от -90.0 до 90.0). longitude: долгота GPS, десятичные градусы (от -180.0 до 180.0). description: произвольное текстовое описание/подпись для ресурса. is_favorite: устанавливает статус избранного (true/false). rating: рейтинг в звёздах (1-5) или null для сброса. Возвращает: JSON с обновлённым объектом ресурса.

Обновляет учётные данные подключения к Immich. Используйте это, когда API-ключ был сменён или изменился URL сервера. Проверяет учётные данные перед применением. Побочный эффект: сохраняет новые учётные данные на диск и заменяет активное подключение без перезапуска. Параметры: base_url: Полный URL сервера Immich, включая протокол (например, 'https://photos.example.com'). api_key: Действительный API-ключ Immich (создаётся в Immich > Настройки пользователя > API-ключи). Возвращает: JSON с статусом успеха, количеством фото/видео, подтверждающим доступ, и путём сохранения.

Обновляет данные профиля человека. Используйте, чтобы давать имена безымянным лицам, устанавливать даты рождения, скрывать лишние лица или менять основную миниатюру. Изменяются только указанные поля. Побочный эффект: обновляет метаданные человека в Immich. Аргументы: person_id: UUID человека. name: Отображаемое имя (например, 'Иван Петров'). Задайте имя для групп безымянных лиц. birth_date: Дата в формате ISO (например, '1990-05-15'). is_hidden: Скрыть из списка «Люди» (удобно для незнакомцев и лишних лиц). is_favorite: Отметить как избранного человека. feature_face_asset_id: UUID ресурса, чей фрагмент лица станет миниатюрой человека. color: Шестнадцатеричный цвет для группировки в интерфейсе. Возвращает: JSON с обновлённым объектом человека.

Обновляет разрешения или срок действия общей ссылки. Используйте это, чтобы усилить/ослабить доступ или установить дату истечения. Побочный эффект: немедленно изменяет поведение публичной ссылки. Аргументы: link_id: UUID общей ссылки. allow_download: Разрешает посетителям скачивать исходные файлы. show_metadata: Показывает метаданные EXIF посетителям. allow_upload: Разрешает посетителям загружать фотографии в общий альбом. description: Описание ссылки. Пустая строка очищает его. expiry_at: Дата и время истечения в формате ISO 8601. Пустая строка удаляет истечение (ссылка никогда не истекает). Возвращает: JSON с обновлённым объектом общей ссылки.

Обновляет имя или цвет тега. Побочный эффект: изменения применяются ко всем ресурсам, использующим этот тег. Аргументы: tag_id: UUID тега. name: Новое имя тега. Опустите, чтобы оставить текущее. color: Новый цвет в hex (например, '#FF5733'). Опустите, чтобы оставить текущий. Возвращает: JSON с обновлённым объектом тега.

Загружает локальную фотографию или видеофайл в Immich. Используется для добавления новых медиафайлов в библиотеку. Ограничения: макс. 25 МБ, разрешённые типы: jpg, jpeg, png, heic, mp4, mov, gif, webp. Символические ссылки отклоняются по соображениям безопасности. Исходный файл НЕ изменяется и НЕ удаляется. Побочный эффект: создаёт новый ресурс (asset) в Immich. Аргументы: file_path: Абсолютный путь к локальному файлу (напр. '/tmp/photo.jpg'). Файл должен существовать. album_id: Необязательный UUID альбома, в который нужно сразу добавить загружаемый ресурс. Возвращает: JSON с идентификатором нового ресурса, именем файла, размером в МБ и статусом назначения альбома, если применимо.