Журнал изменений
Ознакомьтесь со всеми последними функциями и обновлениями Meshy API и плагинов.
Предпочитаете живую ленту? Последние записи также отображаются на странице обзора платформы для разработчиков.
Ноябрь 2026
Nov 3
- Добавлен параметр
texture_modelв Изображение в 3D и Мульти-изображение в 3D, чтобы вы могли выбирать текстурную модель в той же задаче, что и сетку. Изображение в 3D поддерживает Meshy 7 (meshy-7), Meshy N1 (meshy-n1) и Meshy 6 Lite (meshy-6-lite) с любымai_model. Мульти-изображение в 3D поддерживает мультивидовые текстурные модели, Meshy 7 и Meshy N1. У каждой текстурной модели свои ограничения; см. Модели. Задача стоит по цене только сетки для своейai_modelплюс цена Ретекстурирования для своего разрешения текстуры; см. Цены. Запросы безtexture_modelработают как раньше. - Добавлено значение
ai_model: "meshy-n1"в refine Текст в 3D. Безtexture_image_urlMeshy N1 текстурирует по референсному изображению, которое сохраняет превью Meshy 7.1 илиlatest. Другим превью требуетсяtexture_image_url. Refine с Meshy N1 стоит 10 кредитов.
Nov 2
- В API Ретекстурирование добавлен
ai_model: "meshy-n1". Meshy N1 создаёт 2K-текстуру базового цвета по одному-четырём референсным изображениям. Если изображений больше одного, первое становится видом спереди, а порядок остальных значения не имеет — как и в Meshy 7. Модель не принимает текстовый prompt, не создаёт PBR-карты или 4K- и 8K-текстуры и текстурирует 3D-модели с количеством граней до 7 999 999. Задача стоит 10 кредитов — столько же, сколько 2K Ретекстурирование; см. Цены.latestпо-прежнему указывает на Meshy 7.
Октябрь 2026
Oct 30
- Некоторые запросы Meshy T1 (
model_type: "lowpoly"илиai_model: "meshy-t1") в Текст в 3D и Изображение в 3D теперь выполняются на Smart Topology, остальные возвращают400.model_type: "smart-topology"сai_model: "meshy-t2.5"заменяет T1. С 30 ноября 2026 года каждый запрос T1 будет возвращать400. На странице Deprecations перечислено, какие запросы ещё выполняются. - В Auto Split API появился новый необязательный параметр
keep_texture. Приkeep_texture: trueкаждая часть текстурированной модели сохраняет текстуру, и задача возвращает карты текстур вtexture_urls, а также файлmtlвместе с OBJ. Без него разделение работает как прежде. Разделение с сохранением текстуры занимает примерно вдвое больше времени и по-прежнему стоит 10 кредитов.input_task_idтакже принимает задачи refine для Текст в 3D и задачи Ретекстурирования.
Oct 26
- Новая страница Deprecations: жизненный цикл каждой модели 3D-генерации (активная, Legacy, устаревшее или снятая с эксплуатации) с датой снятия с эксплуатации и рекомендуемой заменой, история всех устареваний API и устаревшие параметры, которые всё ещё поддерживаются. Баннер о снятии с эксплуатации на страницах API теперь ссылается на неё.
Oct 23
- Параметр
texture_image_urlпомечен как устаревшее в Rigging. Meshy использует текстуры, встроенные в файлmodel_url, либо текстуры исходной задачи, поэтому не указывайте его, если у модели уже есть собственные текстуры. Если вы его отправите, изображение станет единственной текстурой модели с rig, и модель лишится своих PBR-карт.
Oct 21
- Добавлен заголовок
X-Meshy-Metadataдля команд Studio и Enterprise для каждого эндпоинта, создающего задачу, за исключением эндпоинтов Creative Lab. Отмечайте задачу собственными парами «ключ-значение», напримерuser=alex@example.com,team=fab, и считывайте их обратно в полеmetadataзаписей Usage. См. Metadata.
Oct 19
export_resolutionтеперь принимает значения до512включительно (раньше — до2048) для задач сборки Keychain и Fridge Magnet.512— это разрешение карты глубины, на основе которой строится геометрия, поэтому любое значение выше него лишь добавляло дополнительные вершины между уже существующими сэмплами, увеличивая размер файла, описывающего ту же поверхность.512также является значением по умолчанию, поэтому вызовы, в которыхexport_resolutionникогда не задавался, не затронуты. Значение выше512теперь возвращает400уже на этапе создания, вместо того чтобы приниматься. В частности,2048всегда превышало предельное время работы генератора и приводило к сбою уже после запуска задачи. Если вы устанавливалиexport_resolutionвыше512, уберите этот параметр или задайте значение512.
15 окт.
- В API Изображение в 3D и Текст в 3D добавлен
ai_model: "meshy-t2.5": новейшая модель Smart Topology с более четкой детализацией для игровых ассетов. Используйте её сmodel_type: "smart-topology"; на выходе получаются только треугольники, аtarget_polycountпринимает значения от 100 до 30 000 (по умолчанию 15 000). Цены такие же, как уmeshy-t2; см. Цены. Теперь эта модель используется по умолчанию, если указанmodel_type: "smart-topology"безai_model; чтобы продолжать использовать Meshy T2, укажитеai_model: "meshy-t2". Мульти-изображение в 3D не поддерживаетmeshy-t2.5.
14 окт.
model_urlтеперь принимает файлы размером до 400 МБ (ранее — до 100 МБ), если это URL по протоколуhttpилиhttps, в операциях Ретекстурирование, Ремешинг, Rigging, Конвертировать, Изменить размер, UV-развёртка, Multi-Color Print, Анализ пригодности к печати и Восстановление пригодности к печати. Для URI видаdata:ограничение остаётся на уровне 100 МБ. Файл GLB, glTF, FBX или OBJ размером более 100 МБ может содержать не более 10 000 000 граней (8 000 000 для Multi-Color Print), считая по треугольникам; при превышении этого значения возвращается400. При размере более 100 МБ файл FBX должен быть бинарным FBX версии 7.1 или новее, а файл GLB или glTF не должен использовать сжатие Draco. Файл загружается до завершения запроса на создание, поэтому для крупных файлов следует закладывать до 120 секунд (см. Жизненный цикл задачи). Файлы размером 100 МБ и менее обрабатываются как прежде, цены не изменились.- Анализ пригодности к печати теперь возвращает код
404с тем же телом ответа, что и для несуществующего идентификатора, если указанныйinput_task_idпринадлежит другому аккаунту, — вместо кода403. Задача, принадлежащая вам или участнику команды в рабочей области, к которой вы относитесь, обрабатывается как прежде.
12 окт.
- Файлы USDZ теперь используют метры, поэтому модели открываются в реальном размере в AR Quick Look, Reality Composer, Blender и других программах просмотра USD. Файл
usdzвmodel_urlsзадач Текст в 3D, Изображение в 3D, Мульти-изображение в 3D, Ретекстурирование, Ремешинг, Конвертировать, Изменить размер и Auto Split теперь объявляетmetersPerUnit = 1. До сих пор он объявлял футы (metersPerUnit = 0.3048), в то время как его координаты были в метрах, из-за чего модель отображалась в размере 30,48% от исходного. Если вы масштабируете файлы USDZ на 3,28, чтобы это компенсировать, уберите это масштабирование для задач, созданных начиная с этой даты. Файлы более ранних задач сохраняют свою текущую единицу измерения, а файлы USDZ для Rigging и Анимация это изменение не затрагивает.
10 окт.
meshy-5снята с поддержки. Запросы, которые отправляютai_model: "meshy-5"в Текст в 3D, Изображение в 3D, Мульти-изображение в 3D или Ретекстурирование, теперь возвращают400с сообщениемai_model meshy-5 has been retired; use meshy-6-lite. Перейдите наmeshy-6-lite, который принимает те же параметры при той же стоимости в кредитах. Модели, уже сгенерированные с помощьюmeshy-5, остаются доступными, а refine превьюmeshy-5без указанияai_modelпо-прежнему работает..webpтеперь официально задокументирован как поддерживаемый формат входного изображения, наряду с.jpg,.jpegи.png, в Изображение в 3D, Мульти-изображение в 3D, Изображение в изображение, Ретекстурирование (image_style_url) и Text to 3D Refine (texture_image_url). Это работает как для публичных URL, так и для data URI (data:image/webp;base64,...). Существующие интеграции не затрагиваются, цены не меняются.- Get Balance теперь также возвращает
monthly_credits,permanent_creditsиmonthly_resets_at, чтобы вы могли видеть, какая часть вашего баланса истечёт при следующем обновлении. Само полеbalanceне изменилось.
6 октября
- Анализ пригодности к печати и Восстановление пригодности к печати теперь могут проверять толщину стенки с учётом размера, в котором вы планируете печатать. Передайте
printer_type, размер печати или оба параметра. Анализ сообщает о тонких стенках вprintability.thin_walls, а восстановление при необходимости утолщает их и может повторно использовать принтер и размер из задачи анализа, переданной черезinput_task_id. Интеграции, не использующие эти поля, работают как прежде, а цены остаются без изменений.
Сентябрь 2026
Sep 29
- Устаревший путь
/v2/text-to-3d(без префикса/openapi) объявлен устаревшим. Пока он продолжает работать без изменений, но будет удалён в одном из будущих релизов. Переходите на/openapi/v2/text-to-3d, который принимает тот же запрос и возвращает такой же ответ. Ответы на устаревшем пути теперь содержат заголовокDeprecationи заголовокLink, указывающий на новый путь.
Sep 28
- Ответы API теперь включают заголовки ограничения частоты, в том числе
Retry-After, который сообщает, сколько нужно подождать перед повторным запросом или опросом. - Многоцветная печать теперь принимает новый параметр
printer_brand, который записывает в 3MF соответствующий пресет слайсера, благодаря чему файл открывается уже готовым к печати на принтерах Anycubic, Creality, Elegoo, Flashforge, Prusa, Qidi, Snapmaker и AnkerMake, а также Bambu Lab (значение по умолчанию). На странице также теперь описан параметрmax_depth.
18 сентября
- Добавлено значение
meshy-7.1для параметраai_modelв Изображение в 3D, Мульти-изображение в 3D и Текст в 3D: те же параметры и стоимость в кредитах, что и уmeshy-7, но с более высокой детализацией геометрии. Значениеlatestтеперь соответствуетmeshy-7.1;meshy-7помечен как устаревшее, но продолжает работать без изменений. - В эти же API добавлен параметр
geometry_resolution(standard/2k/4k), заменяющий устаревший теперь параметрultra_mode(ultra_mode: trueпо-прежнему работает и эквивалентен"2k"). Значение4kтребует Meshy 7.1 (meshy-7.1илиlatest), не доступно для Мульти-изображение в 3D и стоит те же дополнительные 5 кредитов, что и2k.
16 сентября
- Auto Split API теперь принимает текстурированный
input_task_id. Раньше он отклонял его с ошибкой400, из-за чего приходилось повторно генерировать ту же сетку сshould_texture: false, чтобы разбить её. Разбиение разрезает геометрию и перестраивает поверхности каждой части, поэтому текстура входных данных не переносится, и результатом становится модель без текстуры с одним сплошным цветом на каждую часть. Это уже было справедливо для любого разбиения и осталось без изменений. meshy-5будет выведен из эксплуатации 10 октября 2026 года. Он больше не документирован как значениеai_modelдля Текст в 3D, Изображение в 3D, Мульти-изображение в 3D или Ретекстурирования, и после 10 октября запросы, отправляющиеai_model: "meshy-5", будут возвращать ошибку.- Общий тестовый API-ключ выведен из эксплуатации; запросы, которые всё ещё его используют, теперь возвращают
401 Unauthorized. Если вы скопировали его в код или CI, замените его собственным ключом со страницы API-ключей. Этот ключ всегда возвращал одну и ту же образцовую модель независимо от входных данных, поэтому он никогда не показывал, что реально сгенерирует запрос. Чтобы увидеть, что возвращает API, прежде чем начинать разработку, используйте Playground на платформе разработчика, который выполняет реальную задачу прямо в вашем браузере. На тарифах без доступа к API он запускает Изображение в 3D без API-ключа и использует кредиты вашей учётной записи, как и любая другая задача.
15 сентября
- В документированные значения
ai_modelдля API Текст в изображение и Изображение в изображение добавленыgpt-image-2-5-flareиgpt-image-2-5-sunburst. Это уровни OpenAI GPT Image 2.5, стоимость которых совпадает сgpt-image-2(Текст в изображение: 9 кредитов; Изображение в изображение: 12 кредитов). - Модели GPT Image (
gpt-image-2,gpt-image-2-5-flare,gpt-image-2-5-sunburst) теперь также поддерживают соотношения сторон4:3и3:4в API Текст в изображение и Изображение в изображение, в дополнение к1:1,16:9,9:16,3:2и2:3.
14 сен
- API «Изображение в изображение» теперь принимает
input_task_id, поэтому вы можете напрямую создавать цепочку из уже завершённой задачи Текст в изображение или Изображение в изображение, вместо того чтобы копировать её выходные URL вreference_image_urls.
11 сен
- Изменение поведения:
DELETEдля задачи, которая уже находится в статусеIN_PROGRESS, теперь отклоняется с ошибкой409 Conflict, а задача продолжает выполняться. Ранее запрос возвращал200 OK, останавливал воркер и отбрасывал результат, но кредиты при этом сохранялись, поскольку возврату подлежат только задачи со статусомPENDING. Такой вызов стоил вам и модели, и кредитов, при этом ответ никак об этом не сообщал. Если ваша интеграция удаляет задачи, чтобы отменить их, учтите: задачу, которую воркер уже начал выполнять, отменить нельзя. Дождитесь статусаSUCCEEDED,FAILEDилиCANCELED, а затем удалите её. Задачи со статусомPENDINGпо-прежнему удаляются с полным возвратом средств, как и раньше, а задачи в терминальном статусе также по-прежнему удаляются. Это касается всех семейств задач в/openapi. См. Ошибки. - В список документированных значений
ai_modelдля API Текст в 3D, Изображение в 3D, Мульти-изображение в 3D и Ретекстурирование добавлено значениеmeshy-6-lite. Это преемникmeshy-5: те же параметры, та же стоимость в кредитах (5 за сетку, 15 с текстурой, 10 за ретекстурирование). meshy-5теперь помечена как устаревшее во всех API, которые её принимают. Она продолжает работать, и ничего в вашем запросе или счёте не меняется, но в одном из будущих релизов она перестанет принимать новые запросы. Если ваша интеграция отправляетai_model: "meshy-5", перейдите наmeshy-6-lite.
Sep 9
- Новый Auto Split API: разделяет нетекстурированную модель Meshy 6 или Meshy 7 на отдельные части, пригодные для печати. Разделение выполняется автоматически, по частям, которые вы называете (
by_parts), или по цветовым областям (by_color), с опциональными шиповыми (шип-паз) соединителями и усилением тонких стенок. Экспортирует каждую часть как отдельный объект вglb,obj,fbx,usdz,blendили3mf, в собранном виде или разложенными на платформе печати (layout). 10 кредитов за задачу.
Sep 7
- Добавлен параметр
name_textна этапе прототипирования в Creative Lab Keychain API: позволяет выгравировать на брелоке имя длиной до 10 символов — ту же персонализацию, что предлагает веб-приложение. Этап сборки автоматически наследует гравировку, а объект задачи прототипа теперь возвращаетname_text, чтобы вы могли подтвердить точный текст перед сборкой.nameостаётся меткой задачи только для отображения и не гравируется.
5 сентября
- Добавлен Creative Lab Fidget Pixel API: превращает фото в многоцветную 3D-печатаемую пиксель-арт фиджет-панель в два этапа.
POST /prototype(6 кредитов) пикселизирует фото в пиксель-арт изображение. Передайтеtypeсо значениемpersonилиother, чтобы выбрать стиль пикселизации.POST /build(30 кредитов) накладывает его на сетку16или32и превращает каждый пиксель в сцепляющуюся деталь формыsquareилиhex, доставляя результат в виде единого 3MF-файла с цветовой маркировкой для печати несколькими филаментами. Геометрия детали настраивается черезpiece_size_mm,color_countиpiece_height_mm.
Sep 4
- Добавлен
GET /openapi/v1/animations/libraryв Библиотеку анимаций: получайте все готовые действия, поддерживаемые API анимации (action_id, название, категория и превью в виде анимированного GIF), с фильтрами по поиску и категории, чтобы можно было создать собственный выбор действий вместо чтения справочной таблицы. Бесплатно; не расходует кредиты. - Добавлен Creative Lab Collapsible Fidget API: превращает фотографию в фиджет-игрушку для печати в собранном виде, где силуэт объекта становится вложенными концентрическими кольцами, которые складываются в плоскую форму и снова растягиваются, печатается целиком, без сборки. Один запрос
POSTпереносит изображение напрямую в готовую модель. Здесь нет пары этапов prototype/build и нет параметров геометрии для настройки. Каждая задача стоит 6 кредитов и возвращает готовый к печати файл STL, а также GLB для предварительного просмотра, если Meshy может его отрендерить.
Sep 3
- Прототип Creative Lab Lamp API теперь возвращает 3D-модель на этапе prototype.
POST /prototypeпревращает концептуальное изображение в полый плафон GLB, и объект задачи prototype получаетmodel_urls.glbиthumbnail_urlнаряду сimage_urls. Этап build теперь запускает только обработчик лампы на этой модели и создаёт плафон с открытым дном и опорной пластиной для светового элемента. Цены изменились соответственно объёму работы. Prototype стоит 30 кредитов, а build — 6 кредитов (ранее было 6 и 30). Параметрtextдля prototype был удалён, аimage_urlтеперь обязателен.
2 сентября
- Animation API теперь принимает
action_ids, что позволяет применить до 10 предустановленных действий к персонажу с rig в одном запросе и получить единый файл, содержащий по одному анимационному клипу на каждое действие, готовый для использования из конечного автомата в игровом движке. Клипы сохраняют порядок, в котором они перечислены, и содержат имя анимации из библиотеки. Стоимость — 3 кредита за действие, при этомpost_processприменяется к объединённому файлу. Доступные идентификаторы см. в справочнике Библиотека анимаций, а стоимость — в таблице цен.
1 сентября
- В Multi-Image to 3D API добавлен параметр
ultra_mode: он включает генерацию Ultra наai_modelmeshy-7(илиlatest) для получения более точной геометрии с проработанными деталями поверхности, за дополнительные 5 кредиты. Это тот же режим Ultra, что предлагает Image to 3D API, теперь доступный с входными данными Мультивид. - Значение
meshy-t1удалено из документированных значенийai_modelдляmodel_typeSmart Topology в Image to 3D API. Теперь для 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
- Расширена поддержка
aspect_ratioдляgpt-image-2в API Текст в изображение и Изображение в изображение: добавлены значения16:9и9:16. Теперьgpt-image-2поддерживает1:1,16:9,9:16,3:2и2:3; значения4:3и3:4для этой модели по-прежнему не поддерживаются.
Aug 21
- Добавлен Text to Motion API: генерация клипа движения персонажа на основе описания на естественном языке, модель персонажа не требуется. Выберите mode
prime(10 кредитов, вывод в FBX) для максимального качества или modeswift(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_modelmeshy-7илиlatestи не зависит отimage_urls. Эти два списка могут содержать разные изображения и разное количество изображений.
Aug 17
- В API Текст в изображение и API Изображение в изображение добавлен параметр
remove_background. Установитеremove_background: true, чтобы получить сгенерированное изображение в виде прозрачного PNG в формате RGBA с удалённым фоном.
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_typeSmart Topology. Установитеmodel_type: "smart-topology", чтобы генерировать с помощьюmeshy-t2: более чистая topology, изначально разделённые части, вывод в треугольниках и количество граней, которое можно задать с помощьюtarget_polycount(от 100 до 15 000, по умолчанию 4 000). Предпросмотр Smart Topology стоит 5 кредитов вместо 20; см. Цены. Существующийmodel_type: "lowpoly"теперь устаревшее, но продолжает обслуживать запросы для обратной совместимости.
Aug 12
- В API Изображение в 3D добавлен
ai_model: "meshy-7": наша новейшая модель генерации 3D, обеспечивающая более высокую точность геометрии по сравнению с Meshy 6. Она также вводит параметрultra_mode, который включает Ultra-генерацию для ещё более тонкой детализации поверхности. - В API Мульти-изображение в 3D добавлен
ai_model: "meshy-7": модель генерации Мультивид от Meshy, которая учитывает все ваши входные ракурсы одновременно и использует их для текстурирования. - В API Ретекстурирование добавлен
ai_model: "meshy-7": наша новейшая модель текстурирования, обеспечивающая более чёткую детализацию поверхности и более чистые PBR-материалы по сравнению с Meshy 6. Она также вводит параметрmultiview_image_urls. Предоставьте от 1 до 4 упорядоченных ракурсов одного и того же объекта для мультивидового текстурирования.
Aug 4
- Расширена поддержка входных данных
model_urlдо.glb,.gltf,.obj,.fbx,.stlдля эндпоинтов Анализ пригодности к печати и Восстановление пригодности к печати (ранее поддерживались только.glb,.stl,.obj). Восстановление возвращает восстановленный asset в исходном формате.
Июль 2026
Jul 27
- Новый Creative Lab Brick Figure API: превращает фото в коллекционную 3D-минифигурку в стиле кирпичиков. Используется тот же двухэтапный процесс, что и в Figure API.
prototype(6 кредитов) создаёт стилизованное концептуальное изображение, аbuild(30 кредитов) превращает его в текстурированную 3D-модель с выходными файлами GLB и OBJ + MTL. Полную информацию см. в разделе Цены.
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) в эндпоинтах Image to 3D, Multi-Image to 3D, Text to 3D Refine и Retexture. При значении8kPBR-карты генерируются в разрешении 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). По умолчанию вsmart-topologyиспользуетсяmeshy-t2. Существующийmodel_type: lowpolyтеперь устаревшее значение, но продолжает обрабатывать запросы для обратной совместимости.
Jul 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
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 кредитов за вызов для Keychain, Fridge Magnet и Figure (ранее 20). Цена на Lamp не изменилась и составляет 30 кредитов. Цена на Prototype не изменилась и составляет 6 кредитов за изображение. Полную разбивку см. в разделе Цены.
Jun 5
- Добавлен необязательный параметр
alpha_thumbnailв API Изображение в 3D, Мульти-изображение в 3D, Текст в 3D, Ретекстурирование, Ремешинг и Восстановление пригодности к печати. При значенииtrueзадача дополнительно рендерит версию превью с прозрачным фоном (RGBA) и возвращает её в новом поле ответаalpha_thumbnail_url. Существующее полеthumbnail_urlне изменилось. По умолчаниюfalse.
Jun 1
- Новые Creative Lab API: семейство endpoint'ов, привязанных к конкретным продуктам, которые превращают исходное фото (или текстовый prompt) в готовую к 3D-печати потребительскую продукцию. На старте доступны четыре продукта: брелок, магнит на холодильник, фигурка и лампа. Каждый продукт следует двухэтапному workflow
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 теперь доступна в виде отдельных endpoint'ов Convert API и Resize API. Устаревшие параметры в Remesh продолжат работать для обратной совместимости.
13 мая
- В API Изображение в 3D добавлен параметр
multi_view_thumbnails. Если установлено значениеtrue, задача дополнительно рендерит четыре миниатюры с видами по сторонам света (спереди, справа, сзади, слева) и возвращает их в новом поле ответаthumbnail_urls. Существующее полеthumbnail_urlостаётся без изменений. Добавляет около 3 секунд к задержке выполнения задачи.
12 мая
- В API Ремешинг добавлен параметр
resize_longest_side. Изменяет размер модели так, чтобы наибольшее измерение ограничивающего прямоугольника равнялось указанному значению в метрах. Взаимоисключающий сresize_heightиauto_size.
11 мая
- Устарел параметр
symmetry_modeв endpoint'ах Текст в 3D, Изображение в 3D и Мульти-изображение в 3D. Этот параметр больше не влияет на результат.
7 мая
- Новый Analyze Printability API: позволяет проанализировать успешно завершённую задачу Meshy или любой URL 3D-модели на готовность к FDM 3D-печати. Используется асинхронный паттерн создания + потоковой передачи: POST возвращает task_id, затем GET / SSE-поток возвращает метрики водонепроницаемости, объёма, отверстий и немногообразных рёбер при статусе SUCCEEDED. Бесплатно, кредиты не расходуются.
- Новый Repair Printability API: восстанавливает 3D-модель для обеспечения пригодности к печати методом FDM, исправляя немногообразные рёбра, вырожденные грани, отверстия и другие проблемы topology. Принимает существующий
input_task_idMeshy или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для эндпоинтов Изображение в 3D и Мульти-изображение в 3D. Позволяет напрямую ссылаться на результат завершённой задачи Текст в изображение или Изображение в изображение вместо указанияimage_url/image_urls. Если указаны оба параметра,input_task_idимеет приоритет.
20 апр
- Добавлен параметр
hd_textureдля эндпоинтов Изображение в 3D, Мульти-изображение в 3D, Text to 3D Refine и Ретекстурирование. При включении базовая цветовая текстура генерируется в разрешении 4K (4096×4096) для более высокой детализации. Поддерживается только дляmeshy-6иlatest. По умолчанию —false. - PBR-пакет, возвращаемый при
enable_pbrравномtrue, теперь включает картуemissionв составеtexture_urlsдля задачmeshy-6иlatestв эндпоинтах Изображение в 3D, Мульти-изображение в 3D, Text to 3D Refine и Ретекстурирование. Изменений в запросе не требуется.
Apr 14
- В endpoints Изображение в 3D, Мульти-изображение в 3D, Text to 3D Preview и Ремешинг добавлен параметр
decimation_mode. Устанавливает уровень адаптивного прореживания числа полигонов:1(ультра),2(высокий),3(средний) или4(низкий).
Apr 12
- Реструктурирована документация API: добавлена группировка параметров со связанными полями, встроенные значения по умолчанию, значки обязательных/устаревших параметров, разворачиваемая подпанель навигации, а также разделены на отдельные страницы Мульти-изображение, Rigging и Анимация.
Март 2026
Apr 2
- Добавлена поддержка формата
3mfдля параметраtarget_formatsво всех endpoint'ах (Изображение в 3D, Текст в 3D, Ремешинг, Ретекстурирование). Обратите внимание: 3MF поддерживается только по явному запросу и должен быть указан отдельно. - Новый API многоцветной печати: Конвертировать 3D-модели в многоцветный формат 3MF для 3D-печати. Поддерживаются палитры от 1 до 16 цветов с настраиваемой точностью. 10 кредитов за задачу.
20 марта
- Устарела AI-модель Meshy-4. Все API-запросы с использованием
meshy-4больше не поддерживаются. Перейдите наmeshy-6илиlatest. - Добавлены параметры
auto_sizeиorigin_atв эндпоинты Изображение в 3D, Мульти-изображение в 3D, Текст в 3D и Ремешинг. При включённомauto_sizeсервис использует искусственное зрение для оценки реальной высоты и автоматически изменяет размер модели.origin_atзадаёт позицию начала координат (bottomилиcenter). В API Ремешинга параметрauto_sizeвзаимоисключающий сresize_height.
Mar 17
- В endpoints Изображение в 3D, Мульти-изображение в 3D, Текст в 3D и Ретекстурирование добавлен необязательный параметр
target_formats. Укажите, какие 3D-форматы нужно генерировать (например,["glb", "fbx"]), чтобы сократить время выполнения задачи.
Февраль 2026
Feb 28
- В API Изображение в 3D, Мульти-изображение в 3D, Text to 3D Refine и Ретекстурирование добавлен параметр
remove_lighting. Он убирает блики и тени с базовой цветовой текстуры для более чистого результата при использовании пользовательского освещения. Поддерживается только дляmeshy-6иlatest. Значение по умолчанию —true. - API Ретекстурирование и Text to 3D Refine теперь поддерживают значение
meshy-6для параметраai_model, обеспечивающее полноценное текстурирование Meshy 6.
Feb 25
- Добавлен параметр
image_enhancementв API Изображение в 3D и Мульти-изображение в 3D для пользователей, которые хотят отказаться от оптимизации входного изображения и сохранить точный внешний вид исходного изображения. Поддерживается только дляmeshy-6иlatest. По умолчаниюtrue.
Feb 20
- Добавлен параметр
model_typeв API Текст в 3D Preview для генерации низкополигональных мешей, оптимизированных для более чистых полигонов.
Январь 2026
27 янв
- Добавлена подробная документация Режимы сбоя для всех эндпоинтов API, включая распространённые коды ошибок HTTP (400, 401, 402, 404, 422, 429) и причины сбоя задач. Это помогает разработчикам лучше понимать и обрабатывать ошибки API.
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 янв
- Опция
latestдляai_modelв API Текст в 3D (Preview) и Изображение в 3D теперь указывает на Meshy 6.
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
- В API Текст в 3D Preview, Изображение в 3D и Мульти-изображение в 3D добавлен новый параметр
pose_mode. Этот параметр принимает значения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 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) и теперь использует её по умолчанию, если параметр не указан.
Nov 04
- Remesh API теперь сохраняет текстуры для загруженных моделей.
- Retexture API теперь сохраняет текстуры для загруженных моделей при включённом параметре
enable_original_uv.
Октябрь 2025
Oct 28
- Добавлен заголовок ответа
x-api-version, указывающий текущую версию API-сервера.
Oct 20
- Добавлен необязательный булевый параметр
convert_format_onlyв Remesh API для поддержки преобразования формата входного файла модели без выполнения ремешинга. - В ответ объекта The Rigging Task Object добавлено поле
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в Ремешинг и Ретекстурирование.
August 2025
Aug 18
- Добавлен необязательный параметр
is_a_t_poseв API Текст в 3D Preview, Изображение в 3D и Мульти-изображение в 3D для генерации моделей в позе A/T.
Aug 13
- Meshy 5 теперь стабильна для Text to 3D и Image to 3D (
ai_model:meshy-5), обеспечивая улучшенное качество и стабильность результатов.
Июль 2025
Jul 31
- Поддержка PBR-текстурных карт в API через параметр
enable_pbrдля последней моделиmeshy-5для эндпоинтов Text to 3D, Image to 3D, Multi-Image to 3D и Retexture.
Июнь 2025
Jun 25
- Добавлен Retexture API, который позволяет пользователям выполнять ретекстурирование 3D-моделей на основе последних базовых AI-моделей Meshy.
Jun 19
- Добавлены API удаления для Text to 3D, Image to 3D, Remesh, Rigging и Animation.
- Добавлен параметр
ai_modelв Text to 3D Refine API.
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-моделей. Подробнее о риггинге и Анимации.
Апрель 2025
29 апр
- Представлен API Мульти-изображение в 3D, позволяющий создавать 3D-модели из 1–4 входных изображений с использованием AI-модели
meshy-5. - В API Текст в 3D и Изображение в 3D добавлена опция AI-модели
meshy-5. Тегlatestтеперь также соответствуетmeshy-5.
Apr 17
- Добавлен параметр
texture_image_urlв API Изображение в 3D и Text to 3D Refine, позволяющий пользователям направлять процесс генерации текстуры с помощью изображения.
March 2025
Mar 28
- Добавлен параметр
latestв API Текст в 3D и Изображение в 3D, обеспечивающий доступ к нашим будущим усовершенствованным ИИ-моделям для улучшенного качества генерации.
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-ключ тестового режима, который позволяет разработчикам тестировать интеграцию API без расходования кредитов. Все корректные запросы с использованием этого ключа будут возвращать одинаковые примеры результатов задач.
Feb 13
-
Критические изменения:
- Создание задач на бесплатном уровне будет прекращено
20 марта 2025 года. После этого все запросы задач API потребуют оформления платной подписки. Чтобы доступ оставался бесперебойным, рекомендуем оформить обновление до наступления этого срока. - Используйте код купона
APIACCESS, чтобы получить скидку40%. Спасибо, что остаётесь с нами!
- Создание задач на бесплатном уровне будет прекращено
-
Добавлены endpoint-ы потоковой передачи Server-Sent Events (SSE) для обновления задач в реальном времени:
6 февраля
- В API Изображение в 3D и Text to 3D Refine добавлен параметр
texture_prompt, позволяющий пользователям управлять процессом генерации текстуры с помощью prompt.
Январь 2025
23 января
- В API Текст в 3D, Изображение в 3D, Ремешинг и Текст в текстуру добавлены endpoint'ы для получения списка задач.
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
- Добавлены API Ремешинга, которые позволяют пользователям выполнять ремешинг и экспортировать существующие 3D-модели, созданные другими API Meshy, в различные форматы.
- Обновлены ограничения на число полигонов для наших API — теперь диапазон составляет от 100 до 300 000 для пользователей с подпиской Premium.
12 дек.
- Устарело свойство
model_urlво всех объектах ответа. - Устаревший API Meshy-3 отделён от последнего API Meshy-4.
10 дек.
- Добавлен параметр
enable_pbrв API Изображение в 3D и Text to 3D Refine. - Добавлен параметр
should_textureв API Изображение в 3D. - Устарела опция
pbrпараметраart_styleв API Текст в 3D Preview при использовании AI-моделиmeshy-4. - Устарела опция
низкополигональныйпараметраart_styleв API Текст в 3D Preview.
Dec 5
- Добавлен Get Balance API, позволяющий пользователям получать баланс кредитов.
- Добавлен параметр
should_remeshв API Изображение в 3D и Text to 3D Preview.
Dec 3
- Внешние API теперь используют префикс
/openapi. Устаревшие пути по-прежнему поддерживаются, но мы рекомендуем перейти на новые пути.
November 2024
Nov 14
- Image to 3D API теперь поддерживает изображения, закодированные в base64.