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

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

Сентябрь 2026

Sep 3

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

1 сентября

  • В API Мульти-изображение в 3D добавлен параметр ultra_mode: он включает Ultra-генерацию на ai_model meshy-7 (или latest) для получения более точной геометрии с более детальной проработкой поверхности, за 5 дополнительных кредитов — тот же режим Ultra, что предлагает API Изображение в 3D, теперь доступный и для мультивидовых входных данных.
  • Из документированных значений ai_model для model_type Smart Topology в API Изображение в 3D удалено значение meshy-t1. Теперь для 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

  • В API многоцветной печати добавлен параметр style: выберите realistic (по умолчанию) для точной передачи цветов текстуры или cartoon для плоских однородных цветовых областей и уменьшенного размера 3MF.
  • В каждый эндпоинт прототипов Creative Lab добавлен параметр remove_background — 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" теперь является устаревшим, но продолжает обслуживать запросы для обратной совместимости.

Aug 12

  • В Image to 3D API добавлен ai_model: "meshy-7": наша новейшая модель генерации 3D, с более высококачественной геометрией, чем у Meshy 6. Также в ней появился параметр ultra_mode, который включает Ultra-генерацию для ещё более тонкой детализации поверхности.
  • В Multi-Image to 3D API добавлен ai_model: "meshy-7": модель мультивидовой генерации от Meshy, которая учитывает все ваши входные ракурсы вместе и использует их для текстурирования.
  • В Retexture API добавлен ai_model: "meshy-7": наша новейшая модель текстурирования, с более чёткой детализацией поверхности и более чистыми 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); планируется добавить больше стандартных размеров. Полную информацию о ценах см. в разделе Цены.

Jul 21

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

20 июля

  • Новинка: Creative Lab — Vinyl Figure API: превращает фото в 3D-фигурку виниловой коллекционной игрушки с большой головой. Тот же двухэтапный процесс, что и в 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.

June 2026

Jun 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.

Jun 12

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

Jun 5

  • Добавлен необязательный параметр alpha_thumbnail в API Image to 3D, Multi-Image to 3D, Text to 3D, Retexture, Remesh и Repair Printability. Если установлено значение true, задача дополнительно рендерит версию превью с прозрачным фоном (RGBA) и возвращает её в новом поле ответа alpha_thumbnail_url. Существующее поле thumbnail_url остаётся без изменений. Значение по умолчанию — false.

Jun 1

  • Новые API Creative Lab: семейство endpoint'ов, привязанных к конкретным продуктам, которые превращают исходное фото (или текстовый 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

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

May 22

  • Функциональность конвертации и изменения размера из Remesh API теперь доступна в виде отдельных эндпоинтов 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 мая

7 мая

  • Новый Analyze Printability API: выполняет Анализ пригодности к печати для успешно завершённой задачи Meshy — или для любого URL 3D-модели — на предмет готовности к 3D-печати методом FDM. Используется асинхронный шаблон создания + потоковой передачи: 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. Возвращает 0 для задач FAILED (кредиты автоматически возвращаются при сбое). См. раздел Цены для стоимости кредитов по каждому эндпоинту.

Apr 24

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

Apr 21

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

Apr 20

Apr 14

Apr 12

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

Март 2026

Apr 2

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

20 марта

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

Mar 17

February 2026

Feb 28

25 фев

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

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.

22 января

  • Устарел параметр art_style в API Предпросмотр Текст в 3D (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 для остальных моделей, если не указано иное.

19 янв.

12 янв.

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

Декабрь 2025

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

  • Текст в 3D Refine API теперь поддерживает ai_model = latest, что соответствует Meshy 6 Preview.
  • Изображение в 3D API теперь по умолчанию использует текстурирование Meshy-6-preview, когда ai_model = latest и should_texture = true.
  • Мульти-изображение в 3D API теперь поддерживает 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

  • В API Ремешинга добавлен необязательный булев параметр convert_format_only для поддержки преобразования формата входного файла модели без изменения геометрии.
  • В ответ объекта задачи Rigging добавлено поле 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

Sep 16

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

Sep 4

August 2025

Aug 18

Aug 13

  • Meshy 5 теперь стабильна для Text to 3D и Image to 3D (ai_model: meshy-5), обеспечивая улучшенное качество и стабильность.

Июль 2025

Jul 31

June 2025

Jun 25

  • Добавлен 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. При включении входной контент автоматически проверяется на наличие потенциально вредоносного содержимого перед генерацией.

May 15

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

April 2025

Apr 29

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

Apr 17

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

Март 2025

Mar 28

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

14 марта

06 марта

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

Февраль 2025

Feb 18

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

Feb 13

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

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

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

Feb 6

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

Январь 2025

Jan 23

Jan 14

  • Устаревшие legacy API для Text to 3D и Image to 3D на основе AI-моделей Meshy-3.

Jan 07

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

Декабрь 2024

Dec 19

  • Добавлены Remesh 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-пути по-прежнему поддерживаются, но мы рекомендуем перейти на новые пути.

November 2024

Nov 14

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