Журнал изменений

Все новейшие функции и обновления Meshy API и плагинов.

Июль 2026

`Jul 27`

Новый Creative Lab — API фигурки из кубиков: превратите фотографию в коллекционную 3D-минифигурку в стиле конструктора. Тот же двухэтапный процесс, что и в API фигурки — prototype (6 кредитов) генерирует стилизованное концептуальное изображение, build (30 кредитов) превращает его в текстурированную 3D-модель с выводом GLB и OBJ + MTL. Полные цены см. в разделе Цены.

`Jul 21`

Теперь мы поддерживаем 8K-текстуры базового цвета с помощью нового параметра texture_resolution (2k / 4k / 8k) в конечных точках Изображение в 3D, Мульти-изображение в 3D, Текст в 3D Refine и Ретекстурирование. При 8k PBR-карты генерируются в 4K, а карта emission не создаётся. Генерация текстур 8K стоит 15 кредитов (2k/4k остаются 10). См. Цены.
Булев параметр hd_texture устарел в пользу texture_resolution. Для обратной совместимости он по-прежнему поддерживается и эквивалентен texture_resolution: "4k".

`Jul 20`

Новая Creative Lab — Vinyl Figure API: превратите фотографию в виниловую фигуру-коллекционную игрушку с большой головой. Тот же двухэтапный рабочий процесс, что и Figure API — prototype (6 кредитов) генерирует стилизованное концептуальное изображение, build (30 кредитов) превращает его в текстурированную 3D модель с выводом в GLB и OBJ + MTL. Полный перечень смотрите в разделе Цены.

`13 июля`

В API Изображение в 3D добавлен новый model_type Smart Topology, предлагающий две модели через ai_model: meshy-t1 — текущая низкополигональная модель — и meshy-t2 — новая модель с более чистой topology, с нативно разделёнными частями, выводом треугольников и количеством граней, которое можно установить с помощью target_polycount. meshy-t2 является моделью по умолчанию в рамках smart-topology. Существующий model_type: lowpoly теперь является устаревшим, но продолжает поддерживать трафик для обратной совместимости.

`Jul 7`

Добавлен параметр aspect_ratio в API Изображение в изображение, так что вы можете контролировать соотношение сторон выходного изображения при редактировании. Допустимые значения: 1:1, 16:9, 9:16, 4:3, 3:4 для моделей nano-banana и 1:1, 3:2, 2:3 для gpt-image-2. Необязательный параметр; по умолчанию 1:1, и не может быть использован вместе с generate_multi_view.

Июнь 2026

`17 июня`

Новая страница документации API Playground: интерактивная консоль для тестирования endpoint’ов без написания кода с возможностью копирования эквивалентного cURL, Python или JavaScript. Доступно на планах Pro, Premium, Ultra, Studio и Enterprise.

`15 июня`

Новая UV-развёртка API: создание высококачественной UV-раскладки для существующей 3D-модели — необходимый шаг перед текстурированием или в любое время, когда нужна чистая, не перекрывающаяся UV-раскладка для последующих инструментов. Требуется либо input_task_id (завершенная задача Изображение в 3D, Текст в 3D, или Ремешинг), либо model_url (.glb только), и возвращает "UV белую модель" с совершенно новыми UV-координатами. 5 кредитов за вызов. Поддерживает сетки до 40 000 граней (если больше, сначала выполните Ремешинг); четверные и n-угольные сетки триангулируются во время генерации UV.

`Июн 12`

Обновлены цены на сборку Creative Lab API до 30 кредитов за вызов для брелок, магнит на холодильник и фигурка (ранее 20). лампа остается без изменений на уровне 30 кредитов. Цена за прототип остается без изменений — 6 кредитов за изображение. См. Цены для полного разбора.

`5 июня`

Добавлен необязательный параметр alpha_thumbnail в API Изображение в 3D, Мульти-изображение в 3D, Текст в 3D, Ретекстурирование, Ремешинг и Восстановление пригодности к печати. Если установлен в true, задача дополнительно создает версию предпросмотра с прозрачным фоном (RGBA) и возвращает ее в новом поле ответа alpha_thumbnail_url. Существующий thumbnail_url остается без изменений. По умолчанию установлено в false.

`Jun 1`

