Список картинок и видео в папке: имя, размер в пикселях, вес файла.

folder: абсолютный путь к папке. recursive: искать и во вложенных папках.

Обзор референса: картинка целиком, размеры, формат и кадры, если это лист из нескольких видов.

Начинай работу с референсом с этого инструмента. Если найдено несколько кадров, они обведены пурпурными рамками с номерами, а их координаты перечислены в тексте.

path: абсолютный путь к картинке.

Разрезает лист (коллаж, turnaround) на отдельные кадры и показывает каждый крупно.

Кадры ищутся автоматически: по однотонным промежуткам между ними или по швам, если кадры склеены встык. Если кадр один — показывает объект без пустых полей. Мелкие кадры увеличиваются.

path: абсолютный путь к картинке. max_edge: потолок длинной стороны каждого кадра в px, от 200 до 2000 (по умолчанию 1024).

Показать картинку или её область крупно, в максимальном качестве, которое Claude примет без пережатия.

path: абсолютный путь к картинке (png, jpg, webp, bmp, gif, tiff). region: [x1, y1, x2, y2] в пикселях оригинала — показать только эту область. Мелкая область увеличивается. mode: "normal" — как есть; "contrast" — локальный контраст (фаски, швы, рельеф в тенях и бликах); "edges" — чёрные контуры на бледной подложке (силуэт и линии формы); "tones" — 5 уровней яркости (плоскости света и тени — читать объём). max_edge: потолок длинной стороны в px, от 200 до 2576. По умолчанию 2000 — так картинка не упрётся в лимит, когда в разговоре больше 20 картинок.

Возвращает картинку и текст с формулой перевода координат в пиксели оригинала.

Несколько картинок на одном листе с подписями — сравнить виды рядом одной картинкой.

Экономит лимит: в разговоре с больше чем 20 картинками каждая должна быть не больше 2000 px.

paths: абсолютные пути, от 1 до 12 картинок. labels: подписи к картинкам (столько же, сколько путей). По умолчанию — номер и имя файла. mode: как в view — "normal", "contrast", "edges", "tones".

Отделить объект от фона и измерить силуэт: рамка, пропорции, части, отверстия, ключевые высоты.

Показывает объект на бледном фоне с пурпурным контуром маски — проверь глазами, всё ли вошло.

view: «путь», «путь|N» (кадр N листа из inspect), «путь|0» (вся картинка) или «путь|x1,y1,x2,y2» (область оригинала). method: "auto" — нейросеть BiRefNet (тени, отражения, сложный фон); "simple" — по цвету фона, только для однотонного фона; "ai" — только нейросеть.

Выровнять виды как на чертеже: фон убран, высота объекта одинаковая, низ на одной линии.

Пурпурные пунктирные линии — низ (0 %), верх (100 %) и ключевые высоты первого вида (где резко меняется ширина силуэта): по ним видно, совпадают ли детали между видами. Вид сверху/снизу подгоняется по ширине вида спереди/сзади. В тексте — размеры, пропорции и несостыковки между видами.

views: от 1 до 8 видов: «путь», «путь|N» (кадр N листа из inspect), «путь|0» (вся картинка) или «путь|x1,y1,x2,y2». labels: что это за виды — front/спереди, back/сзади, left/слева, right/справа, side/сбоку, top/сверху, bottom/снизу, 3-4. С подписями сервер проверяет пары (спереди ↔ сзади, слева ↔ справа, глубина сбоку ↔ сверху). method: способ убрать фон, как в silhouette.

Сохранить выровненные виды в PNG с прозрачным фоном + views.json — для подложек в Blender / C4D.

У всех видов одинаковая высота объекта в пикселях (вид сверху/снизу — по ширине вида спереди/сзади). В views.json для каждого вида: размер картинки, где на ней объект, низ-центр объекта; если задана real_height — размер картинки в единицах сцены и смещение её центра от низа-центра объекта.

views: виды, как в align_views. folder: абсолютный путь к папке (создаётся, файлы перезаписываются). labels: подписи видов (front, back, left, right, side, top, bottom, 3-4) — попадут в имена файлов. real_height: настоящая высота объекта в единицах сцены (например 0.2 для 20 см в метрах). method: способ убрать фон, как в silhouette.

Сетка координат поверх вида — снимать размеры и положение деталей по подписанным линиям.

view: «путь», «путь|N» (кадр листа), «путь|0» или «путь|x1,y1,x2,y2» — сетку удобно класть на область крупно. step: шаг сетки в пикселях оригинала (units="px"); по умолчанию — круглый, ~10 линий по длинной стороне. units: "px" — подписи в пикселях оригинала; "percent" — сетка по рамке объекта: 0–100 % ширины слева направо и 0–100 % высоты снизу вверх, линии через 5 % (толще — 0, 50, 100 %). mode: подложка как в view — "normal", "contrast", "edges", "tones". method: способ найти объект для units="percent", как в silhouette.

Нарисовать свои точки и линии на виде и получить точные числа — проверка себя вместо оценки на глаз.

Показывает область вокруг отметок крупно. Для каждой линии — длина в px, в % высоты и ширины объекта, угол; для каждой точки — положение в % рамки объекта. Если отметка легла не туда — поправь и вызови снова.

