Журнал змін

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

Вересень 2026

Sep 3

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

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, до вашого персонажа-біпеда з rig, як альтернативу заданому action_id. Ті самі 3 кредити за завдання.

Aug 24

Aug 21

  • Додано Text to Motion API: генерація кліпу руху персонажа з опису природною мовою, модель персонажа не потрібна. Оберіть prime mode (10 кредитів, вивід у FBX) для найвищої якості або swift mode (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, щоб отримати зображення прототипу у вигляді прозорого PNG у форматі RGBA з видаленим фоном.

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, щоб отримати згенероване зображення у вигляді прозорого RGBA PNG з видаленим фоном.

Aug 13

  • Додано ai_model: "meshy-7" до Text to 3D API: нашої найновішої моделі 3D-генерації з вищоточнішою геометрією, ніж Meshy 6. Вона також вводить параметр ultra_mode для завдання попереднього перегляду, який вмикає генерацію 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, за замовчуванням 4 000). Попередній перегляд 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

Липень 2026

Jul 27

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

Jul 22

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

Jul 21

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

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 тепер вважається застарілим, але продовжує обслуговувати трафік для зворотної сумісності.

Jul 7

  • Додано параметр aspect_ratio до API Зображення у зображення, що дозволяє контролювати співвідношення сторін вихідного зображення під час редагування. Допустимі значення: 1:1, 16:9, 9:16, 4:3, 3:4 для моделей nano-banana та 1:1, 3:2, 2:3 для gpt-image-2. Необов'язковий; за замовчуванням 1:1, і не може поєднуватися з generate_multi_view.

June 2026

Jun 17

  • Нова сторінка документації API Playground: інтерактивна консоль для тестування endpoint'ів без написання коду з подальшим копіюванням еквівалентного коду на cURL, Python або JavaScript. Доступна на планах Pro, Premium, Ultra, Studio та Enterprise.

15 черв.

  • Новий UV Unwrap API: генерує високоякісну UV-розкладку для наявної 3D-моделі — необхідний етап перед текстуруванням або в будь-якому випадку, коли вам потрібна чиста, без накладень UV-розкладка для подальших інструментів. Приймає або input_task_id (завершене завдання Зображення у 3D, Текст у 3D або Ремеш), або model_url (лише .glb) і повертає «UV білу модель» з абсолютно новими UV-координатами. 5 кредитів за виклик. Підтримує сітки до 40 000 граней (якщо більше — спершу запустіть Remesh); чотирикутні та n-кутні сітки тріангулюються під час генерації UV.

12 черв.

  • Оновлено ціни на Build у Creative Lab API до 30 кредитів за виклик для брелок, магніт на холодильник та фігурка (раніше 20). лампа залишається без змін — 30 кредитів. Ціни на Prototype без змін — 6 кредитів за зображення. Дивіться Ціни для повного розбору.

5 черв.

Jun 1

  • Нові Creative Lab APIs: сімейство 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 травня

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.

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

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

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 січня

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

Листопад 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.

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

16 вер

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

4 вер

Серпень 2025

18 сер

13 серп.

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

Липень 2025

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

May 15

Квітень 2025

Apr 29

Apr 17

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

Березень 2025

Mar 28

  • Додано параметр latest до API Текст у 3D та Зображення у 3D, що надає доступ до наших майбутніх вдосконалених моделей ШІ для покращеної якості генерації.

14 бер.

06 бер.

  • Оновлено ціни для завдань генерації через API:
    • Текст у 3D (Попередній перегляд): збільшено з 2 до 5 кредитів за виклик
    • Текст у 3D (Уточнення): збільшено з 5 до 10 кредитів за виклик
    • Зображення у 3D: тепер 5 кредитів без текстури, 15 кредитів із текстурою
    • Текст у текстуру: збільшено з 5 до 10 кредитів за виклик
    • Текст у воксель: залишається 5 кредитів за виклик

Лютий 2025

Feb 18

  • Додано API-ключ тестового режиму, який дозволяє розробникам тестувати інтеграцію з API без витрачання кредитів. Усі дійсні запити з використанням цього ключа повертатимуть однакові результати зразкового завдання.

Feb 13

  • Критичні зміни:

    • Створення завдань на безкоштовному рівні завершиться 20 березня 2025 року. Після цього всі запити на завдання через API вимагатимуть платної підписки. Щоб зберегти безперебійний доступ, рекомендуємо оновитися до настання цього терміну.
    • Використайте код купона APIACCESS, щоб отримати знижку 40%. Дякуємо, що ви з нами!

  • Додано endpoint потокової передачі Server-Sent Events (SSE) для оновлень завдань у реальному часі:

Feb 6

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

Січень 2025

Jan 23

Jan 14

  • Застаріли попередні 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

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

12 груд.

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

10 груд.

Dec 5

Dec 3

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

Листопад 2024

Nov 14

  • Image to 3D API тепер підтримує зображення у форматі base64.