Новые Creative Lab API: серия продуктовых endpoint, которые превращают исходное фото (или текстовый prompt) в потребительский продукт, готовый к 3D-печати. Четыре продукта при запуске — брелок, магнит на холодильник, фигурка и лампа. Каждый следует двухэтапному рабочему процессу prototype → build, соединённому через input_task_id, обслуживающемуся под продуктовыми URL-адресами (/openapi/creative-lab/<product>/v1/...) с версионностью для каждого продукта, чтобы продукты могли развиваться по независимым линиям версий. Прототип: 6 кредитов за вызов. Сборка: 30 кредитов за вызов.

Май 2026

`26 мая`

Добавлен параметр multi_view_thumbnails в API Мульти-изображение в 3D. Когда установлен в true, задача дополнительно генерирует эскизы с четырёх основных видов (спереди, справа, сзади, слева) и возвращает их в новом поле ответа thumbnail_urls. Существующее поле thumbnail_url остаётся без изменений. Добавляет примерно 3 секунды к задержке задачи.

`22 Мая`

Функции Конвертировать и Изменить размер из Remesh API теперь доступны как самостоятельные endpoint'ы: Convert API и Resize API. Устаревшие параметры в Remesh продолжат работать для обеспечения обратной совместимости.

`13 мая`

Добавлен параметр multi_view_thumbnails в API Изображение в 3D. Если установлен в значение true, задача дополнительно рендерит миниатюры с четырех сторон (спереди, справа, сзади, слева) и возвращает их в новом ответном поле thumbnail_urls. Существующее поле thumbnail_url остается без изменений. Добавляет около 3 секунд к задержке задачи.

`12 мая`

Добавлен параметр resize_longest_side в API Ремешинг. Изменяет размер модели так, чтобы самая длинная размерность ограничивающего объема была равна указанному значению в метрах. Взаимоисключающий с resize_height и auto_size.

`11 мая`

Устаревший параметр symmetry_mode на Текст в 3D, Изображение в 3D и Мульти-изображение в 3D endpoints. Этот параметр больше не влияет на результат.

`7 мая`

Новый API анализа пригодности к печати: Анализировать успешно выполненную задачу Meshy — или любой URL 3D-модели — на готовность к FDM 3D-печати. Асинхронное создание + потоковая передача: POST возвращает task_id, затем GET / SSE поток возвращает метрики водонепроницаемости, объема, отверстий и немногообразных рёбер после SUCCEEDED. Бесплатно, кредиты не расходуются.
Новый API восстановления пригодности к печати: Восстанавливать 3D-модель для пригодности к FDM печати — исправлять немногообразные рёбра, вырожденные грани, отверстия и другие проблемы topology. Принимает существующий input_task_id Meshy или model_url (.glb, .stl, .obj). Формат вывода соответствует формату входных данных. 10 кредитов за задачу.

Апрель 2026

`Apr 27`

Добавлено поле consumed_credits для всех ответов на задачи во всех API эндпоинтах. Показывает количество кредитов, использованных каждой задачей. Поле присутствует для задач в статусах PENDING, IN_PROGRESS и SUCCEEDED. Возвращает 0 для задач со статусом FAILED (кредиты автоматически возвращаются при ошибке). См. Цены для стоимости кредитов на эндпоинт.

`24 апр`

Добавлен параметр model_url к эндпоинту многоцветная печать. Отправьте текстурированную 3D модель напрямую (через URL или Data URI) вместо input_task_id из предыдущей задачи Meshy. Поддерживаемые форматы: .glb, .fbx. Если указаны оба model_url и input_task_id, приоритет имеет input_task_id.

`Apr 21`

Добавлен параметр input_task_id в endpoints Изображение в 3D и Мульти-изображение в 3D. Ссылайтесь на результат выполненной задачи Текст в изображение или Изображение в изображение напрямую, вместо предоставления image_url / image_urls. Когда оба параметра заданы, input_task_id имеет приоритет.

`Апр 20`

Добавлен параметр hd_texture в endpoints Изображение в 3D, Мульти-изображение в 3D, Текст в 3D Refine и Ретекстурирование. Когда включено, текстура базового цвета создается в разрешении 4K (4096×4096) для более высокого уровня детализации. Поддерживается только для meshy-6 и latest. По умолчанию установлено false.
PBR пакет, возвращаемый, когда enable_pbr установлено в true, теперь включает карту emission в texture_urls для задач meshy-6 и latest в Изображение в 3D, Мульти-изображение в 3D, Текст в 3D Refine и Ретекстурирование. Изменения запроса не требуются.

`14 апреля`

