Устаревания
Узнайте, какие модели Meshy AI и функции API активны, устарели или сняты с поддержки, а также найдите даты снятия с поддержки и рекомендуемые замены.
По мере выпуска Meshy новых моделей старые снимаются с поддержки. Интеграциям, которые зависят от более старой модели или функции API, может время от времени требоваться обновление, чтобы продолжать работать. На этой странице перечислены все устаревания API вместе с рекомендуемой заменой для каждого.
Обзор
Meshy использует следующие термины для описания жизненного цикла модели или функции API:
- Активно: полностью поддерживается и рекомендуется к использованию.
- Legacy: больше не получает обновлений и в будущем может быть помечено как устаревшее. Пока продолжает работать, и ничего в вашем запросе или счёте не меняется.
- Устарело: всё ещё работает, но больше не рекомендуется. Meshy указывает рекомендуемую замену и, как только она назначена, дату снятия с поддержки.
- Снято с поддержки: больше не доступно. Запросы, использующие снятую с поддержки модель или функцию, возвращают ошибку.
Снятие модели с поддержки не удаляет то, что вы уже создали с её помощью. Задачи, созданные с использованием снятой с поддержки модели, остаются доступными в течение обычного периода хранения.
Переход на замены
Как только модель помечается как устаревшая, перенесите все свои запросы на её замену до даты снятия с поддержки. Запросы, использующие модель после этой даты, завершатся ошибкой.
Замена может давать результаты, отличающиеся от результатов заменяемой модели. Протестируйте свою интеграцию с заменой заранее, до даты снятия с поддержки, например в Playground.
Уведомления
Meshy анонсирует каждое устаревание и снятие с поддержки в журнале изменений и на этой странице. Пока снятие с поддержки предстоит, баннер в верхней части каждой страницы API показывает это, а страницы эндпоинтов помечают модель или параметр как устаревшие.
Meshy объявляет дату снятия с поддержки как минимум за месяц до самого события.
Рекомендации
- Регулярно проверяйте журнал изменений и эту страницу на предмет обновлений об устареваниях.
- Устанавливайте
ai_modelв конкретную модель, напримерmeshy-7.1, если вашей интеграции нужен стабильный результат.latestвсегда указывает на самую новую стандартную модель, поэтому её результат меняется при выпуске новой модели. - Протестируйте свою интеграцию с заменой заранее, до даты снятия с поддержки вашей текущей модели.
- Обновите свой код для использования рекомендуемой замены как можно скорее.
- Обратитесь в support@meshy.ai, если вам нужна помощь с миграцией.
Статус моделей
Текущие и снятые с поддержки модели 3D-генерации для Текст в 3D, Изображение в 3D, Мульти-изображение в 3D и Ретекстурирование. Не каждый эндпоинт предлагает все модели; на странице каждого эндпоинта перечислены принимаемые им модели.
| Название модели в API | Текущий статус | Устарела | Дата снятия с поддержки |
|---|---|---|---|
meshy-7.1 | Активна | Н/Д | Н/Д |
meshy-7 | Устарела | 18 сентября 2026 г. | 31 декабря 2026 г. (геометрия); Н/Д (текстура) |
meshy-6 | Активна | Н/Д | Н/Д |
meshy-6-lite | Активна | Н/Д | Н/Д |
meshy-n1 | Активна | Н/Д | Н/Д |
meshy-5 | Снята с поддержки | 11 сентября 2026 г. | 10 октября 2026 г. |
meshy-4 | Снята с поддержки | Н/Д | 20 марта 2026 г. |
meshy-3 | Снята с поддержки | 14 января 2025 г. | июль 2025 г. |
meshy-t2.5 | Активна | Н/Д | Н/Д |
meshy-t2 | Активна | Н/Д | Н/Д |
meshy-t1 | Устарела | 13 июля 2026 г. | 30 ноября 2026 г. |
model_type: "lowpoly" | Устарела | 13 июля 2026 г. | 30 ноября 2026 г. |
latest указывает на meshy-7.1.
Снятие с поддержки meshy-7 распространяется на неё как на ai_model задач предпросмотра Текст в 3D, а также Изображение в 3D и Мульти-изображение в 3D. meshy-7.1 принимает те же параметры и стоит столько же. С 31 декабря 2026 г. такие запросы будут возвращать 400.
meshy-7 как модель текстурирования этим не затронута. Это касается Ретекстурирования, texture_model, а также ai_model на этапе refine для Текст в 3D, где выбирается только модель текстурирования.
До 30 ноября 2026 г. следующие запросы по-прежнему выполняются на модели Smart Topology с треугольной topology и стоят по цене Smart Topology:
- Изображение в 3D с
model_type: "smart-topology"иai_model: "meshy-t1", либо сmodel_type: "lowpoly"и опущеннымai_model,latestилиmeshy-6. Meshy игнорирует в этих случаяхtarget_polycount,topology,image_enhancement,remove_lightingиexperimental. - Предпросмотр Текст в 3D с
model_type: "lowpoly"и опущеннымai_model,latest,meshy-6илиmeshy-4(в остальных случаях снята с поддержки,meshy-4принимается здесь только для этого резервного варианта). Meshy игнорирует в этом случаеtarget_polycount,topologyиexperimental.
Любой другой запрос с meshy-t1 или lowpoly уже возвращает 400. С 30 ноября 2026 г. эти запросы тоже будут возвращать 400.
История устареваний
Ниже перечислены все устаревания, начиная с самых последних анонсов.
| Дата анонса | Устаревшая модель или функция | Дата снятия с поддержки | Рекомендуемая замена |
|---|---|---|---|
| 02.10.2026 | model_type: "lowpoly" и meshy-t1 в Текст в 3D и Изображение в 3D | 30 ноября 2026 г. | model_type: "smart-topology" с ai_model: "meshy-t2.5" |
| 29.09.2026 | /v2/text-to-3d без префикса /openapi | Будет объявлено позже | /openapi/v2/text-to-3d |
| 18.09.2026 | meshy-7 как ai_model для предпросмотра Текст в 3D, Изображение в 3D и Мульти-изображение в 3D | 31 декабря 2026 г. | meshy-7.1 |
| 16.09.2026 | Общий API-ключ тестового режима | 16 сентября 2026 г. | Ваш собственный ключ со страницы API Keys или Playground |
| 11.09.2026 | meshy-5 | 10 октября 2026 г. | meshy-6-lite |
| 20.03.2026 | meshy-4 | 20 марта 2026 г. | meshy-6 |
| 01.10.2025 | API Текст в Voxel | 1 октября 2025 г. | Нет |
| 01.07.2025 | API Текст в текстуру | 1 июля 2025 г. | Ретекстурирование |
| 14.01.2025 | meshy-3 | июль 2025 г. | meshy-6 |
Устаревания параметров API
Иногда Meshy помечает как устаревшие параметры запросов и поля ответов, которые заменяются или больше не используются более новыми моделями. Они продолжают работать, если не указано иное, но в будущем релизе могут быть удалены.
| Параметр | Статус | Поведение | Рекомендуемая замена |
|---|---|---|---|
texture_image_url в Rigging | Устарел 23 октября 2026 г. | Всё ещё работает. Изображение становится единственной текстурой риггированной модели, и модель теряет свои PBR-карты. | Опустите его. Meshy использует текстуры из model_url или из исходной задачи. |
ultra_mode | Устарел 18 сентября 2026 г. | ultra_mode: true эквивалентен geometry_resolution: "2k". | geometry_resolution |
hd_texture | Устарел 21 июля 2026 г. | hd_texture: true эквивалентен texture_resolution: "4k". Если отправлены оба, Meshy использует texture_resolution. | texture_resolution |
| Параметры Convert и resize в Ремешинге | Устарели 22 мая 2026 г. | Всё ещё работают. | Convert и Изменить размер |
symmetry_mode | Устарел 11 мая 2026 г. | Принимается, но игнорируется. | Опустите его. |
art_style в Text to 3D Preview | Устарел 22 января 2026 г. | Принимается, но игнорируется. Применялся только к Meshy 4 и Meshy 5. | Опустите его. |
is_a_t_pose | Устарел 4 декабря 2025 г. | Всё ещё работает. | pose_mode |