Устаревшие функции
Узнайте, какие модели 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 г. | Будет объявлено позже |
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.
До 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.
История устаревания
Ниже перечислены все случаи устаревания, начиная с самых последних объявлений.
| Объявлено | Устаревшая модель или функция | Дата снятия с поддержки | Рекомендуемая замена |
|---|---|---|---|
| 2026-10-02 | model_type: "lowpoly" и meshy-t1 в Текст в 3D и Изображение в 3D | 30 ноября 2026 г. | model_type: "smart-topology" с ai_model: "meshy-t2.5" |
| 2026-09-29 | /v2/text-to-3d без префикса /openapi | Будет объявлено позже | /openapi/v2/text-to-3d |
| 2026-09-18 | meshy-7 | Будет объявлено позже | meshy-7.1 |
| 2026-09-16 | Общий API-ключ тестового режима | 16 сентября 2026 г. | Ваш собственный ключ со страницы API-ключи или Playground |
| 2026-09-11 | meshy-5 | 10 октября 2026 г. | meshy-6-lite |
| 2026-03-20 | meshy-4 | 20 марта 2026 г. | meshy-6 |
| 2025-10-01 | API Текст в воксели | 1 октября 2025 г. | Нет |
| 2025-07-01 | API Текст в текстуру | 1 июля 2025 г. | Ретекстурирование |
| 2025-01-14 | meshy-3 | Июль 2025 г. | meshy-6 |
Устаревание параметров API
Meshy время от времени помечает как устаревшие параметры запросов и поля ответов, которые заменяются более новыми моделями или больше не используются. Они по-прежнему работают, если не указано иное, но в будущем релизе могут быть удалены.
| Параметр | Статус | Поведение | Рекомендуемая замена |
|---|---|---|---|
texture_image_url в Rigging | Устарел 23 октября 2026 г. | По-прежнему работает. Изображение становится единственной текстурой моделью после rigging, и модель теряет свои 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 для Remesh | Устарели 22 мая 2026 г. | По-прежнему работают. | Convert и Resize |
symmetry_mode | Устарел 11 мая 2026 г. | Принимается, но игнорируется. | Опустите его. |
art_style в предпросмотре Текст в 3D | Устарел 22 января 2026 г. | Принимается, но игнорируется. Применялся только к Meshy 4 и Meshy 5. | Опустите его. |
is_a_t_pose | Устарел 4 декабря 2025 г. | По-прежнему работает. | pose_mode |