Добавлен параметр decimation_mode в Изображение в 3D, Мульти-изображение в 3D, Текст в 3D Превью и Ремешинг endpoints. Устанавливает уровень адаптивного числа полигонов: 1 (ультра), 2 (высокий), 3 (средний) или 4 (низкий).

`Apr 12`

Переструктурирована документация по API: добавлена группировка параметров с зависимыми полями, встроенными значениями по умолчанию, значками обязательных/устаревших, расширяемая суб-навигация, а также разбиты Multi-Image, Rigging и Анимация на отдельные страницы.

Март 2026

`2 апреля`

Добавлена поддержка формата 3mf в параметре target_formats для всех endpoint (Изображение в 3D, Текст в 3D, Ремешинг, Ретекстурирование). Примечание: 3MF доступен только по запросу и должен быть явно указан.
Новый API многоцветной печати: Конвертировать 3D модели в многоцветный формат 3MF для 3D-печати. Поддерживает палитры от 1 до 16 цветов с настраиваемой точностью. 10 кредитов за задачу.

`Mar 20`

Устаревшая модель Meshy-4 AI больше не поддерживается. Все API запросы, использующие meshy-4, больше не поддерживаются. Пожалуйста, перейдите на meshy-6 или latest.
Добавлены параметры auto_size и origin_at в endpoints Изображение в 3D, Мульти-изображение в 3D, Текст в 3D, и Ремешинг. Когда auto_size включен, служба использует AI vision для оценки реальной высоты и автоматически изменяет размер модели. origin_at задает положение начала координат (bottom или center). В API Ремешинг auto_size и resize_height взаимно исключают друг друга.

`Mar 17`

Добавлен необязательный параметр target_formats в эндпоинты Изображение в 3D, Мульти-изображение в 3D, Текст в 3D, и Ретекстурирование. Укажите, какие 3D форматы нужно генерировать (например, ["glb", "fbx"]), чтобы сократить время выполнения задачи.

Февраль 2026

`28 февраля`

Добавлен параметр remove_lighting в API Изображение в 3D, Мульти-изображение в 3D, Текст в 3D уточнение и Ретекстурирование. Удаляет блики и тени из текстуры основного цвета для более чистых результатов при использовании пользовательского освещения. Поддерживается только для meshy-6 и latest. По умолчанию установлено значение true.
API Ретекстурирование и Текст в 3D уточнение теперь поддерживают meshy-6 в качестве значения ai_model для полной текстуризации с использованием Meshy 6.

`Feb 25`

Добавлен параметр image_enhancement в API Изображение в 3D и Мульти-изображение в 3D для пользователей, которые хотят отказаться от оптимизации входных изображений и сохранить точный вид своего ввода. Поддерживается только для meshy-6 и latest. По умолчанию true.

`20 февраля`

Добавлен параметр model_type в API Предварительный просмотр Текст в 3D для создания низкополигональных мешей, оптимизированных для более чистых полигонов.

Январь 2026

`Jan 27`

Добавлена подробная документация режимов отказов для всех Эндпоинты API, включая общие коды ошибок HTTP (400, 401, 402, 404, 422, 429) и причины сбоев задач. Это помогает разработчикам лучше понимать и обрабатывать Ошибки API.

`Jan 26`

API Мульти-изображение в 3D теперь поддерживает Meshy-6 для полной генерации сетки. Параметр ai_model теперь принимает meshy-6, и latest разрешается в Meshy 6.

`Jan 22`

Устаревшее art_style для API Текст в 3D Preview (Meshy-6). Параметр был разработан для legacy моделей (Meshy-4 / Meshy-5) и будет удален в будущем выпуске.
Устаревшее enable_pbr для API Текст в 3D и Изображение в 3D, когда ai_model это meshy-4. Этот параметр будет удален в будущем выпуске.
Обновлено значение по умолчанию параметра should_remesh для Meshy-6 в API Текст в 3D и Изображение в 3D. Теперь параметр по умолчанию false для meshy-6 и true для других моделей, если не указано иное.

`Jan 19`

Опция latest для ai_model в API Текст в 3D (Предварительная версия) и Изображение в 3D теперь разрешается в Meshy 6.

`12 января`

Добавлен новый параметр model_type в API Изображение в 3D для создания низкополигональных сеток, оптимизированных для более чистых полигонов.

Декабрь 2025

`31 декабря`

