非推奨化
どのMeshy AIモデルとAPI機能がアクティブ、非推奨、または廃止済みであるかを確認し、廃止日と推奨される代替手段を調べられます。
Meshyは新しいモデルをリリースするたびに、古いモデルを廃止します。古いモデルやAPI機能に依存しているインテグレーションは、動作を維持するために随時更新が必要になる場合があります。このページには、すべてのAPIの非推奨化情報と、それぞれの推奨される代替手段が記載されています。
概要
Meshyは、モデルやAPI機能のライフサイクルを説明するために以下の用語を使用します。
- アクティブ: 完全にサポートされており、使用が推奨されます。
- Legacy: 更新は行われなくなっており、将来的に非推奨化される可能性があります。現時点では引き続き動作し、リクエストや請求内容に変更はありません。
- 非推奨: 引き続き動作しますが、使用は推奨されません。Meshyは推奨される代替手段を提示し、スケジュールが決まり次第、廃止日を案内します。
- 廃止済み: 利用できなくなっています。廃止済みのモデルや機能を使用するリクエストはエラーを返します。
モデルの廃止は、そのモデルを使用してすでに作成したものを削除しません。廃止されたモデルで作成したタスクは、通常の保持期間の間、引き続き利用可能です。
代替機能への移行
モデルが非推奨になった場合は、廃止日より前にすべてのリクエストをその代替モデルに移行してください。廃止日以降にそのモデルを使用するリクエストは失敗します。
代替モデルは、置き換え元のモデルとは異なる結果を生成する場合があります。廃止日より十分前に、例えばPlaygroundでインテグレーションを代替モデルでテストしてください。
通知
Meshyは、すべての非推奨化と廃止について変更履歴およびこのページで告知します。廃止が予定されている間は、すべてのAPIページ上部のバナーにその旨が表示され、該当するエンドポイントページでは当該モデルまたはパラメータが非推奨であることが明記されます。
Meshyは、廃止日の少なくとも1か月前には廃止日を告知します。
ベストプラクティス
- 非推奨化に関する最新情報については、定期的に変更履歴とこのページを確認してください。
- インテグレーションで一貫した出力が必要な場合は、
ai_modelをmeshy-7.1のような特定のモデルに設定してください。latestは常に最新の標準モデルを指すため、新しいモデルがリリースされると出力が変化します。 - 現在使用しているモデルの廃止日より十分前に、代替モデルでインテグレーションをテストしてください。
- できるだけ早く、推奨される代替手段を使用するようコードを更新してください。
- 移行に関してサポートが必要な場合は、support@meshy.aiまでご連絡ください。
モデルのステータス
テキストから3D、画像から3D、マルチ画像から3D、リテクスチャの現行および廃止済みの3D生成モデルです。すべてのエンドポイントがすべてのモデルを提供しているわけではなく、各エンドポイントページにそのエンドポイントが受け付けるモデルが記載されています。
| APIモデル名 | 現在の状態 | 非推奨化日 | 廃止日 |
|---|---|---|---|
meshy-7.1 | アクティブ | 該当なし | 該当なし |
meshy-7 | 非推奨 | 2026年9月18日 | 2026年12月31日(ジオメトリ);該当なし(テクスチャ) |
meshy-6 | アクティブ | 該当なし | 該当なし |
meshy-6-lite | アクティブ | 該当なし | 該当なし |
meshy-n1 | アクティブ | 該当なし | 該当なし |
meshy-5 | 廃止済み | 2026年9月11日 | 2026年10月10日 |
meshy-4 | 廃止済み | 該当なし | 2026年3月20日 |
meshy-3 | 廃止済み | 2025年1月14日 | 2025年7月 |
meshy-t2.5 | アクティブ | 該当なし | 該当なし |
meshy-t2 | アクティブ | 該当なし | 該当なし |
meshy-t1 | 非推奨 | 2026年7月13日 | 2026年11月30日 |
model_type: "lowpoly" | 非推奨 | 2026年7月13日 | 2026年11月30日 |
latestはmeshy-7.1に解決されます。
meshy-7の廃止は、テキストから3Dのpreviewタスク、画像から3D、マルチ画像から3Dにおけるai_modelとしての使用が対象です。meshy-7.1は同じパラメータを受け付け、コストも同じです。2026年12月31日以降、これらのリクエストは400を返します。
テクスチャモデルとしてのmeshy-7は影響を受けません。これはリテクスチャ、texture_model、およびText to 3Dのrefineにおけるai_model(テクスチャモデルのみを選択するもの)が対象です。
2026年11月30日までは、以下のリクエストは引き続き三角形topologyのSmart Topologyモデル上で実行され、Smart Topologyの価格が適用されます。
model_type: "smart-topology"かつai_model: "meshy-t1"の画像から3D、またはmodel_type: "lowpoly"かつai_modelを省略するかlatestもしくはmeshy-6を指定した場合。これらに対しては、Meshyはtarget_polycount、topology、image_enhancement、remove_lighting、experimentalを無視します。model_type: "lowpoly"かつai_modelを省略するか、latest、meshy-6、またはmeshy-4を指定したテキストから3Dのpreview(それ以外の場合meshy-4は廃止済みですが、このフォールバックに限り受け付けられます)。これに対しては、Meshyはtarget_polycount、topology、experimentalを無視します。
meshy-t1またはlowpolyに対するその他すべてのリクエストは、すでに400を返します。2026年11月30日以降は、これらのリクエストも400を返すようになります。
非推奨化の履歴
すべての非推奨化は以下に一覧され、最新の告知が先頭に表示されます。
| 告知日 | 非推奨化されたモデルまたは機能 | 廃止日 | 推奨される代替手段 |
|---|---|---|---|
| 2026-10-02 | テキストから3Dおよび画像から3Dにおけるmodel_type: "lowpoly"およびmeshy-t1 | 2026年11月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 | テキストから3Dのpreview、画像から3D、マルチ画像から3Dにおけるai_modelとしてのmeshy-7 | 2026年12月31日 | 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 | Text to Voxel 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日に非推奨化 | 受け付けられますが、無視されます。 | 省略してください。 |
Text to 3D Previewにおけるart_style | 2026年1月22日に非推奨化 | 受け付けられますが、無視されます。これはMeshy 4およびMeshy 5にのみ適用されていました。 | 省略してください。 |
is_a_t_pose | 2025年12月4日に非推奨化 | 引き続き動作します。 | pose_mode |