lowpoly будет отключён 30 окт. 2026 г.. Перейдите на другую модель до этих дат, чтобы избежать ошибок в запросах.

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

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

Предпочитаете живую ленту? Последние записи также отображаются на странице обзора платформы для разработчиков.

Октябрь 2026

Oct 15

  • Добавлен ai_model: "meshy-t2.5" в API Изображение в 3D и Текст в 3D: новейшая модель Smart Topology с более четкой детализацией для игровых ассетов. Используйте её с model_type: "smart-topology"; на выходе получается только треугольная топология, а target_polycount принимает значения от 100 до 30 000 (по умолчанию 15 000). Цены такие же, как у meshy-t2; см. Цены. Теперь эта модель используется по умолчанию, если указан model_type: "smart-topology" без ai_model; установите ai_model: "meshy-t2", чтобы продолжать использовать Meshy T2. Мульти-изображение в 3D не поддерживает meshy-t2.5.

Oct 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 МБ и менее ведут себя как прежде, и цены не изменились.
  • Анализ пригодности к печати теперь в ответ на input_task_id, принадлежащий другому аккаунту, возвращает 404 с тем же телом ответа, что и для несуществующего 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" в Text to 3D, Image to 3D, Multi-Image to 3D или Retexture, теперь возвращают 400 с сообщением ai_model meshy-5 has been retired; use meshy-6-lite. Перейдите на meshy-6-lite, который принимает те же параметры при той же стоимости в credit. Модели, уже сгенерированные с помощью meshy-5, остаются доступны, а refine-обработка превью meshy-5 без указания ai_model по-прежнему работает.
  • .webp теперь официально задокументирован как поддерживаемый формат входного изображения, наряду с .jpg, .jpeg и .png, в Image to 3D, Multi-Image to 3D, Image to Image, Retexture (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, который сообщает, сколько нужно подождать перед повторной попыткой или опросом.
  • Multi-Color Print теперь принимает новый параметр printer_brand, который записывает соответствующий пресет слайсера в 3MF, благодаря чему файл открывается готовым к печати на принтерах Anycubic, Creality, Elegoo, Flashforge, Prusa, Qidi, Snapmaker и AnkerMake, а также Bambu Lab (значение по умолчанию). На странице также теперь описан параметр max_depth.

Sep 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 в Developer Platform — он выполняет настоящую задачу прямо в вашем браузере. На тарифах без доступа к API он запускает Изображение в 3D без API-ключа и использует кредиты вашего аккаунта, как и любая другая задача.

Sep 15

Sep 14

  • API «Изображение в изображение» теперь принимает input_task_id — можно продолжить напрямую от завершённой задачи Текст в изображение или Изображение в изображение вместо копирования URL-адресов её результата в reference_image_urls.

Sep 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) — с опциональными шиповыми соединениями (mortise-and-tenon) и усилением тонких стенок. Экспортирует каждую часть как отдельный объект в 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: получайте все готовые действия, поддерживаемые Animation API — action_id, название, категорию и анимированное GIF-превью — с фильтрами по поиску и категориям, что позволяет создать собственный выбор действий вместо чтения справочной таблицы. Бесплатно; не расходует кредиты.
  • Добавлен Creative Lab Collapsible Fidget API: превращает фото в складную игрушку-непоседу, печатаемую сразу в готовом виде, где силуэт объекта становится вложенными концентрическими кольцами, которые складываются плоско и снова растягиваются. Печатается единым целым, без сборки. Один запрос POST проводит изображение через весь процесс до готовой модели — здесь нет пары этапов prototype/build и нет параметров геометрии для настройки. Каждая задача стоит 6 кредитов и возвращает как печатаемый STL, так и GLB для предварительного просмотра.

Sep 3

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

Sep 2

  • Animation API теперь принимает action_ids — позволяет применить до 10 предустановленных действий к рискованному персонажу за один запрос и получить единый файл, содержащий по одному анимационному клипу на каждое действие, готовый к использованию из конечного автомата состояний в игровом движке. Клипы сохраняют порядок, в котором вы их перечислили, и несут имя библиотеки анимации. Стоимость — 3 кредита за действие, при этом post_process применяется к объединённому файлу. См. Справочник библиотеки анимаций для доступных идентификаторов и таблицу цен.

Sep 1

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

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

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

Aug 17

  • Добавлен параметр remove_background в Text to Image API и Image to Image API. Установите remove_background: true, чтобы получить сгенерированное изображение в виде прозрачного PNG в формате RGBA с удалённым фоном.

Aug 13

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

Jul 21

  • Теперь мы поддерживаем 8K-текстуры базового цвета через новый параметр texture_resolution (2k / 4k / 8k) в эндпоинтах Изображение в 3D, Мульти-изображение в 3D, Text to 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-развёртки.

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 теперь доступна в виде отдельных 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-модели — для готовности к 3D-печати методом FDM. Асинхронный шаблон создания + потоковой передачи: POST возвращает task_id, затем GET / SSE-поток возвращают метрики водонепроницаемости, объёма, отверстий и немногообразных рёбер после завершения со статусом SUCCEEDED. Бесплатно, кредиты не расходуются.
  • Новый Repair Printability API: Восстановление пригодности к печати 3D-модели для 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

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

21 апр

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

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 кредитов за задачу.

Mar 20

  • Прекращена поддержка AI-модели Meshy-4. Все запросы к 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

Февраль 2026

Feb 28

Feb 25

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

Feb 20

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

Январь 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 Изображение в 3D добавлен новый параметр model_type для создания низкополигональных мешей с оптимизированными, более чистыми полигонами.

Декабрь 2025

Dec 31

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

22 дек

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

04 дек

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

Ноябрь 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) и теперь использует её по умолчанию, если значение не указано.

Nov 04

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

Октябрь 2025

Oct 28

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

Oct 20

  • Добавлен необязательный булев параметр convert_format_only в Remesh API для поддержки преобразования формата входного файла модели без выполнения ремешинга.
  • В ответ объекта задачи риггинга добавлено поле rigged_character_glb_url.

Oct 01

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

Сентябрь 2025

Sep 23

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

Sep 18

Sep 16

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

Sep 4

Август 2025

Aug 18

Aug 13

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

July 2025

Jul 31

Июнь 2025

Jun 25

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

Jun 19

Jun 17

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

Jun 10

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

Май 2025

May 20

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

15 мая

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

Апрель 2025

29 апр.

Apr 17

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

March 2025

Mar 28

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

Mar 14

Mar 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) для обновления задач в реальном времени:

Feb 6

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

Январь 2025

Jan 23

Jan 14

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

Jan 07

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

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