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

Здесь собраны все последние функции и обновления Meshy API и плагинов.

Сентябрь 2026

Sep 3

  • API Creative Lab Lamp на этапе прототипирования теперь возвращает 3D-модель: POST /prototype превращает изображение концепта в полый абажур в формате GLB, а объект задачи прототипа получает model_urls.glb и thumbnail_url наряду с image_urls. Этап сборки запускает только процессор лампы для этой модели и теперь создаёт абажур с открытым дном и опорной пластиной для источника света. Цены изменяются соответственно: прототип стоит 30 кредитов, а сборка — 6 кредитов (ранее было 6 и 30). Параметр text для прототипа удалён — теперь обязателен image_url.

Sep 1

  • В API Мульти-изображение в 3D добавлен параметр ultra_mode: включает генерацию Ultra для ai_model meshy-7 (или latest) для получения более точной геометрии с более детальной проработкой поверхности, за дополнительные 5 кредитов — тот же режим Ultra, что предлагает API Изображение в 3D, теперь доступный и для мультивидовых входных данных.
  • Значение meshy-t1 удалено из задокументированных значений ai_model для model_type Smart Topology в API Изображение в 3D. Теперь в документации Smart Topology указан только meshy-t2; новым интеграциям следует использовать именно его. Meshy T1 планируется к прекращению поддержки — если ваша интеграция в настоящее время отправляет ai_model: "meshy-t1", перейдите на meshy-t2.

Август 2026

Aug 28

  • Добавлен Usage API для команд Studio и Enterprise: программный экспорт исторических данных об использовании API-задач — эндпоинт, статус, временные метки, API-ключ, выполнивший каждую задачу, и consumed_credits — со стандартной пагинацией и фильтрами по временному диапазону, эндпоинту и статусу, для учёта затрат и финансовых систем.

Aug 26

  • Animation API теперь принимает motion_task_id — вы можете применить клип движения, созданный с помощью Text to Motion API, к вашему двуногому персонажу с готовым риггингом, в качестве альтернативы предустановленному action_id. Стоимость та же — 3 кредита за задачу.

Aug 24

Aug 21

  • Добавлен Text to Motion API: создание клипа движения персонажа на основе описания на естественном языке, модель персонажа не требуется. Выберите mode prime (10 кредитов, вывод в FBX) для максимального качества или mode swift (3 кредита, вывод в BVH) для быстрой и экономичной генерации, с длительностью клипа от 2 до 10 секунд.

Aug 20

  • Добавлен параметр style в Multi-Color Print API: выберите realistic (по умолчанию) для точной передачи цветов текстуры или cartoon для плоских однородных цветовых областей и меньшего размера 3MF.
  • Добавлен параметр remove_background в каждый эндпоинт прототипов Creative Lab — Figure, Vinyl Figure, Brick Figure, Keycap, Keychain, Fridge Magnet и Lamp. Установите remove_background: true, чтобы получить изображение прототипа в виде прозрачного PNG в формате RGBA с удалённым фоном.

Aug 18

  • В API Мульти-изображение в 3D добавлен параметр texture_image_urls: можно указать от 1 до 4 изображений одного и того же объекта для управления текстурированием вместо одного texture_image_url. Требует ai_model meshy-7 или latest и не зависит от image_urls — эти два списка могут содержать разные изображения и разное количество изображений.

Aug 17

Aug 13

  • В API Текст в 3D добавлен ai_model: "meshy-7": наша новейшая модель генерации 3D с более высокой точностью геометрии, чем Meshy 6. Она также вводит параметр ultra_mode для задачи предпросмотра, который включает генерацию Ultra для ещё более тонкой детализации поверхности за 5 дополнительных кредитов. Чтобы наложить текстуру с помощью Meshy 7, передайте ai_model: "meshy-7" в задаче доработки (refine) или полностью опустите параметр ai_model.
  • В API Текст в 3D добавлен model_type Smart Topology. Установите model_type: "smart-topology", чтобы генерировать с помощью meshy-t2 — более чистая topology, изначально разделённые части, вывод в виде треугольников и количество граней, которое можно задать с помощью target_polycount (от 100 до 15 000, по умолчанию 4 000). Предпросмотр Smart Topology стоит 5 кредитов вместо 20; см. Цены. Существующий model_type: "lowpoly" теперь является устаревшим, но по-прежнему обслуживает запросы для обратной совместимости.

