Журнал змін

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

Червень 2026

`Jun 17`

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

`Jun 15`

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

`Jun 12`

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

`Jun 5`

Додано необов’язковий параметр alpha_thumbnail до API Зображення у 3D, Мульти-зображення у 3D, Текст у 3D, Ретекстурування, Ремеш і Відновлення придатності до друку. Коли встановлено значення true, завдання додатково рендерить версію попереднього перегляду з прозорим фоном (RGBA) і повертає її в новому полі відповіді alpha_thumbnail_url. Наявний thumbnail_url залишається без змін. За замовчуванням має значення false.

`Jun 1`

Нові API Creative Lab: сімейство endpointів, обмежених певним продуктом, які перетворюють вихідну фотографію (або текстовий prompt) на споживчий продукт, придатний для 3D-друку. Чотири продукти на запуску — брелок, магніт на холодильник, фігурка і лампа. Кожен використовує двоетапний робочий процес prototype → build, пов’язаний через input_task_id, і обслуговується за URL-адресами, обмеженими певним продуктом (/openapi/creative-lab/<product>/v1/...), із версіонуванням для кожного продукту, щоб продукти могли розвиватися в незалежних лініях версій. Прототип: 6 кредитів за виклик. Збірка: 30 кредитів за виклик.

Травень 2026

`May 26`

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

`May 22`

Функціональність Конвертувати та Змінити розмір з API Ремеш тепер доступна як окремі endpoint-и API Конвертувати та API Змінити розмір. Застарілі параметри в Ремеш і надалі працюватимуть для зворотної сумісності.

`May 13`

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

`May 12`

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

`May 11`

Застаріле: параметр symmetry_mode для endpointів Текст у 3D, Зображення у 3D та Мульти-зображення у 3D. Цей параметр більше не впливає на результат.

`May 7`

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

Квітень 2026

`Apr 27`

Додано поле consumed_credits до всіх відповідей завдань у кожній кінцевій точці API. Показує кількість кредитів, спожитих кожним завданням. Поле присутнє для завдань зі статусами PENDING, IN_PROGRESS і SUCCEEDED. Повертає 0 для завдань зі статусом FAILED (кредити автоматично повертаються в разі невдачі). Див. Ціни, щоб дізнатися вартість у кредитах для кожної кінцевої точки.

`Apr 24`

Додано параметр 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 у Зображення у 3D, Мульти-зображення у 3D, Text to 3D Refine і Ретекстурування. Зміна запиту не потрібна.

`Apr 14`

Додано параметр decimation_mode до endpointів Зображення у 3D, Мульти-зображення у 3D, попереднього перегляду Тексту у 3D та Ремешу. Задає адаптивний рівень зменшення кількості полігонів: 1 (ультра), 2 (високий), 3 (середній) або 4 (низький).

`Apr 12`

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

Березень 2026

`Apr 2`

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

`Mar 20`

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

`Mar 17`

Додано необов’язковий параметр target_formats до endpoint Зображення у 3D, Мульти-зображення у 3D, Текст у 3D та Ретекстурування. Укажіть, які 3D-формати генерувати (наприклад, ["glb", "fbx"]), щоб скоротити час виконання завдання.

Лютий 2026

`Feb 28`

Додано параметр remove_lighting до API Зображення у 3D, Мульти-зображення у 3D, Уточнення Тексту у 3D і Ретекстурування. Видаляє відблиски й тіні з текстури базового кольору для чистіших результатів за користувацького освітлення. Підтримується лише для meshy-6 і latest. За замовчуванням — true.
API Ретекстурування і Уточнення Тексту у 3D тепер підтримують meshy-6 як значення ai_model для повноцінного текстурування Meshy 6.

`Feb 25`

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

`Feb 20`

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

Січень 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 (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 для інших моделей, якщо його не вказано.

`Jan 19`

Опція latest для ai_model в API Текст у 3D (попередній перегляд) та Зображення у 3D тепер відповідає Meshy 6.

`Jan 12`

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

Грудень 2025

`31 грудня`

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

`Dec 22`

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

`Dec 04`

Додано новий параметр pose_mode до API попереднього перегляду Текст у 3D, Зображення у 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 уточнення Текст у 3D тепер підтримує 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) і тепер використовує її за замовчуванням, якщо її не вказано.

