lowpoly буде вимкнено 30 жовт. 2026 р.. Перейдіть на іншу модель до цих дат, щоб уникнути помилок у запитах. Усі застарілі функції

журнал змін

Перегляньте всі останні функції та оновлення Meshy API та плагінів.

Віддаєте перевагу стрічці подій у реальному часі? Останні записи також відображаються на сторінці огляду Developer Platform.

Листопад 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_url Meshy 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") у Text to 3D та Image to 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 також приймає завдання Text to 3D refine та Ретекстурування.

26 жовтня

  • Нова сторінка Deprecations: життєвий цикл кожної моделі 3D-генерації (активна, Legacy, застаріла або знята з експлуатації) із датою завершення підтримки та рекомендованою заміною, історія кожного випадку застарівання API, а також параметри, що застаріли, але досі підтримуються. Банер про завершення підтримки на сторінках API тепер містить посилання на цю сторінку.

23 жовтня

  • Параметр texture_image_url позначено як застарілий у Rigging. Meshy використовує текстури, вбудовані у файл model_url, або текстури вхідного завдання, тож не передавайте цей параметр, якщо модель має власні текстури. Якщо ви його надішлете, зображення стане єдиною текстурою моделі з ригом, і модель втратить свої PBR-карти.

21 жовтня

  • Додано заголовок X-Meshy-Metadata для команд Studio та Enterprise до кожної кінцевої точки, яка створює завдання, за винятком кінцевих точок Creative Lab. Позначайте завдання власними парами ключ-значення, наприклад user=alex@example.com,team=fab, і зчитуйте їх у полі metadata записів Usage. Див. Metadata.

19 жовтня

  • export_resolution тепер приймає значення до 512, замість попередніх 2048, для завдань побудови Keychain та Fridge Magnet. 512 — це роздільна здатність карти глибини, на основі якої будується геометрія, тож будь-яке значення вище неї додавало зайві вершини між вже наявними семплами, що давало більший файл, який описує ту саму поверхню. 512 також є значенням за замовчуванням, тому виклики, в яких export_resolution ніколи не встановлювався, залишаються без змін. Значення вище 512 тепер повертає 400 на етапі створення замість того, щоб прийматися. 2048, зокрема, завжди перевищувало граничний час генератора і завершувалося невдачею вже після запуску завдання. Якщо ви встановлюєте export_resolution вище 512, приберіть цей параметр або встановіть значення 512.

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; щоб і надалі використовувати Meshy T2, встановіть ai_model: "meshy-t2". Мульти-зображення у 3D не підтримує meshy-t2.5.