12 авг

  • Добавлен ai_model: "meshy-7" в Image to 3D API: наша новейшая модель генерации 3D, обеспечивающая более высокую точность геометрии по сравнению с Meshy 6. Также в неё добавлен параметр ultra_mode, который включает генерацию Ultra для ещё более детальной проработки поверхности.
  • Добавлен ai_model: "meshy-7" в Multi-Image to 3D API: модель генерации Meshy на основе мультивида, которая учитывает все входные изображения одновременно и использует их для текстурирования.
  • Добавлен ai_model: "meshy-7" в Retexture API: наша новейшая модель текстурирования, обеспечивающая более чёткую детализацию поверхности и более чистые PBR-материалы по сравнению с Meshy 6. Также в неё добавлен параметр multiview_image_urls — предоставьте от 1 до 4 упорядоченных изображений одного и того же объекта для текстурирования на основе мультивида.

Aug 4

July 2026

Jul 27

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

Jul 22

  • Новый Creative Lab — Keycap API: превращает фото в полноцветную кастомную клавишу механической клавиатуры. Двухэтапный процесс — prototype (12 кредитов) создаёт рендер готового дизайна клавиши, затем build (50 кредитов) превращает выбранный вами дизайн (через candidate_id) в текстурированную 3D-модель клавиши с выходными файлами GLB и OBJ в комплекте, экспортированными в реальном масштабе в миллиметрах. На данный момент поддерживается стандартное основание Cherry MX 1u (cherry-mx-1x1-r1); планируется добавить больше стандартных размеров. Полную информацию см. в разделе Цены.

21 июля

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

Jul 20

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

Jul 13

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

7 июля

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

12 июня

  • Обновлена цена сборки Creative Lab API до 30 кредитов за вызов для Keychain, Fridge Magnet и Figure (ранее — 20). Цена для Lamp не изменилась и составляет 30 кредитов. Цена прототипа не изменилась и составляет 6 кредитов за изображение. Полную разбивку см. в разделе Цены.

5 июня

Jun 1

  • Новые Creative Lab API: семейство эндпоинтов, привязанных к конкретным продуктам, которые превращают исходное фото (или текстовый prompt) в товар, готовый к 3D-печати. На старте доступны четыре продукта — Keychain (брелок), Fridge Magnet (магнит на холодильник), Figure (фигурка) и Lamp (лампа). Каждый из них использует двухэтапный рабочий процесс 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

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

May 13

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

May 12

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

11 мая

7 мая

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

Апрель 2026

Apr 27

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

Apr 24

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

21 апр.

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

20 апр.

Apr 14

Apr 12

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

Март 2026

Apr 2

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

Mar 20

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

Mar 17

Февраль 2026

Feb 28

Feb 25

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

Feb 20

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

Январь 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

Jan 12

  • В API Image to 3D добавлен новый параметр model_type для генерации низкополигональных мешей с более чистыми полигонами.

Декабрь 2025

Dec 31

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

Dec 22

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

Dec 04

Ноябрь 2025

Nov 24

Nov 06

  • API Text to 3D Refine теперь поддерживает 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) и теперь использует её по умолчанию, если параметр не указан.

4 ноября

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

Октябрь 2025

28 окт.

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

20 окт.

  • В Remesh API добавлен необязательный булев параметр convert_format_only для поддержки конвертации формата исходного файла модели без выполнения ремешинга.
  • В ответ The Rigging Task Object добавлено поле rigged_character_glb_url.

Oct 01

  • Удалены API text-to-voxel

September 2025

Sep 23

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

Sep 18

Sep 16

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

Sep 4

Август 2025

Aug 18

13 авг

Июль 2025

31 июл

Июнь 2025

Jun 25

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

Jun 19

Jun 17

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

10 июня

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

Май 2025

20 мая

  • В API Text to 3D Preview, Text to 3D Refine, Image to 3D и Multi-Image to 3D добавлен необязательный параметр moderation. При включении входной контент автоматически проверяется на наличие потенциально вредоносного содержимого перед генерацией.

15 мая

  • Представлен API автоматического создания скелета и анимации (Auto-rigging & Animation), позволяющий пользователям автоматически создавать скелет и анимировать 3D-модели. Узнайте больше о Rigging и Анимации.

Апрель 2025

29 апр.

Apr 17

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

Март 2025

Mar 28

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

14 марта

06 марта

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

Февраль 2025

Feb 18

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

Feb 13

  • Критические изменения:

    • Создание задач на бесплатном уровне прекратится 20 марта 2025 года. После этого все запросы задач через API потребуют платной подписки. Чтобы сохранить бесперебойный доступ, рекомендуем оформить обновление до этого срока.
    • Используйте код купона APIACCESS, чтобы получить скидку 40%. Спасибо, что вы с нами!

  • Добавлены endpoint для потоковой передачи Server-Sent Events (SSE) для обновлений задач в реальном времени:

6 февраля

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

Январь 2025

23 января

Jan 14

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

Jan 07

  • Добавлен параметр symmetry_mode в API Text to 3D Preview и Image to 3D, что позволяет настраивать параметры симметрии.

December 2024

Dec 19

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

Dec 12

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

Dec 10

Dec 5

Dec 3

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

Ноябрь 2024

Nov 14