Журнал змін

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


Вересень 2026

Sep 3

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

Sep 1

  • Додано параметр ultra_mode до Multi-Image to 3D API: вмикає режим Ultra generation для 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 до API Мульти-зображення у 3D: надайте від 1 до 4 зображень одного й того самого об'єкта для керування текстуруванням замість одного texture_image_url. Потребує ai_model meshy-7 або latest і не залежить від image_urls — ці два списки можуть містити різні зображення та різну кількість зображень.

17 серп.

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

July 2026

Jul 27

  • Новий Creative Lab — Brick Figure API: перетворює фото на колекційну 3D-мініфігурку у стилі цеглинок. Той самий двоетапний робочий процес, що й у Figure APIprototype (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) не створюється. Генерація 8K текстури коштує 15 кредитів (2k/4k залишаються по 10). Див. Ціни.
  • Булевий параметр hd_texture є застарілим на користь texture_resolution — він все ще підтримується і еквівалентний texture_resolution: "4k" для зворотної сумісності.

Jul 20

  • Новий Creative Lab — Vinyl Figure API: перетворює фото на велику вінілову колекційну 3D-фігурку. Той самий дворівневий робочий процес, що й у Figure APIprototype (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-розгортка API: генерує високоякісну UV-розкладку для наявної 3D-моделі — обов'язковий крок перед текстуруванням або будь-коли, коли потрібна чиста, без накладень UV-розкладка для подальшої роботи в інших інструментах. Приймає або input_task_id (завершене завдання Зображення у 3D, Текст у 3D або Ремеш), або model_url (лише .glb) і повертає "UV білу модель" з абсолютно новими UV-координатами. 5 кредитів за виклик. Підтримує меші до 40 000 граней (якщо більше — спочатку виконайте Ремеш); чотирикутні та 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. Кожен з них використовує дворівневий робочий процес prototypebuild, пов'язаний через input_task_id, і подається за URL-адресами, прив'язаними до продукту (/openapi/creative-lab/<product>/v1/...), з версіонуванням для кожного продукту окремо, щоб продукти могли розвиватися незалежними лініями версій. Prototype: 6 кредитів за виклик. Build: 30 кредитів за виклик.

May 2026

May 26

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

May 22

  • Функціональність конвертації та зміни розміру з Remesh API тепер доступна як окремі endpoint'и Convert API та Resize API. Застарілі параметри в Remesh продовжуватимуть працювати для зворотної сумісності.

May 13

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

May 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 квіт.

14 квітня

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


Лютий 2026

Feb 28

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.

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

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), забезпечуючи покращену якість та узгодженість.

July 2025

Jul 31


Червень 2025

Jun 25

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

Jun 19

Jun 17

  • Додано документацію для Webhooks.

Jun 10

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

Травень 2025

May 20

  • Додано опціональний параметр moderation до API Text to 3D Preview, Text to 3D Refine, Image to 3D та Multi-Image to 3D. Якщо параметр увімкнено, вхідний контент автоматично перевіряється на наявність потенційно шкідливого вмісту перед генерацією.

15 травня

  • Представлено API для автоматичного ріггінгу та Анімації, що дозволяє користувачам автоматично створювати риг і анімувати 3D-моделі. Дізнатися більше про Rigging та Анімацію.

Квітень 2025

29 квіт.

  • Представлено Multi-Image to 3D API (Мульти-зображення у 3D), що дозволяє генерувати 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-моделей для покращеної якості генерації.

14 бер

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 та Text to 3D Refine, що дозволяє користувачам керувати процесом генерації текстури за допомогою текстового prompt.

January 2025

Jan 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

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

Dec 12

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

Dec 10

Dec 5

Dec 3

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

Листопад 2024

Nov 14