Oct 14

  • model_url тепер приймає файли розміром до 400 МБ (раніше було 100 МБ), якщо це http або https URL, у Ретекстурування, Ремеш, 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 секунд (див. 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 та Анімація це не стосується.

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 залишився без змін.

Oct 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 застаріле, але продовжує працювати без змін.
  • Додано 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 для Text to 3D, Image to 3D, Multi-Image to 3D або Retexture, і після 10 жовтня запити, що надсилають ai_model: "meshy-5", повертатимуть помилку.
  • Спільний тестовий API-ключ було виведено з експлуатації; запити, які все ще надсилають його, тепер повертають 401 Unauthorized. Якщо ви скопіювали його в код або CI, замініть його на власний ключ зі сторінки API Keys. Цей ключ завжди повертав той самий зразок моделі незалежно від вхідних даних, тому він ніколи не показував, що насправді згенерує запит. Щоб побачити, що повертає API перед тим, як будувати на ньому розробку, скористайтеся Playground у Developer Platform, який виконує реальне завдання у вашому браузері. На тарифних планах без доступу до API він виконує Зображення у 3D без API-ключа та використовує кредити вашого облікового запису, як і будь-яке інше завдання.

Sep 15

Sep 14

  • Image to Image API тепер приймає input_task_id, тож ви можете напряму продовжити ланцюжок від завершеного завдання Text to Image або Image to Image, замість того щоб копіювати URL-адреси його результату в reference_image_urls.

Sep 11

  • Зміна поведінки: DELETE для завдання, яке вже перебуває у стані IN_PROGRESS, тепер відхиляється з кодом 409 Conflict, а саме завдання продовжує виконуватися. Раніше він повертав 200 OK, зупиняв воркер і відкидав результат, але при цьому кредити не поверталися, оскільки відшкодуванню підлягають лише завдання зі статусом PENDING. Такий виклик коштував вам і моделі, і кредитів, причому у відповіді про це нічого не повідомлялося. Якщо ваша інтеграція видаляє завдання для їх скасування, майте на увазі: завдання, яке воркер уже почав виконувати, скасувати не можна. Дочекайтеся статусу SUCCEEDED, FAILED або CANCELED, а потім видаляйте його. Завдання зі статусом PENDING, як і раніше, видаляються з поверненням коштів так само, як і раніше, а завершені (термінальні) завдання, як і раніше, видаляються. Застосовується до всіх родин завдань у /openapi. Див. Помилки.
  • Додано meshy-6-lite до задокументованих значень ai_model для API Text to 3D, Image to 3D, Multi-Image to 3D та Retexture. Це наступник meshy-5: ті самі параметри, та сама вартість у кредитах (5 за сітку, 15 із текстурою, 10 за ретекстурування).
  • meshy-5 тепер вважається застарілим у всіх API, що його приймають. Він продовжує працювати, і ні у вашому запиті, ні у вашому рахунку нічого не змінюється, але в одному з майбутніх релізів він перестане приймати новий трафік. Якщо ваша інтеграція надсилає ai_model: "meshy-5", перейдіть на meshy-6-lite.

9 вересня

  • Новий Auto Split API: розділяє нетекстуровану модель Meshy 6 або Meshy 7 на окремі частини, придатні для друку. Розділення виконується автоматично, за частинами, які ви вказали (by_parts), або за кольоровими зонами (by_color), з опціональними шиповими з'єднаннями та підсиленням тонких стінок. Експортує кожну частину як окремий об'єкт у glb, obj, fbx, usdz, blend або 3mf, у зібраному вигляді або розкладеними на друкувальній платформі (layout). 10 кредитів за завдання.

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 для попереднього перегляду, коли Meshy може його відрендерити.

3 вер

  • Етап прототипу Creative Lab Lamp API тепер повертає 3D-модель. POST /prototype перетворює концептуальне зображення на порожній абажур GLB, а об'єкт завдання прототипу отримує model_urls.glb і thumbnail_url на додачу до image_urls. Етап build запускає лише обробник лампи на цій моделі і тепер створює абажур з відкритим дном і базовою платою для світлового елемента. Ціни змінюються відповідно до обсягу роботи. Прототип коштує 30 кредитів, а build — 6 кредитів (раніше було 6 і 30). Параметр text для прототипу видалено, а image_url тепер є обов'язковим.

2 вер.

  • Animation API тепер приймає action_ids, тож ви можете застосувати до 10 попередньо заданих дій до ризованого персонажа в одному запиті та отримати єдиний файл, що містить один анімаційний кліп на кожну дію, готовий для керування зі станової машини в ігровому рушії. Кліпи зберігають порядок, у якому ви їх перелічили, і несуть назву бібліотеки анімації. Вартість — 3 кредити за дію, а post_process застосовується до об'єднаного файлу. Див. Довідник з Бібліотеки анімацій для доступних id та таблицю цін.

Sep 1

  • Додано параметр ultra_mode до Multi-Image to 3D API: вмикає генерацію 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

  • Додано параметр 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 з видаленим фоном.

18 серп.

  • Додано параметр texture_image_urls до Multi-Image to 3D API: надайте від 1 до 4 зображень одного й того ж об'єкта для керування текстуруванням замість одного texture_image_url. Потребує ai_model meshy-7 або latest і не залежить від image_urls. Ці два списки можуть містити різні зображення та різну їх кількість.

17 серп.

  • Додано параметр remove_background до Text to Image API та Image to Image API. Встановіть remove_background: true, щоб отримати згенероване зображення у вигляді прозорого PNG із каналом RGBA з видаленим фоном.

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_type Smart 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

July 2026

Jul 27

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

Jul 22

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

Jul 21

  • Тепер ми підтримуємо 8K-текстури базового кольору завдяки новому параметру texture_resolution (2k / 4k / 8k) на endpoint'ах Image to 3D, Multi-Image to 3D, Text to 3D Refine та Retexture. При значенні 8k PBR-карти генеруються у 4K, а карта випромінювання (emission) не створюється. Генерація 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

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

  • Додано параметр multi_view_thumbnails до API Зображення у 3D. Якщо встановлено значення true, завдання додатково рендерить чотири мініатюри з основних ракурсів (спереду, справа, ззаду, зліва) і повертає їх у новому полі відповіді thumbnail_urls. Наявне поле thumbnail_url залишається без змін. Додає приблизно 3 секунди до затримки виконання завдання.

12 травня

  • Додано параметр resize_longest_side до API Ремеш. Змінює розмір моделі так, щоб найдовший вимір обмежувального паралелепіпеда дорівнював заданому значенню в метрах. Взаємовиключний з resize_height та auto_size.

11 травня

7 травня

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

Квітень 2026

Apr 27

  • Додано поле consumed_credits до всіх відповідей завдань у кожній кінцевій точці API. Показує кількість кредитів, витрачених на кожне завдання. Поле присутнє для завдань у статусах PENDING, IN_PROGRESS та SUCCEEDED. Повертає 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

Apr 14

Apr 12

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

Березень 2026

Apr 2

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

Mar 20

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

Mar 17

February 2026

Feb 28

Feb 25

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

Feb 20

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

Січень 2026

Jan 27

  • Додано детальну документацію Режими збоїв для всіх кінцевих точок API, включно з поширеними кодами помилок HTTP (400, 401, 402, 404, 422, 429) та причинами невдалого виконання завдань. Це допомагає розробникам краще розуміти та обробляти помилки API.

Jan 26

  • API Мульти-зображення у 3D тепер підтримує Meshy-6 для повної генерації сітки. Параметр ai_model тепер приймає значення meshy-6, а latest відповідає Meshy 6.

22 січня

  • Застаріло art_style для API Попередній перегляд тексту у 3D (Meshy-6). Цей параметр був розроблений для застарілих моделей (Meshy-4 / Meshy-5) і буде видалений у майбутньому релізі.
  • Застаріло enable_pbr для API Текст у 3D та Зображення у 3D, коли ai_model дорівнює meshy-4. Цей параметр буде видалений у майбутньому релізі.
  • Оновлено значення за замовчуванням параметра should_remesh для Meshy-6 в API Текст у 3D та Зображення у 3D. Тепер за замовчуванням параметр має значення false для meshy-6 та true для інших моделей, якщо не вказано інше.

19 січня

12 січня

  • Додано новий параметр model_type до API Зображення у 3D для генерації низькополігональних мешів, оптимізованих для чистіших полігонів.

Грудень 2025

31 груд

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

Dec 22

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

Dec 04

Листопад 2025

Nov 24

Nov 06

  • API Text to 3D Refine тепер підтримує ai_model = latest, що відповідає Meshy 6 Preview.
  • API Зображення у 3D тепер за замовчуванням використовує текстурування Meshy-6-preview, коли ai_model = latest та should_texture = true.
  • API Мульти-зображення у 3D тепер підтримує ai_model = latest, за замовчуванням запускаючи Meshy-6-preview для текстурування, тоді як генерація сітки залишається на Meshy-5.
  • API Ретекстурування додає опцію latest для ai_model (Meshy-6-preview) та тепер використовує її за замовчуванням, якщо параметр не вказано.

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.

01 жовтня

  • Видалено API text-to-voxel

Вересень 2025

23 вересня

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

18 вересня

Sep 16

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

Sep 4

Серпень 2025

Aug 18

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

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. Якщо його увімкнено, вхідний контент автоматично перевіряється на потенційно шкідливий вміст перед генерацією.

May 15

April 2025

Apr 29

  • Представлено Multi-Image to 3D API, що дозволяє генерувати 3D-моделі з 1-4 вхідних зображень за допомогою AI-моделі meshy-5.
  • Додано опцію AI-моделі meshy-5 до API Текст у 3D та Зображення у 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

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) для оновлень завдань у реальному часі:

6 лют

  • Додано параметр texture_prompt до API Зображення у 3D та Text to 3D Refine, що дозволяє користувачам керувати процесом генерації текстури за допомогою текстового prompt.

Січень 2025

23 січ

Jan 14

  • Застаріли legacy API для Text to 3D та Image to 3D на базі AI-моделей Meshy-3.

Jan 07

  • Додано параметр symmetry_mode до API Text to 3D Preview та Image to 3D, що дозволяє налаштовувати параметри симетрії.

December 2024

Dec 19

  • Додано Remesh APIs, які дозволяють користувачам виконувати ремеш та експортувати наявні 3D-моделі, згенеровані іншими Meshy API, у різні формати.
  • Оновлено ліміти кількості полігонів для наших API до діапазону від 100 до 300 000 для користувачів Premium.

12 груд.

  • Застаріла властивість model_url в усіх об'єктах відповіді.
  • Відокремлено застаріле Meshy-3 API від найновішого Meshy-4 API.

10 груд.

Dec 5

Dec 3

  • Зовнішні API тепер використовують префікс /openapi. Застарілі шляхи залишаються підтримуваними, але ми рекомендуємо перейти на нові шляхи.

Листопад 2024

Nov 14