Журнал змін
Перегляньте всі останні функції та оновлення Meshy API та плагінів.
Віддаєте перевагу живій стрічці? Останні записи також з'являються на сторінці огляду Developer Platform.
Жовтень 2026
Oct 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.
Oct 14
model_urlтепер приймає файли розміром до 400 МБ (замість 100 МБ), коли цеhttp- абоhttps-посилання, у Ретекстурування, Ремеш, Rigging, Конвертувати, Змінити розмір, UV-розгортка, Multi-Color Print, Аналіз придатності до друку та Відновлення придатності до друку. URI типуdata:залишається обмеженим до 100 МБ. Файл GLB, glTF, FBX або OBJ розміром понад 100 МБ може мати не більше 10 000 000 граней (8 000 000 для багатоколірного друку), у перерахунку на трикутники; файл із більшою кількістю граней повертає400. Для файлів понад 100 МБ FBX має бути у бінарному форматі FBX 7.1 або новішому, а GLB чи glTF не повинні використовувати стиснення Draco. Файл завантажується ще до завершення запиту на створення, тож для великого файлу слід передбачити очікування до 120 секунд (див. Task Lifecycle). Файли розміром 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 та Анімація це не стосується.
Oct 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, який приймає ті самі параметри за тією ж вартістю в кредитах. Моделі, які ви вже згенерували за допомогою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.
18 вер
- Додано
meshy-7.1як значенняai_modelдля Зображення у 3D, Мульти-зображення у 3D та Текст у 3D: ті самі параметри та вартість у кредитах, що йmeshy-7, вища деталізація геометрії.latestтепер відповідаєmeshy-7.1;meshy-7є застарілим, але продовжує працювати без змін. - Додано
geometry_resolution(standard/2k/4k) до тих самих API, замінивши тепер застарілий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
- Додано
gpt-image-2-5-flareіgpt-image-2-5-sunburstдо задокументованих значеньai_modelдля API Текст у зображення та Зображення у зображення. Це рівні 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.
Sep 14
- Image to Image 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) — з опціональними шип-пазовими з'єднувачами та підсиленням тонких стінок. Експортує кожну частину як окремий об'єкт у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-запит проводить зображення аж до готової моделі — тут немає пари етапів прототип/збірка та немає параметрів геометрії для налаштування. Кожне завдання коштує 6 кредитів і повертає як друковний STL, так і GLB для попереднього перегляду.
3 вер.
- Етап прототипування Creative Lab Lamp API тепер повертає 3D-модель:
POST /prototypeперетворює концептуальне зображення на порожній абажур у форматі GLB, а об'єкт завдання прототипу отримуєmodel_urls.glbтаthumbnail_urlпоряд ізimage_urls. Етап побудови запускає лише обробник лампи для цієї моделі й тепер створює абажур із відкритим дном і базовою пластиною для світлового елемента. Ціни змінюються відповідно до обсягу роботи: прототип коштує 30 кредитів, а побудова — 6 кредитів (раніше було 6 і 30). Параметрtextдля прототипу видалено — тепер обов'язковим єimage_url.
Sep 2
- Animation API тепер приймає
action_ids— застосовуйте до 10 заданих дій до риґованого персонажа в одному запиті та отримуйте єдиний файл, що містить один анімаційний кліп на кожну дію, готовий для керування зі скінченного автомата у ігровому рушії. Кліпи зберігають порядок, у якому ви їх перелічили, і несуть назву бібліотеки анімації. Вартість — 3 кредити за дію, аpost_processзастосовується до об’єднаного файлу. Див. Довідник Бібліотеки анімацій для доступних ідентифікаторів та таблицю цін.
Sep 1
- Додано параметр
ultra_modeдо Multi-Image to 3D API: вмикає генерацію 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, до вашого персонажа-біпеда з rig, як альтернативу заздалегідь заданому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: генерація кліпу з рухами персонажа на основі опису природною мовою, без потреби в моделі персонажа. Оберіть
primemode (10 кредитів, вивід у форматі FBX) для найвищої якості абоswiftmode (3 кредити, вивід у форматі BVH) для швидкої й економічної генерації, з тривалістю кліпу 2–10 секунд.
Aug 20
- Додано параметр
styleдо Multi-Color Print API: виберітьrealistic(за замовчуванням) для точної передачі кольорів текстури абоcartoonдля плоских, однорідних кольорових областей і меншого 3MF. - Додано параметр
remove_backgroundдо кожної кінцевої точки прототипів Creative Lab — Figure, Vinyl Figure, Brick Figure, Keycap, Keychain, Fridge Magnet та Lamp. Встановітьremove_background: true, щоб отримати зображення прототипу у вигляді прозорого RGBA PNG з видаленим фоном.
Aug 18
- Додано параметр
texture_image_urlsдо Multi-Image to 3D API: надайте 1–4 зображення одного й того ж об'єкта, щоб керувати текстуруванням, замість одногоtexture_image_url. Потребуєai_modelmeshy-7абоlatest, і не залежить відimage_urls— ці два списки можуть містити різні зображення та різну кількість зображень.
Aug 17
- Додано параметр
remove_backgroundдо Text to Image API та Image to Image API. Встановітьremove_background: true, щоб отримати згенероване зображення як прозорий RGBA PNG із видаленим фоном.
Aug 13
- Додано
ai_model: "meshy-7"до Text to 3D API: нашу найновішу модель 3D-генерації з вищою точністю геометрії порівняно з Meshy 6. Вона також вводить параметрultra_modeдля preview-завдання, який вмикає Ultra-генерацію для ще детальнішої поверхні за 5 додаткових кредитів. Щоб текстурувати за допомогою Meshy 7, передайтеai_model: "meshy-7"у refine-завданні або повністю опустітьai_model. - Додано
model_typeSmart Topology до Text to 3D API. Встановітьmodel_type: "smart-topology", щоб генерувати за допомогоюmeshy-t2— чистіша topology, нативно розділені частини, вивід у трикутниках і кількість полігонів, яку можна задати черезtarget_polycount(від 100 до 15 000, за замовчуванням 4000). Попередній перегляд Smart Topology коштує 5 кредитів замість 20; див. Ціни. Наявнийmodel_type: "lowpoly"тепер застаріле, але продовжує обслуговувати запити для зворотної сумісності.
Aug 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
- Розширено підтримку вхідних даних
model_urlдо.glb,.gltf,.obj,.fbx,.stlдля endpoint'ів Аналіз придатності до друку та Відновлення придатності до друку (раніше підтримувались.glb,.stl,.obj). Відновлення повертає відновлений asset у форматі вхідних даних.
July 2026
Jul 27
- Новинка: Creative Lab — Brick Figure API: перетворює фото на колекційну 3D-мінiфігурку у стилі цеглинок. Той самий дворівневий робочий процес, що й у 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 та Ретекстурування. При8kPBR-карти генеруються у 4K, і карта випромінювання (emission map) не створюється. Генерація 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
- Додано новий
model_typeSmart Topology до API Зображення у 3D, що пропонує дві моделі черезai_model:meshy-t1— поточна низькополігональна модель — іmeshy-t2— нова модель з чистішою topology, природно розділеними частинами, виводом у трикутниках і кількістю граней, яку можна задати за допомогоюtarget_polycount.meshy-t2є типовою моделлю в режиміsmart-topology. Наявнийmodel_type: lowpolyтепер застаріле, але продовжує обслуговувати запити для зворотної сумісності.
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.
Червень 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 кредитів за зображення. Повний перелік див. у розділі Ціни.
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
- Нові Creative Lab API: родина 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
- Додано параметр
multi_view_thumbnailsдо API Мульти-зображення у 3D. Коли встановлено значенняtrue, завдання додатково рендерить чотири мініатюри з основних ракурсів (спереду, справа, ззаду, зліва) і повертає їх у новому полі відповідіthumbnail_urls. Існуюче полеthumbnail_urlзалишається без змін. Це додає приблизно 3 секунди до затримки виконання завдання.
May 22
- Функціонал конвертації та зміни розміру з Remesh API тепер доступний як окремі endpoint'и 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 травня
- Застарів параметр
symmetry_modeна endpoint'ах Текст у 3D, Зображення у 3D та Мульти-зображення у 3D. Цей параметр більше не впливає на результат.
7 травня
- Новий Analyze Printability API: Аналіз успішно виконаного завдання Meshy — або будь-якої URL-адреси 3D-моделі — на готовність до FDM 3D-друку. Асинхронний шаблон create + stream: 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. Повертає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
- Додано параметр
input_task_idдля endpoint'ів Зображення у 3D та Мульти-зображення у 3D. Посилайтеся безпосередньо на результат завершеного завдання Текст у зображення або Зображення у зображення замість наданняimage_url/image_urls. Якщо вказано обидва, пріоритет маєinput_task_id.
Apr 20
- Додано параметр
hd_textureдля endpoint'ів Зображення у 3D, Мульти-зображення у 3D, Text to 3D Refine та Ретекстурування. Якщо увімкнено, текстура базового кольору генерується у роздільній здатності 4K (4096×4096) для більшої деталізації. Підтримується лише дляmeshy-6таlatest. За замовчуванням —false. - Пакет PBR, що повертається, коли
enable_pbrмає значенняtrue, тепер включає картуemissionуtexture_urlsдля завданьmeshy-6таlatestв endpoint'ах Зображення у 3D, Мульти-зображення у 3D, Text to 3D Refine та Ретекстурування. Жодних змін у запиті не потрібно.
Apr 14
- Додано параметр
decimation_modeдо endpoint-ів Зображення у 3D, Мульти-зображення у 3D, Текст у 3D Preview та Ремеш. Встановлює рівень адаптивної decimation-кількості полігонів:1(ультра),2(високий),3(середній) або4(низький).
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
- Додано опціональний параметр
target_formatsдо endpoint-ів Зображення у 3D, Мульти-зображення у 3D, Текст у 3D та Ретекстурування. Вкажіть, які 3D-формати потрібно згенерувати (наприклад,["glb", "fbx"]), щоб скоротити час виконання завдання.
Лютий 2026
Feb 28
- Додано параметр
remove_lightingдо API Зображення у 3D, Мульти-зображення у 3D, Text to 3D Refine та Ретекстурування. Видаляє відблиски та тіні з базової текстури кольору для чистіших результатів при користувацькому освітленні. Підтримується лише для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 Text to 3D Preview для генерації низькополігональних мешів, оптимізованих для чистіших полігонів.
Січень 2026
Jan 27
- Додано детальну документацію Режими збою для всіх Кінцевих точок API, включно з поширеними кодами помилок HTTP (400, 401, 402, 404, 422, 429) та причинами невдалого виконання завдань. Це допомагає розробникам краще розуміти та обробляти помилки API.
Jan 26
- API Мульти-зображення у 3D тепер підтримує Meshy-6 для повної Генерації сітки. Параметр
ai_modelтепер приймає значенняmeshy-6, аlatestвідповідає Meshy 6.
Jan 22
- Застаріло
art_styleдля API Текст у 3D Preview (Meshy-6). Цей параметр був розроблений для застарілих моделей (Meshy-4 / Meshy-5) і буде видалений у майбутньому релізі. - Застаріло
enable_pbrдля API Текст у 3D та Зображення у 3D, колиai_modelмає значенняmeshy-4. Цей параметр буде видалений у майбутньому релізі. - Оновлено значення за замовчуванням параметра
should_remeshдля Meshy-6 в API Текст у 3D та Зображення у 3D. Тепер цей параметр за замовчуванням має значенняfalseдляmeshy-6таtrueдля інших моделей, якщо не вказано інше.
19 січня
- Параметр
latestдляai_modelв API Текст у 3D (Preview) та Зображення у 3D тепер відповідає Meshy 6.
12 січня
- Додано новий параметр
model_typeдо API Зображення у 3D для генерації низькополігональних мешів, оптимізованих для чистіших полігонів.
Грудень 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 Text to 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
- Text to 3D Refine API тепер підтримує
ai_model = latest, що відповідає Meshy 6 Preview. - Image to 3D API тепер за замовчуванням використовує текстурування Meshy-6-preview, коли
ai_model = latestіshould_texture = true. - Multi-Image to 3D API тепер підтримує
ai_model = latest, за замовчуванням виконуючи текстурування за допомогою Meshy-6-preview, тоді як генерація сітки залишається на Meshy-5. - Retexture API додає опцію
latestдляai_model(Meshy-6-preview) і тепер використовує її за замовчуванням, якщо параметр не вказано.
04 лист
- Remesh API тепер зберігає текстури для завантажених моделей.
- Retexture API тепер зберігає текстури для завантажених моделей, якщо увімкнено параметр
enable_original_uv.
Жовтень 2025
28 жовт
- Додано заголовок відповіді
x-api-versionдля позначення поточної версії сервера API.
20 жовт
- Додано необов'язковий булевий параметр
convert_format_onlyдо Remesh API для підтримки конвертації формату вхідного файлу моделі без інших змін. - Додано
rigged_character_glb_urlдо відповіді The Rigging Task Object.
Oct 01
- Видалено API
text-to-voxel
Вересень 2025
Sep 23
- Додано опцію
latestдляai_modelв API Текст у 3D для використання Meshy 6 Preview. - Введено тимчасову знижку 50% на завдання генерації Meshy-6-preview до 10 кредитів, яка діятиме до 30 вересня 2025 року. Після закінчення періоду знижки вартість завдань Meshy-6-preview повернеться до звичайних 20 кредитів.
Sep 18
- Оновлено ціни на API для Текст у 3D та Зображення у 3D, щоб відобразити різну вартість для Meshy 6 та інших моделей.
Sep 16
- Додано параметр
latestдляai_modelв API Зображення у 3D для використання Meshy 6 Preview.
Sep 4
- Розширено підтримку вхідних даних
model_urlдо.glb,.gltf,.obj,.fbx,.stlдля Ремеш та Ретекстурування.
Серпень 2025
Aug 18
- Додано необов'язковий параметр
is_a_t_poseдо API Текст у 3D 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
- Додано API Ретекстурування, яке дозволяє користувачам ретекстурувати 3D-моделі на основі найновіших базових AI-моделей Meshy.
Jun 19
- Додано API для видалення для Текст у 3D, Зображення у 3D, Ремеш, Rigging та Анімація.
- Додано параметр
ai_modelдо Text to 3D Refine API.
Jun 17
- Додано документацію для Webhooks.
Jun 10
- Remesh API тепер підтримує моделі у форматі GLB, закодовані у base64, у параметрі
model_urlчерез Data URI.
May 2025
May 20
- Додано необов'язковий параметр
moderationдо API Text to 3D Preview, Text to 3D Refine, Image to 3D та Multi-Image to 3D. Коли параметр увімкнено, вхідний контент автоматично перевіряється на потенційно шкідливий вміст перед генерацією.
15 травня
- Представлено API автоматичного ріггінгу та анімації, що дозволяє користувачам автоматично створювати риг та анімувати 3D-моделі. Дізнатися більше про Rigging та Animation.
Квітень 2025
29 квітня
- Представлено Multi-Image to 3D API, що дозволяє генерувати 3D-моделі з 1-4 вхідних зображень за допомогою AI-моделі
meshy-5. - Додано варіант AI-моделі
meshy-5до API Text to 3D та Image to 3D. Тегlatestтепер також вказує наmeshy-5.
Apr 17
- Додано параметр
texture_image_urlдо API Зображення у 3D та Text to 3D Refine, що дозволяє користувачам керувати процесом генерації текстури за допомогою зображення.
Березень 2025
Mar 28
- Додано параметр
latestдо API Текст у 3D та Зображення у 3D, що надає доступ до наших майбутніх вдосконалених AI-моделей для покращеної якості генерації.
Mar 14
- Text to Texture 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 кредитів за виклик
- Текст у 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 та Текст у 3D Refine, що дозволяє користувачам керувати процесом генерації текстури за допомогою текстового prompt.
Січень 2025
Jan 23
- Додано endpoints для отримання списку завдань до API Текст у 3D, Зображення у 3D, Ремеш та Текст у текстуру.
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, що дозволяє налаштовувати параметри симетрії.
December 2024
Dec 19
- Додано Remesh APIs, які дозволяють користувачам виконувати ремеш та експортувати наявні 3D-моделі, згенеровані іншими API Meshy, у різні формати.
- Оновлено ліміти кількості полігонів для наших API до діапазону 100-300,000 для користувачів Premium.
Dec 12
- Застаріла властивість
model_urlв усіх об'єктах відповіді. - Відокремлено застаріле API Meshy-3 від останнього API Meshy-4.
Dec 10
- Додано параметр
enable_pbrдо API Зображення у 3D та Text to 3D Refine. - Додано параметр
should_textureдо API Зображення у 3D. - Застаріла опція
pbrу параметріart_styleдля API Text to 3D Preview при використанні AI-моделіmeshy-4. - Застаріла опція
low-polyу параметріart_styleдля API Text to 3D Preview.
Dec 5
- Додано Get Balance API, що дозволяє користувачам отримувати баланс кредитів.
- Додано параметр
should_remeshдо API Зображення у 3D та Text to 3D Preview.
Dec 3
- Зовнішні API тепер використовують префікс
/openapi. Legacy-шляхи й надалі підтримуються, але ми рекомендуємо перейти на нові шляхи.
Листопад 2024
Nov 14
- Image to 3D API тепер підтримує зображення у форматі base64.