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

Ознакомьтесь со всеми последними функциями и обновлениями Meshy API и плагинов.

Июнь 2026

`Jun 17`

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

`Jun 15`

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

`Jun 12`

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

`Jun 5`

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

`Jun 1`

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

Май 2026

`May 26`

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

`May 22`

Функциональность Конвертировать и Изменить размер из API Ремешинга теперь доступна как отдельные endpoint API Конвертировать и API Изменить размер. Устаревшие параметры в Ремешинге продолжат работать для обратной совместимости.

`May 13`

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

`May 12`

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

`May 11`

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

`May 7`

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

Апрель 2026

`Apr 27`

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

`Apr 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 для endpoint Изображение в 3D и Мульти-изображение в 3D. Ссылайтесь напрямую на результат завершенной задачи Текст в изображение или Изображение в изображение вместо передачи image_url / image_urls. Если указаны оба варианта, input_task_id имеет приоритет.

`Apr 20`

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

`Apr 14`

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

`Apr 12`

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

Март 2026

`Apr 2`

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

`Mar 20`

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

`Mar 17`

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

Февраль 2026

`Feb 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.

`Feb 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). Параметр был разработан для устаревших моделей (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.

`Jan 12`

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

Декабрь 2025

`31 дек.`

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

`22 дек.`

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

`Dec 04`

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

Ноябрь 2025

`Nov 24`

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

`Nov 06`

API уточнения Текст в 3D теперь поддерживает ai_model = latest, что соответствует Meshy 6 Preview.
API Изображение в 3D теперь по умолчанию использует текстурирование Meshy-6-preview, когда ai_model = latest и should_texture = true.
API Мульти-изображение в 3D теперь поддерживает ai_model = latest, по умолчанию используя Meshy-6-preview для текстурирования, при этом генерация сетки остается Meshy-5.
API Ретекстурирование добавляет опцию latest для ai_model (Meshy-6-preview) и теперь по умолчанию использует ее, если параметр не указан.

`Nov 04`

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

Октябрь 2025

`Oct 28`

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

`Oct 20`

Добавлен необязательный логический параметр convert_format_only в 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.

`Sep 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 для endpoint'ов Текст в 3D, Изображение в 3D, Мульти-изображение в 3D и Ретекстурирование.

Июнь 2025

`Jun 25`

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

`Jun 19`

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

`17 июня`

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

`Jun 10`

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

Май 2025

`May 20`

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

`May 15`

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

Апрель 2025

`29 апр.`

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

`Apr 17`

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

Март 2025

`Mar 28`

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

`Mar 14`

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

`Mar 06`

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

Февраль 2025

`Feb 18`

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

`Feb 13`

Критические изменения:
- Создание задач на бесплатном уровне завершится March 20, 2025. После этого для всех запросов задач API потребуется платная подписка. Чтобы сохранить бесперебойный доступ, рекомендуем перейти на платный тариф до крайнего срока.
- Используйте код купона APIACCESS, чтобы получить скидку 40%. Спасибо, что вы с нами!
Добавлены потоковые эндпоинты Server-Sent Events (SSE) для обновлений задач в реальном времени:

`Feb 6`

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

Январь 2025

`Jan 23`

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

`Jan 14`

API Legacy Текст в 3D и Изображение в 3D, работающие на моделях ИИ Meshy-3, объявлены устаревшими.

`Jan 07`

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

Декабрь 2024

`Dec 19`

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

`Dec 12`

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

`Dec 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

`Nov 14`

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