Журнал змін
Переглядайте всі останні функції та оновлення Meshy API та плагінів.
Віддаєте перевагу живій стрічці? Останні записи також з'являються на сторінці огляду Платформи для розробників.
Жовтень 2026
Oct 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залишилося без змін.
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.
Sep 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. Див. Помилки. - Додано
meshy-6-liteдо задокументованих значеньai_modelдля API Текст у 3D, Зображення у 3D, Мульти-зображення у 3D та Ретекстурування. Це наступникmeshy-5: ті самі параметри, та сама вартість у кредитах (5 за сітку, 15 з текстурою, 10 за ретекстурування). meshy-5тепер вважається застарілим у всіх API, що його приймають. Він продовжує працювати, і ваш запит та рахунок залишаються без змін, але у майбутньому релізі він перестане приймати новий трафік — якщо ваша інтеграція надсилаєai_model: "meshy-5", перейдіть наmeshy-6-lite.
Sep 9
- Новий Auto Split API: розділяє нетекстуровану модель Meshy 6 або Meshy 7 на окремі частини, придатні для друку — автоматично, за частинами, які ви вкажете (
by_parts), або за кольоровими зонами (by_color) — з опціональними шиповими з'єднаннями (mortise-and-tenon) та посиленням тонких стінок. Експортує кожну частину як окремий об'єкт у форматіglb,obj,fbx,usdz,blendабо3mf, у зібраному вигляді або розкладеними на друкувальній платформі (layout). 10 кредитів за завдання.
Sep 7
- Додано параметр
name_textдо етапу прототипування Creative Lab Keychain API: дозволяє вигравіювати на брелоку ім'я довжиною до 10 символів — таку саму персоналізацію пропонує й веб-застосунок. Етап побудови автоматично успадковує гравіювання, а об'єкт завдання прототипу тепер повертаєname_text, щоб ви могли підтвердити точний текст перед побудовою. Зверніть увагу, щоnameзалишається лише відображуваною міткою завдання і не гравіюється.
5 вер.
- Додано Creative Lab Fidget Pixel API: перетворення фотографії на багатокольорову 3D-друковану фіджет-панель у стилі піксель-арт у два етапи.
POST /prototype(6 кредитів) піксилізує фотографію у піксель-арт зображення — передайтеtypeякpersonабоother, щоб обрати стиль піксилізації — аPOST /build(30 кредитів) накладає його на сітку16або32та перетворює кожен піксель на з'єднувану деталь формиsquareабоhex, видаючи результат у вигляді єдиного 3MF-файлу з кольоровими мітками для друку кількома філаментами. Геометрія деталей налаштовується за допомогоюpiece_size_mm,color_countтаpiece_height_mm.
4 вер
- Додано
GET /openapi/v1/animations/libraryдо Бібліотеки анімацій: отримуйте кожну готову дію, яку приймає Animation API —action_id, назву, категорію та анімоване GIF-прев'ю — з фільтрами пошуку та категорій, щоб ви могли створити власний вибір дій замість читання довідкової таблиці. Безкоштовно; не витрачає кредити. - Додано Creative Lab Collapsible Fidget API: перетворіть фото на складану антистрес-іграшку для друку без складання, де силует об'єкта стає вкладеними концентричними кільцями, які складаються плоско та знову розтягуються, надруковані одним цілим без збирання. Один-єдиний
POSTпроводить зображення аж до готової моделі — тут немає пари етапів prototype/build і немає параметрів геометрії для налаштування. Кожне завдання коштує 6 кредитів і повертає як STL для друку, так і GLB для попереднього перегляду.
Sep 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: генерація кліпу руху персонажа з опису природною мовою, без потреби в моделі персонажа. Оберіть mode
prime(10 кредитів, вивід у форматі FBX) для найвищої якості або modeswift(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 впорядковані ракурси одного об'єкта для мультивидового текстурування.
4 серп
- Розширено підтримку вхідних
model_urlдо.glb,.gltf,.obj,.fbx,.stlдля endpoint'ів Аналіз придатності до друку та Відновлення придатності до друку (раніше —.glb,.stl,.obj). Відновлення повертає відновлений asset у форматі вхідного файлу.
Липень 2026
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 та Ретекстурування. При значенні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
- До 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 граней (якщо більше — спочатку запустіть Ремеш); меші з чотирикутниками та n-кутниками тріангулюються під час генерації UV.
Jun 12
- Оновлено ціну на збірку в Creative Lab API до 30 кредитів за виклик для брелок, магніт на холодильник та фігурка (раніше 20). Для лампа ціна залишилася незмінною — 30 кредитів. Ціна прототипу залишилася незмінною — 6 кредитів за зображення. Повну розбивку див. у розділі Ціни.
Jun 5
- Додано необов'язковий параметр
alpha_thumbnailдо API Зображення у 3D, Мульти-зображення у 3D, Текст у 3D, Ретекстурування, Ремеш та Відновлення придатності до друку. Якщо значення встановлено на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-друку. Асинхронний шаблон створення + потокової передачі: POST повертає task_id, а потім GET / SSE потік повертають показники водонепроникності, об'єму, отворів та немноговидних ребер після статусу SUCCEEDED. Безкоштовно, кредити не витрачаються.
- Новий Repair Printability API: Відновлення придатності до друку 3D-моделі для FDM-друку — виправлення немноговидних ребер, вироджених граней, отворів та інших проблем topology. Приймає існуючий
input_task_idMeshy абоmodel_url(.glb,.stl,.obj). Формат виводу відповідає формату вводу. 10 кредитів за завдання.
Квітень 2026
Apr 27
- До відповідей усіх завдань у кожній кінцевій точці API додано поле
consumed_credits. Воно показує кількість кредитів, витрачених на кожне завдання. Це поле присутнє для завдань у станахPENDING,IN_PROGRESSтаSUCCEEDED. Для завдань у станіFAILEDповертається0(кредити автоматично повертаються у разі помилки). Дивіться розділ Ціни, щоб дізнатися вартість у кредитах для кожної кінцевої точки.
Apr 24
- До кінцевої точки Multi-Color Print додано параметр
model_url. Тепер можна надіслати текстуровану 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: додано групування параметрів із залежними полями, вбудовані значення за замовчуванням, позначки обов'язкових/застарілих параметрів, розгортувану підпанель навігації, а також розділено Мульти-зображення, 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до ендпоінтів Зображення у 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.
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 січня
- Опція
latestдляai_modelв API Текст у 3D (Попередній перегляд) та Зображення у 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
- Додано новий параметр
pose_modeдо API Text to 3D Preview, Зображення у 3D та Мульти-зображення у 3D. Цей параметр приймає значення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
- 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 лист.
- API Ремешу тепер зберігає текстури для завантажених моделей.
- API Ретекстурування тепер зберігає текстури для завантажених моделей, якщо увімкнено опцію
enable_original_uv.
Жовтень 2025
28 жовт.
- Додано заголовок відповіді
x-api-versionдля позначення поточної версії API-сервера.
20 жовт.
- Додано необов'язковий булевий параметр
convert_format_onlyдо API Ремешу для підтримки конвертації формату вхідного файлу моделі без інших змін. - Додано
rigged_character_glb_urlдо відповіді Об'єкта завдання ріггінгу.
Oct 01
- Видалено API
text-to-voxel
Вересень 2025
Sep 23
- Додано опцію
latestдляai_modelв API Текст у 3D для використання Meshy 6 Preview. - Тимчасова знижка 50% діє для завдань генерації Meshy-6-preview до 10 кредитів, яка триватиме до 30 вересня 2025 року. Після закінчення періоду знижки вартість завдань Meshy-6-preview повернеться до звичайних 20 кредитів.
Sep 18
- Оновлено ціни на 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 тепер стабільна для Текст у 3D та Зображення у 3D (
ai_model:meshy-5), забезпечуючи покращену якість і узгодженість.
Липень 2025
Jul 31
- Підтримка PBR текстурних карт в API через параметр
enable_pbrдля найновішої моделіmeshy-5для ендпоінтів Текст у 3D, Зображення у 3D, Мульти-зображення у 3D та Ретекстурування.
Червень 2025
Jun 25
- Додано Retexture API, який дозволяє користувачам виконувати ретекстурування 3D-моделей на основі найновіших фундаментальних AI-моделей Meshy.
Jun 19
- Додано API видалення для Text to 3D, Image to 3D, Remesh, Rigging та Animation.
- Додано параметр
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 для автоматичного ріггінгу та анімації (Auto-rigging & Animation API), що дозволяє користувачам автоматично виконувати rigging та анімувати 3D-моделі. Дізнатися більше про Rigging та Анімація.
Квітень 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 та Текст у 3D Refine, що дозволяє користувачам керувати процесом генерації текстури за допомогою зображення.
Березень 2025
Mar 28
- Додано параметр
latestдо API Текст у 3D та Зображення у 3D, що надає доступ до наших нових вдосконалених AI-моделей для покращення якості генерації.
14 бер.
- API Текст у текстуру тепер підтримує моделі, закодовані у base64, у параметрі
model_urlчерез Data URI, аналогічно доimage_urlв API Зображення у 3D.
06 бер.
- Оновлено ціни для завдань генерації API:
- Текст у 3D (Preview): збільшено з 2 до 5 кредитів за виклик
- Текст у 3D (Refine): збільшено з 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 та Текст у 3D Refine, що дозволяє користувачам керувати процесом генерації текстури за допомогою текстового prompt.
January 2025
Jan 23
- Додано endpoint для отримання списку завдань до API Текст у 3D, Зображення у 3D, Ремеш та Текст у текстуру.
Jan 14
- Застаріли старі API Текст у 3D та Зображення у 3D на основі AI-моделей Meshy-3.
Jan 07
- Додано параметр
symmetry_modeдо API Text to 3D Preview та Image to 3D, що дозволяє налаштовувати параметри симетрії.
Грудень 2024
Dec 19
- Додано Remesh APIs, які дозволяють користувачам виконувати ремеш та експортувати наявні 3D-моделі, згенеровані іншими API Meshy, у різні формати.
- Оновлено ліміти кількості полігонів для наших API до діапазону 100-300,000 для користувачів Premium.
Dec 12
- Застаріла властивість
model_urlв усіх об'єктах відповіді. - Відокремлено застарілий Meshy-3 API від найновішого Meshy-4 API.
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. Застарілі шляхи залишаються підтримуваними, але ми рекомендуємо перейти на нові шляхи.
Листопад 2024
Nov 14
- API Зображення у 3D тепер підтримує зображення у форматі base64.