Запущен API Playground, специальное пространство для разработчиков, чтобы исследовать параметры API и тестировать запросы непосредственно на сайте Meshy.
Представлены API Текст в изображение и API Изображение в изображение, которые позволяют создавать изображения на основе текстовых подсказок и редактировать изображения с использованием референсных изображений на базе ИИ. Оба API поддерживают модели nano-banana и nano-banana-pro с опциональной генерацией мультивида.

`Дек 22`

Поле video_url в ответе API Текст в 3D теперь устаревшее и будет удалено в будущем выпуске.

`Дек 04`

Добавлен новый параметр pose_mode к API Текст в 3D Просмотр, Изображение в 3D и Мульти-изображение в 3D. Этот параметр принимает a-pose, t-pose или пустую строку (по умолчанию). Параметр is_a_t_pose теперь устаревшее в пользу pose_mode.

Ноябрь 2025

`24 ноя`

Изображение в 3D и Мульти-изображение в 3D API добавляют необязательный параметр save_pre_remeshed_model и открывают доступ к model_urls.pre_remeshed_glb, когда запрашивается резервная копия до ремешинга.

`Nov 06`

Text to 3D Refine API теперь поддерживает ai_model = latest, что означает Meshy 6 Preview.
Image to 3D API теперь по умолчанию использует текстурирование Meshy-6-preview, когда ai_model = latest и should_texture = true.
Multi-Image to 3D API теперь поддерживает ai_model = latest, выполняя текстурирование Meshy-6-preview по умолчанию, в то время как генерация сетки остается на Meshy-5.
Retexture API добавляет опцию latest для ai_model (Meshy-6-preview) и теперь по умолчанию применяется, если она опущена.

`04 ноября`

API Ремешинга теперь сохраняет текстуры для загруженных моделей.
API Ретекстурирования теперь сохраняет текстуры для загруженных моделей, когда включен параметр enable_original_uv.

Октябрь 2025

`28 октября`

Добавлен заголовок ответа x-api-version для указания текущей версии серверной части API.

`20 Окт`

Добавлен необязательный параметр boolean convert_format_only в Remesh API для поддержки только преобразования формата входного файла модели.
Добавлен rigged_character_glb_url в ответ Объект задания присоединения скелета.

`Oct 01`

Удалить API text-to-voxel

Сентябрь 2025

`Sep 23`

Добавлена опция latest для ai_model в API Текст в 3D для использования Meshy 6 Preview.
Временная скидка 50% на задачи по генерации Meshy-6-preview до 10 кредитов, которая будет действовать до 30 сентября 2025 года. После периода скидки стоимость задач Meshy-6-preview вернется к обычной 20 кредитам.

`Sep 18`

Обновлены цены API для Текст в 3D и Изображение в 3D, чтобы отразить разные цены для Meshy 6 и других моделей.

`Sep 16`

Добавлена опция latest для ai_model в API Изображение в 3D для использования Meshy 6 Preview.

`4 сентября`

Расширена поддержка ввода model_url для .glb, .gltf, .obj, .fbx, .stl для Ремешинг и Ретекстурирование.

Август 2025

`Aug 18`

Добавлен необязательный параметр is_a_t_pose в API Текст в 3D Превью, Изображение в 3D и Мульти-изображение в 3D для генерации моделей в позе A/T.

`Aug 13`

Meshy 5 теперь стабилен для Текст в 3D и Изображение в 3D (ai_model: meshy-5), обеспечивая улучшенное качество и согласованность.

Июль 2025

`Jul 31`

Поддержка текстур PBR в API через параметр enable_pbr для последней модели meshy-5 для Текст в 3D, Изображение в 3D, Мульти-изображение в 3D и Ретекстурирование endpoint.

Июнь 2025

`Jun 25`

Добавлено API Ретекстурирования, которое позволяет пользователям проводить ретекстурирование 3D моделей на основе последних моделей ИИ от Meshy.

`19 июня`

Добавлены API для удаления для Текст в 3D, Изображение в 3D, Ремешинг, Rigging и Анимация.
Добавлен параметр ai_model к API для уточнения Текст в 3D.

`Jun 17`

Добавлена документация для Webhooks.

`Июн 10`

Ремешинг API теперь поддерживает модели в формате GLB, закодированные в base64, в параметре model_url через Data URI.

Май 2025

`20 мая`

Добавлен необязательный параметр moderation в API Текст в 3D для предпросмотра, Текст в 3D для уточнения, Изображение в 3D и Мульти-изображение в 3D. При включении входной контент автоматически проверяется на наличие потенциально вредоносного содержимого перед генерацией.