`Nov 04`

API Ремешу тепер зберігає текстури для завантажених моделей.
API Ретекстурування тепер зберігає текстури для завантажених моделей, коли опцію enable_original_uv увімкнено.

Жовтень 2025

`Oct 28`

Додано заголовок відповіді x-api-version, щоб указувати поточну версію сервера API.

`Oct 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, Зображення у 3D та Мульти-зображення у 3D для генерування моделей у позі A/T.

`Aug 13`

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

Липень 2025

`Jul 31`

Підтримка карт PBR-текстур в API через параметр enable_pbr для найновішої моделі meshy-5 для endpoint'ів Текст у 3D, Зображення у 3D, Мульти-зображення у 3D та Ретекстурування.

Червень 2025

`Jun 25`

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

`Jun 19`

Додано API видалення для Текст у 3D, Зображення у 3D, Ремеш, Ригінг та Анімація.
Додано параметр ai_model до API уточнення Текст у 3D.

`Jun 17`

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

`Jun 10`

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

Травень 2025

`20 травня`

Додано необов’язковий параметр moderation до API попереднього перегляду Текст у 3D, уточнення Текст у 3D, Зображення у 3D та Мульти-зображення у 3D. Якщо ввімкнено, вхідний контент автоматично перевіряється на потенційно шкідливий контент перед генерацією.

`May 15`

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

Квітень 2025

`Apr 29`

Представлено API Мульти-зображення у 3D, що дає змогу генерувати 3D-моделі з 1–4 вхідних зображень за допомогою моделі ШІ meshy-5.
Додано варіант моделі ШІ meshy-5 до API Текст у 3D та Зображення у 3D. Тег latest тепер також указує на meshy-5.

`Apr 17`

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

Березень 2025

`Mar 28`

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

`Mar 14`

API Текст у текстуру тепер підтримує моделі, закодовані у base64, у параметрі model_url через Data URI, подібно до image_url в API Зображення у 3D.

`Mar 06`

Оновлено ціни для завдань генерації API:
- Текст у 3D (Preview): збільшено з 2 до 5 кредитів за виклик
- Текст у 3D (Refine): збільшено з 5 до 10 кредитів за виклик
- Зображення у 3D: тепер 5 кредитів без текстури, 15 кредитів із текстурою
- Текст у текстуру: збільшено з 5 до 10 кредитів за виклик
- Text to Voxel: залишається 5 кредитів за виклик

Лютий 2025

`Feb 18`

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

`Feb 13`

Критичні зміни:
- Створення завдань на безкоштовному рівні завершиться March 20, 2025. Після цього всі запити завдань API вимагатимуть платної підписки. Щоб зберегти безперебійний доступ, рекомендуємо оновити тариф до кінцевого терміну.
- Використайте код купона APIACCESS, щоб отримати знижку 40%. Дякуємо, що ви з нами!
Додано потокові endpoint-и Server-Sent Events (SSE) для оновлень завдань у реальному часі:

`Feb 6`

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

Січень 2025

`Jan 23`

Додано endpoints для отримання списку завдань в API Текст у 3D, Зображення у 3D, Ремеш і Текст у текстуру.

`Jan 14`

Позначено як застарілі Legacy API Текст у 3D та Зображення у 3D на базі моделей ШІ Meshy-3.

`Jan 07`

Додано параметр symmetry_mode до API попереднього перегляду Текст у 3D та Зображення у 3D, що дає змогу налаштовувати параметри симетрії.

Грудень 2024

`Dec 19`

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

`Dec 12`

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

`Dec 10`

Додано параметр enable_pbr до API Зображення у 3D і Уточнення Тексту у 3D.
Додано параметр should_texture до API Зображення у 3D.
Позначено опцію pbr у параметрі art_style як застаріле для API Попереднього перегляду Тексту у 3D під час використання моделі ШІ meshy-4.
Позначено опцію low-poly у параметрі art_style як застаріле для API Попереднього перегляду Тексту у 3D.

`Dec 5`

Додано API отримання балансу, щоб користувачі могли отримувати свій баланс кредитів.
Додано параметр should_remesh до API Зображення у 3D та попереднього перегляду Текст у 3D.

`3 грудня`

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

Листопад 2024

`Nov 14`

API Зображення у 3D тепер підтримує зображення, закодовані у base64.