Журнал змін
Ознайомтеся з усіма останніми функціями та оновленнями для Meshy API та плагінів.
Липень 2026
27 липня
- Новий Creative Lab — API фігурки з кубиків: перетворіть фотографію на колекційну 3D-мініфігурку в стилі конструктора. Той самий двоетапний процес, що й в API фігурки —
prototype(6 кредитів) генерує стилізоване концептуальне зображення,build(30 кредитів) перетворює його на текстуровану 3D-модель із виводом GLB та OBJ + MTL. Повні ціни див. у розділі Ціни.
Jul 21
- Тепер ми підтримуємо 8K-текстури базового кольору за допомогою нового параметра
texture_resolution(2k/4k/8k) у кінцевих точках Зображення у 3D, Мульти-зображення у 3D, Текст у 3D Refine та Ретекстурування. За8kPBR-карти генеруються у 4K, а карта емісії не створюється. Генерація текстур 8K коштує 15 кредитів (2k/4kзалишаються 10). Див. Ціни. - Булевий параметр
hd_textureзастарів на користьtexture_resolution. Для зворотної сумісності він досі підтримується та еквівалентнийtexture_resolution: "4k".
20 липня
- Нова Creative Lab — API винилових фігурок: перетворіть фотографію на великий колекційний 3D-вініловий фігурку з великою головою. Такий самий двоступеневий робочий процес, як і в API фігурок —
prototype(6 кредитів) генерує стилізоване концептуальне зображення,build(30 кредитів) перетворює його в фігурку з текстурованою 3D моделлю з виходами GLB та OBJ + MTL. Дивіться Ціни для повного розподілу.
Jul 13
- Додано новий Smart Topology
model_typeдо API Зображення у 3D, який пропонує дві моделі черезai_model:meshy-t1— поточна низькополігональна модель — іmeshy-t2— нова модель з чистішою topology, розділені частини нативно, вихід у формі трикутників і кількість граней, яку можна налаштувати за допомогоюtarget_polycount.meshy-t2є типовою підsmart-topology. Існуючийmodel_type: lowpolyтепер застаріле, але продовжує обслуговувати трафік для забезпечення зворотної сумісності.
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.
Червень 2026
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 червня
- Оновлено Creative Lab API Вартість створення до 30 кредитів за виклик для брелок, магніт на холодильник та фігурка (раніше 20). лампа залишається без змін на рівні 30 кредитів. Вартість прототипу залишається без змін на рівні 6 кредитів за зображення. Дивіться Ціни для повного розрахунку.
5 червня
- Додано необов'язковий параметр
alpha_thumbnailдо API Зображення у 3D, Мульти-зображення у 3D, Текст у 3D, Ретекстурування, Ремеш і Відновлення придатності до друку. Якщо встановлено значенняtrue, задача додатково рендерить версію попереднього перегляду з прозорим фоном (RGBA) і повертає її в новому полі відповідіalpha_thumbnail_url. Існуюче полеthumbnail_urlзалишається без змін. За замовчуваннямfalse.
Jun 1
- Нові Creative Lab API: набір endpoint, призначених для продуктів, які перетворюють вихідне фото (або текстовий prompt) у споживчий продукт, що підлягає 3D-друку. Чотири продукти на старті — брелок, магніт на холодильник, фігурка та лампа. Кожен слідує двоетапному робочому процесу
prototype→build, з'єднаному черезinput_task_id, обслуговується в межах URL, призначених для продуктів (/openapi/creative-lab/<product>/v1/...) з версіюванням для кожного продукту, щоб продукти могли розвиватися незалежно на власних лініях версій. Прототип: 6 кредитів за виклик. Створення: 30 кредитів за виклик.
Травень 2026
Травень 26
- Додано параметр
multi_view_thumbnailsдо API Мульти-зображення у 3D. Коли встановлено значенняtrue, завдання додатково генерує чотири ескізи з кардинальних кутів (перед, праворуч, ззаду, зліва) і повертає їх у новому полі відповідіthumbnail_urls. Існуюче полеthumbnail_urlне змінено. Додає приблизно 3 секунди до затримки завдання.
22 травня
- Функціональність конвертування та зміни розміру з Remesh API тепер доступна як окремі 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на Текст у 3D, Зображення у 3D та Мульти-зображення у 3D endpoints. Цей параметр більше не впливає на результат.
Травень 7
- Нова API для аналізу придатності до друку: Аналізуйте успішне завдання Meshy або будь-який URL моделі для придатності до FDM 3D-друку. Асинхронне створення + стрімовий паттерн: POST повертає task_id, потім GET / SSE стрім повертає метрики по водонепроникності, об’єму, отворам і немноговидним ребрам після SUCCEEDED. Безкоштовно, кредити не споживаються.
- Нова API для відновлення придатності до друку: Відновіть 3D-модель для придатності до FDM друку — виправте немноговидні ребра, вироджені грані, отвори та інші проблеми topology. Приймає існуючий
input_task_idMeshy абоmodel_url(.glb,.stl,.obj). Формат виводу відповідає вводу. 10 кредитів за завдання.
Квітень 2026
27 квітня
- Додано поле
consumed_creditsдо всіх відповідей на завдання у кожній кінцевій точці API. Показує кількість кредитів, спожитих кожним завданням. Поле присутнє для завдань у статусахPENDING,IN_PROGRESSтаSUCCEEDED. Повертає0для завдань зі статусомFAILED(кредити автоматично повертаються при невдачі). Див. Ціни за вартість кредитів на кожну кінцеву точку.
Apr 24
- Додано параметр
model_urlдо endpoint багатоколірний друк. Надсилайте 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має пріоритет.
Квіт 20
- Додано параметр
hd_textureдо endpoint-ів Зображення у 3D, Мульти-зображення у 3D, Текст у 3D Ретушування та Ретекстурування. Коли увімкнено, текстура базового кольору генерується у роздільній здатності 4K (4096×4096) для вищої деталізації. Підтримується тільки дляmeshy-6таlatest. За замовчуванням встановлено наfalse. - Пакет PBR, що повертається, коли
enable_pbrвстановлено наtrue, тепер включає картуemissionуtexture_urlsдля завданьmeshy-6таlatestпо Зображення у 3D, Мульти-зображення у 3D, Текст у 3D Ретушування та Ретекстурування. Ніяких змін у запиті не потрібно.
14 квітня
- Додано параметр
decimation_modeдо endpoint Зображення у 3D, Мульти-зображення у 3D, Попередній перегляд Текст у 3D та Ремеш. Встановлює рівень адаптивної кількості полігонів при декімації:1(ультра),2(високий),3(середній) або4(низький).
Apr 12
- Перебудована документація API: додано групування параметрів з залежними полями, вбудовані значення за замовчуванням, позначки обов'язковості/застарілості, розширювані піднавігації, а також розділено Multi-Image, Rigging і Анімація на окремі сторінки.
Березень 2026
Apr 2
- Додано підтримку формату
3mfдо параметруtarget_formatsу всіх endpoint (Зображення у 3D, Текст у 3D, Ремеш, Ретекстурування). Примітка: 3MF доступний лише за запитом та повинен бути явно зазначений. - Нова API багатоколірного друку: Конвертуйте 3D моделі в багатоколірний формат 3MF для 3D-друку. Підтримує палети з 1-16 кольорів з налаштовуваною точністю. 10 кредитів за завдання.
20 березня
- Виведено з експлуатації AI модель Meshy-4. Усі запити до API, що використовують
meshy-4, більше не підтримуються. Будь ласка, перейдіть наmeshy-6абоlatest. - Додано параметри
auto_sizeтаorigin_atдо Зображення у 3D, Мульти-зображення у 3D, Текст у 3D, та Ремеш endpoint. Колиauto_sizeувімкнено, сервіс використовує AI vision, щоб оцінити реальну висоту та автоматично змінити розмір моделі.origin_atвстановлює позицію початку координат (bottomабоcenter). У API Ремешauto_sizeє взаємовиключним зresize_height.
Mar 17
- Додано необов'язковий параметр
target_formatsдо Зображення у 3D, Мульти-зображення у 3D, Текст у 3D, та Ретекстурування endpoint. Вкажіть, які 3D формати генерувати (наприклад,["glb", "fbx"]), щоб зменшити час виконання завдання.
Лютий 2026
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 Текст у 3D Попередній перегляд для створення низькополігональних сіток, оптимізованих для чистіших полігонів.
Січень 2026
27 січня
- Додано детальну документацію режимів відмов для всіх кінцевих точок API, включаючи загальні коди помилок HTTP (400, 401, 402, 404, 422, 429) та причини невдач завдань. Це допомагає розробникам краще зрозуміти та обробляти помилки API.
Jan 26
- У Мульти-зображення у 3D API тепер підтримується 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у Текст у 3D (Попередній перегляд) і Зображення у 3D API тепер відноситься до Meshy 6.
12 січня
- Додано новий параметр
model_typeдо API Зображення у 3D для генерації низькополігональних сіток, оптимізованих для чистіших полігонів.
Грудень 2025
31 грудня
- Запущено API Playground, спеціальний простір для розробників, де можна досліджувати параметри API та тестувати запити безпосередньо на вебсайті Meshy.
- Представлено Текст у зображення API та Зображення у зображення API, які забезпечують генерацію зображень за допомогою AI з текстових підказок та редагування зображень на основі референсних зображень. Обидва API підтримують моделі
nano-bananaтаnano-banana-pro, з можливістю опціонального мультивиду.
23 грудня
- Поле
video_urlу відповіді API Текст у 3D зараз застаріле і буде видалене в майбутньому випуску.
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
- Text to 3D Refine API тепер підтримує
ai_model = latest, що відповідає Meshy 6 Preview. - Image to 3D API тепер за замовчуванням використовує Meshy-6-preview для texturing, коли
ai_model = latestіshould_texture = true. - Multi-Image to 3D API тепер підтримує
ai_model = latest, за замовчуванням працюючи з Meshy-6-preview для texturing, тоді як генерування сітки залишається Meshy-5. - Retexture 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до Ремеш API для підтримки конвертації формату лише вхідного файлу моделі. - Додано
rigged_character_glb_urlдо відповіді Об'єкта Задачі Rigging.
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
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 та Ретекстурування endpoint.
Червень 2025
Jun 25
- Додано API для Ретекстурування, що дозволяє користувачам змінювати texture 3D моделей на основі новітніх AI моделей Meshy.
Jun 19
- Додані API для видалення для Текст у 3D, Зображення у 3D, Ремеш, Rigging та Анімація.
- Додано параметр
ai_modelдо API уточнення Текст у 3D.
Jun 17
- Додано документацію для Webhooks.
Jun 10
- Ремеш API тепер підтримує моделі у форматі GLB, закодовані у base64, в параметрі
model_urlчерез Data URI.
Травень 2025
20 травня
- Додано необов'язковий параметр
moderationдо Текст у 3D Preview, Текст у 3D Refine, Зображення у 3D і Мульти-зображення у 3D API. Коли увімкнено, вхідний контент автоматично перевіряється на потенційно шкідливий зміст перед генерацією.
15 травня
- Введено API автоматичного рігінгу та анімації, що дозволяє користувачам автоматично додавати скелети та анімувати 3D моделі. Дізнайтеся більше про рігінг та Анімацію.
Квітень 2025
29 квітня
- Запроваджено API для Мульти-зображення у 3D, що дозволяє створювати 3D-моделі від 1 до 4 вхідних зображень з використанням AI-моделі
meshy-5. - Додано опцію AI-моделі
meshy-5до API Тексту у 3D та Зображення у 3D. Тегlatestтепер також посилається наmeshy-5.
Apr 17
- Додано параметр
texture_image_urlдо API Зображення у 3D і Текст у 3D Refine, що дозволяє користувачам керувати процесом генерації текстур за допомогою зображення.
Березень 2025
Mar 28
- Додано параметр
latestдо API Текст у 3D та Зображення у 3D, що дає змогу отримати доступ до наших майбутніх вдосконалених AI-моделей для покращення якості генерації.
Mar 14
- Text to Texture API тепер підтримує моделі, закодовані в base64, у параметрі
model_urlчерез Data URI, аналогічноimage_urlв Image to 3D API.
Mar 06
- Оновлено ціни для завдань генерації API:
- Текст у 3D (Попередній перегляд): Збільшено з 2 до 5 кредитів за виклик
- Текст у 3D (Ретушування): Збільшено з 5 до 10 кредитів за виклик
- Зображення у 3D: Тепер 5 кредитів без текстури, 15 кредитів з текстурою
- Текст у текстуру: Збільшено з 5 до 10 кредитів за виклик
- Текст у воксель: Залишається на рівні 5 кредитів за виклик
Лютий 2025
Feb 18
- Додано API-ключ тестового режиму
msy_dummy_api_key_for_test_mode_12345678, який дозволяє розробникам тестувати інтеграцію API без витрат кредитів. Усі дійсні запити з використанням цього ключа будуть повертати одні й ті самі зразки результатів завдань.
13 лютого
-
Змінено критично:
- Створення завдань для безкоштовного рівня закінчиться
20 березня 2025. Після цього всі API запити на завдання вимагатимуть платної підписки. Щоб зберегти безперебійний доступ, рекомендуємо оновити підписку до дедлайну. - Використовуйте код купона
APIACCESS, щоб отримати знижку40%. Дякуємо, що залишаєтеся з нами!
- Створення завдань для безкоштовного рівня закінчиться
-
Додано endpoint потокового SSE для оновлень завдань у режимі реального часу:
Feb 6
- Додано параметр
texture_promptдо Зображення у 3D і Текст у 3D Refine API, що дозволяє користувачам керувати процесом генерації текстури за допомогою текстового prompt.
Січень 2025
23 січня
- Додано endpoints для переліку завдань до Текст у 3D, Зображення у 3D, Ремеш та Текст у текстуру API.
14 січня
- Застарілі API Legacy Текст у 3D та Зображення у 3D, що використовуються моделями штучного інтелекту Meshy-3.
Січ 07
- Додано параметр
symmetry_modeдо API Попередній перегляд Текст у 3D та Зображення у 3D, що дозволяє налаштовувати параметри симетрії.
Грудень 2024
Dec 19
- Додано Remesh APIs, які дозволяють користувачам робити ремеш і експортувати існуючі 3D моделі, створені іншими Meshy APIs, в різні формати.
- Оновлено ліміти на кількість полігонів для наших API до діапазону 100-300,000 для Преміум користувачів.
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 Прев'ю при використанні AI моделіmeshy-4. - Застарілий параметр
low-polyу параметріart_styleдля API Текст у 3D Прев'ю.
5 грудня
- Додано Get Balance API для надання користувачам можливості отримувати свій баланс кредитів.
- Додано параметр
should_remeshдо Зображення у 3D та Попередній перегляд Текст у 3D API.
Dec 3
- Зовнішні API тепер використовують префікс
/openapi. Старі шляхи (Legacy) залишаються підтримуваними, але ми рекомендуємо перейти на нові шляхи.
Листопад 2024
Nov 14
- API Зображення у 3D тепер підтримує зображення, закодовані в base64.