`15 мая`

Представлен API автоматического rigging и Анимации, позволяющий пользователям автоматически создавать rig и анимировать 3D модели. Подробнее о Rigging и Анимации.

Апрель 2025

`29 апреля`

Представлен API Мульти-изображение в 3D, позволяющий генерировать 3D модели из 1 до 4 входных изображений с использованием AI-модели meshy-5.
Добавлен вариант AI-модели meshy-5 в API Текст в 3D и Изображение в 3D. Теперь тег latest также разрешается в meshy-5.

`17 апреля`

Добавлен параметр texture_image_url в API Изображение в 3D и Текст в 3D Refine, что позволяет пользователям управлять процессом генерации текстур с помощью изображения.

Март 2025

`Mar 28`

Добавлен параметр latest в API Текст в 3D и Изображение в 3D, что позволяет получить доступ к нашим предстоящим продвинутым моделям AI для улучшения качества генерации.

`14 марта`

API Текст в текстуру теперь поддерживает модели, закодированные в base64, в параметре model_url через Data URI, аналогично image_url в API Изображение в 3D.

`Mar 06`

Обновлены цены для задач генерации API:
- Текст в 3D (Предварительный просмотр): Увеличено с 2 до 5 кредитов за вызов
- Текст в 3D (Уточнение): Увеличено с 5 до 10 кредитов за вызов
- Изображение в 3D: Теперь 5 кредитов без текстуры, 15 кредитов с текстурой
- Текст в текстуру: Увеличено с 5 до 10 кредитов за вызов
- Текст в воксель: Остается на уровне 5 кредитов за вызов

Февраль 2025

`Feb 18`

Добавлен API-ключ тестового режима msy_dummy_api_key_for_test_mode_12345678, который позволяет разработчикам тестировать интеграцию API без расхода кредитов. Все допустимые запросы, использующие этот ключ, будут возвращать те же результаты примеров задач.

`Feb 13`

Значительные изменения:
- Создание задач на бесплатном уровне завершится 20 марта 2025. После этого все запросы на задачи API потребуют платную подписку. Чтобы обеспечить бесперебойный доступ, мы рекомендуем обновить подписку до истечения срока.
- Используйте код купона APIACCESS, чтобы получить скидку 40%. Спасибо, что остаетесь с нами!
Добавлены endpointы потоковой передачи SSE для обновлений задач в реальном времени:

`6 февраля`

Добавлен параметр texture_prompt в API Изображение в 3D и Текст в 3D Refine, позволяющий пользователям управлять процессом генерации текстуры с помощью текстового prompt.

Январь 2025

`23 января`

Добавлены endpoints для перечисления задач в Текст в 3D, Изображение в 3D, Ремешинг и Текст в текстуру API.

`14 января`

Устаревшие API устаревшего Текст в 3D и Изображение в 3D, поддерживаемые моделями AI Meshy-3.

`Jan 07`

Добавлен параметр symmetry_mode в API Предпросмотр «Текст в 3D» и Изображение в 3D, позволяющий настраивать параметры симметрии.

Декабрь 2024

`19 декабря`

Добавлены Remesh APIs, которые позволяют пользователям выполнять Ремешинг и экспортировать существующие 3D-модели, сгенерированные другими API Meshy, в различные форматы.
Обновлены пределы числа полигонов для наших API до диапазона от 100 до 300,000 для пользователей с премиум-аккаунтами.

`Dec 12`

Помечено как устаревшее свойство model_url во всех объектах ответа.
Отделен Legacy API Meshy-3 от последнего API Meshy-4.

`10 декабря`

Добавлен параметр enable_pbr в API Изображение в 3D и Текст в 3D (Уточнение).
Добавлен параметр should_texture в API Изображение в 3D.
Устаревшее опция pbr в параметре art_style для API Текст в 3D (Предпросмотр) при использовании AI модели meshy-4.
Устаревшее опция low-poly в параметре art_style для API Текст в 3D (Предпросмотр).

`Dec 5`

Добавлен API получения баланса для пользователей, чтобы они могли узнать свой баланс кредитов.
Добавлен параметр should_remesh в API Изображение в 3D и Предпросмотр Текста в 3D.

`Dec 3`

Внешние API теперь используют префикс /openapi. Пути Legacy по-прежнему поддерживаются, но мы рекомендуем перейти на новые пути.

Ноябрь 2024

`14 ноя`

API Изображение в 3D теперь поддерживает изображения, кодированные в base64.