非推奨
Meshy AIのモデルとAPI機能のうち、どれが有効、非推奨、または廃止されているかを確認し、廃止日と推奨される代替機能を調べられます。
Meshyは新しいモデルをリリースするたびに、古いモデルを廃止します。古いモデルやAPI機能に依存しているインテグレーションは、動作を維持するために随時更新が必要になる場合があります。このページには、すべてのAPIの非推奨情報と、それぞれの推奨される代替機能が記載されています。
概要
Meshyでは、モデルやAPI機能のライフサイクルを表すために、以下の用語を使用しています。
- Active(有効): 完全にサポートされており、使用が推奨されています。
- Legacy(非推奨予定): 更新は行われなくなり、将来的に非推奨になる可能性があります。現時点では引き続き動作し、リクエストや請求内容に変更はありません。
- 非推奨: 引き続き動作しますが、使用は推奨されません。Meshyは推奨される代替機能を提示し、廃止日が決まり次第それも案内します。
- 廃止済み: 使用できなくなります。廃止済みのモデルや機能を使用するリクエストはエラーを返します。
モデルを廃止しても、それを使って既に作成したものが削除されるわけではありません。廃止されたモデルで作成したタスクは、通常の保持期間の間は引き続き利用できます。
代替機能への移行
モデルが非推奨になったら、廃止日までにすべてのリクエストを代替機能に移行してください。廃止日以降にそのモデルを使用するリクエストは失敗します。
代替機能は、置き換え対象のモデルとは異なる結果を生成する場合があります。廃止日より十分前に、例えばPlaygroundなどで、代替機能を使ったインテグレーションのテストを行ってください。
通知
Meshyは、すべての非推奨および廃止について変更履歴およびこのページで案内します。廃止が予定されている間は、すべてのAPIページ上部のバナーにその旨が表示され、各エンドポイントのページでも対象のモデルやパラメータが非推奨としてマークされます。
Meshyは廃止日の少なくとも1か月前に、その日付を案内します。
ベストプラクティス
- 非推奨に関する最新情報を確認するため、定期的に変更履歴とこのページをチェックしてください。
- インテグレーションで一貫した出力が必要な場合は、
ai_modelにmeshy-7.1のような特定のモデルを設定してください。latestは常に最新の標準モデルを指すため、新しいモデルがリリースされると出力が変化します。 - 現在使用しているモデルの廃止日より十分前に、代替機能を使ったインテグレーションのテストを行ってください。
- できるだけ早く、推奨される代替機能を使用するようコードを更新してください。
- 移行に関してサポートが必要な場合は、support@meshy.aiまでご連絡ください。
モデルのステータス
テキストから3D、画像から3D、マルチ画像から3D、リテクスチャにおける、現行および廃止済みの3D生成モデル一覧です。すべてのエンドポイントがすべてのモデルを提供しているわけではなく、各エンドポイントのページで対応するモデルを確認できます。
| APIモデル名 | 現在のステータス | 非推奨 | 廃止日 |
|---|---|---|---|
meshy-7.1 | Active | N/A | N/A |
meshy-7 | Deprecated | 2026年9月18日 | 追って案内 |
meshy-6 | Active | N/A | N/A |
meshy-6-lite | Active | N/A | N/A |
meshy-5 | Retired | 2026年9月11日 | 2026年10月10日 |
meshy-4 | Retired | N/A | 2026年3月20日 |
meshy-3 | Retired | 2025年1月14日 | 2025年7月 |
meshy-t2.5 | Active | N/A | N/A |
meshy-t2 | Active | N/A | N/A |
meshy-t1 | Deprecated | 2026年7月13日 | 2026年10月30日 |
model_type: "lowpoly" | Deprecated | 2026年7月13日 | 2026年10月30日 |
latestはmeshy-7.1を参照します。
非推奨の履歴
すべての非推奨情報を、発表日が新しい順に以下に記載します。
| 発表日 | 非推奨になったモデル・機能 | 廃止日 | 推奨される代替機能 |
|---|---|---|---|
| 2026-10-02 | テキストから3Dおよび画像から3Dにおけるmodel_type: "lowpoly"およびmeshy-t1 | 2026年10月30日 | ai_model: "meshy-t2.5"を使ったmodel_type: "smart-topology" |
| 2026-09-29 | /openapiプレフィックスなしの/v2/text-to-3d | 追って案内 | /openapi/v2/text-to-3d |
| 2026-09-18 | meshy-7 | 追って案内 | meshy-7.1 |
| 2026-09-16 | 共有テストモードAPIキー | 2026年9月16日 | APIキーページから取得した独自のキー、またはPlayground |
| 2026-09-11 | meshy-5 | 2026年10月10日 | meshy-6-lite |
| 2026-03-20 | meshy-4 | 2026年3月20日 | meshy-6 |
| 2025-10-01 | テキストからボクセルAPI | 2025年10月1日 | なし |
| 2025-07-01 | テキストからテクスチャAPI | 2025年7月1日 | リテクスチャ |
| 2025-01-14 | meshy-3 | 2025年7月 | meshy-6 |
APIパラメータの非推奨
Meshyは、新しいモデルによって置き換えられたり使用されなくなったりしたリクエストパラメータやレスポンスフィールドを、随時非推奨にすることがあります。特に記載がない限り引き続き動作しますが、将来のリリースで削除される可能性があります。
| パラメータ | ステータス | 動作 | 推奨される代替機能 |
|---|---|---|---|
Riggingのtexture_image_url | 2026年10月23日に非推奨化 | 引き続き動作します。この画像がリグ済みモデルの唯一のテクスチャとなり、モデルはPBRマップを失います。 | 省略してください。Meshyはmodel_urlまたは入力タスクのテクスチャを使用します。 |
ultra_mode | 2026年9月18日に非推奨化 | ultra_mode: trueはgeometry_resolution: "2k"と同等です。 | geometry_resolution |
hd_texture | 2026年7月21日に非推奨化 | hd_texture: trueはtexture_resolution: "4k"と同等です。両方を送信した場合、Meshyはtexture_resolutionを使用します。 | texture_resolution |
| リメッシュの変換・リサイズパラメータ | 2026年5月22日に非推奨化 | 引き続き動作します。 | 変換およびリサイズ |
symmetry_mode | 2026年5月11日に非推奨化 | 受け付けられますが無視されます。 | 省略してください。 |
テキストから3Dプレビューにおけるart_style | 2026年1月22日に非推奨化 | 受け付けられますが無視されます。これはMeshy 4およびMeshy 5にのみ適用されていました。 | 省略してください。 |
is_a_t_pose | 2025年12月4日に非推奨化 | 引き続き動作します。 | pose_mode |