view: «путь», «путь|N», «путь|0» или «путь|x1,y1,x2,y2». Координаты точек и линий — пиксели оригинала. points: [[x, y], ...]. lines: [[x1, y1, x2, y2], ...]. labels: подписи точек (по умолчанию P1, P2, …). snap: "none"; "silhouette" — притянуть точки и концы линий к ближайшему краю силуэта (до 12 px); "edges" — к ближайшему резкому перепаду внутри объекта (край детали, шов, фаска). method: способ найти объект (для процентов и snap="silhouette"), как в silhouette.

Контур силуэта точками и вертикальная ось симметрии — в координатах сцены, готово для кривых в Blender.

Координаты: начало на оси симметрии у низа объекта, x вправо, z вверх. Единица — высота объекта (1.0), или единицы сцены, если задана real_height. Внешний контур и отверстия — отдельными списками.

view: «путь», «путь|N», «путь|0» или «путь|x1,y1,x2,y2». detail: точность упрощения — доля диагонали объекта (0.003 по умолчанию; меньше — больше точек). half: только правая половина внешнего контура от верха до низа — профиль для тела вращения (Screw). real_height: настоящая высота объекта в единицах сцены. save_to: абсолютный путь к .json — сохранить контуры, чтобы прочитать их кодом в Blender. method: способ найти объект, как в silhouette.

Основные цвета объекта для материалов: HEX, sRGB 0..1 и линейные 0..1, доля площади.

Цвета сняты с освещением: блики и тени попадают отдельными цветами. Базовый цвет материала — обычно самый частый средний тон, а не самый светлый или тёмный.

view: «путь», «путь|N», «путь|0» или «путь|x1,y1,x2,y2» (например, только одна деталь). colors: сколько цветов, от 1 до 12. whole: True — считать по всей области вместе с фоном, без вырезки объекта. method: способ найти объект, как в silhouette.

Сравнить рендер модели с референсом того же ракурса: совпадение силуэтов в % и где именно расходятся.

Силуэт рендера выравнивается по высоте и низу силуэта референса (масштаб модели в сцене не важен — важны пропорции). В тексте: совпадение (IoU — доля общей площади), где модель шире или уже по полосам высоты, чего не хватает и что лишнее, сдвиг ключевых высот. Правь модель и вызывай снова, пока совпадение не станет высоким.

reference: вид референса — «путь», «путь|N» (кадр листа), «путь|0» или «путь|x1,y1,x2,y2». render: файл рендера того же ракурса (лучше ортографическая камера; прозрачный фон — силуэт точный). mode: "all" — референс, модель и разница рядом; "side" — только референс и модель; "diff" — только разница; "overlay" — наложение 50/50. method: способ найти объект на референсе (и на рендере без прозрачности), как в silhouette.

Сравнить сразу несколько ракурсов: по строке на ракурс — референс, модель, разница — и % совпадения каждого.

references и renders — пары одного ракурса в одинаковом порядке (до 6 пар). Виды референса — как в compare. labels: названия ракурсов (front, side, top…). method: способ найти объект, как в silhouette.

Выделить детали объекта по своим точкам и рамкам (нейросеть SAM 2.1) и измерить каждую.

Посмотри на вид, поставь точку в середину детали (или несколько точек, или рамку box вокруг неё) — сервер вернёт маску детали цветом с номером и числа: размер и место в % рамки всего объекта, площадь, куски, отверстия, наклон длинной оси, цвет. Одна точка неоднозначна (деталь, её часть или весь объект) — если выделилось не то, добавь точки, рамку или точки exclude на соседних деталях и вызови снова с тем же именем.

Выделенные детали запоминаются: вид «путь|имя» (для листа «путь|N|имя») дальше работает с одной деталью в silhouette, contour (half — профиль детали), palette, mark, grid (percent — сетка по детали), align_views (одна деталь на разных видах). compare_parts — сравнение модели с референсом по деталям.

view: «путь», «путь|N» (кадр листа), «путь|0» или «путь|x1,y1,x2,y2». parts: до 12 деталей: [{"name": "чашка", "points": [[x, y]], "exclude": [[x, y]], "box": [x1, y1, x2, y2]}], координаты — пиксели оригинала. Надёжнее всего — 2–3 точки на детали и exclude на соседних деталях того же цвета; для одной точки есть pick: "small" | "medium" | "large". method: способ найти весь объект (для процентов), как в silhouette.

Сравнить модель с референсом по деталям: совпадение каждой детали в %, где она шире, уже, сдвинута, наклонена.

Общий % силуэта не замечает ошибок в мелких деталях — здесь каждая деталь сравнивается отдельно. Модель выравнивается по всему объекту (высота и низ, как в compare), поэтому сдвиг детали тоже виден.

reference: вид референса, на котором уже выделены детали через parts (тот же «путь» или «путь|N»). render: карта деталей того же ракурса — рендер, где каждый объект залит своим плоским цветом, фон прозрачный, рядом JSON с цветами объектов. Как сделать в Blender — в описании сервера (blender_kit.render_parts); render_parts возвращает, какие объекты видны с этой камеры. match: какие объекты модели — какая деталь референса: {"чашка": ["shell", "cushion_L"], "вилка": ["yoke"]}. По умолчанию — объекты с тем же именем, что и деталь. method: способ найти весь объект на референсе, как в silhouette.