Auto Split API

分割対象のモデルを持つタスクのIDです。そのタスクのステータスは SUCCEEDED である必要があります。以下のタスクタイプが使用できます。

• 画像から3D
• マルチ画像から3D
• テキストから3D（preview または refine タスク）
• リテクスチャ
• リメッシュ
• 変換
• リサイズ

モデルは Meshy 6 または Meshy 7 で生成されたもの、つまり ai_model が meshy-6-lite、meshy-6、meshy-7、meshy-7.1、または latest に設定されたものである必要があります。Smart Topology モデル（meshy-t2 および meshy-t2.5）はサポートされていません。refine、リテクスチャ、リメッシュ、変換、またはリサイズタスクの場合、このルールはそのタスクの元になったモデルに適用されます。アップロードされたモデルから作成されたリテクスチャ、リメッシュ、変換、またはリサイズタスクは 400 を返します。

モデルの面数は最大800万面です。これを超える面数のモデルは 400 を返します。その場合は、先にそのモデルに対してリメッシュタスクを実行し、代わりにそのリメッシュタスクのIDを送信してください。

テクスチャ付きモデルを分割することもできます。テクスチャを各パーツに保持するには、keep_texture: true を送信してください。

モデルをパーツに分割する方法です。

指定可能な値:

• auto: Meshy が切断箇所を自動的に決定し、prompt は無視します。prompt が600文字を超える場合でも 400 が返されます。
• by_parts: prompt で指定した構造的なパーツ（例: 頭部、腕、胴体）に沿って Meshy が分割します。
• by_color: prompt で指定した色領域に沿って Meshy が分割します。Meshy は入力モデルのテクスチャではなく、ソース画像内でその領域を探します。入力は、アップロードされた画像から画像から3Dまたはマルチ画像から3Dで生成されたものである必要があります。それ以外の入力は 400 を返します。マルチ画像から3Dの場合、Meshy は最初のソース画像を使用します。

生成するファイル形式です。Meshy は常に glb を生成して model_urls で返し、それに加えてここで指定した他の形式も生成します。

指定可能な値:

• glb
• obj
• fbx
• stl
• usdz
• blend
• 3mf

stl を除くすべての形式はシーンオブジェクトをサポートし、各パーツを別々のオブジェクトとして保持します。STLファイルは別々のオブジェクトを保持できないため、Meshy は layout に従って配置した1つのソリッドにパーツを融合します。スライサーで個別に選択できるパーツを得るには、3mf をリクエストしてください。

keep_texture: true の場合、以下の形式はテクスチャを保持します。

• glb、fbx、usdz、blend: テクスチャはファイル内に含まれます。
• obj: テクスチャはマテリアルファイル内に含まれ、model_urls は mtl の下でそれを返します。
• stl と 3mf: ファイルにはジオメトリのみが保持され、テクスチャは含まれません。

すべてのファイル形式およびサムネイルにおいて、Meshy がパーツをどのように配置するかです。

指定可能な値:

• assembled: Meshy はパーツをソースモデル内にあった位置のまま保持します。
• on_plate: Meshy はパーツを平らに置き、スライスできるようにビルドプレート上に広げて配置します。これはウェブアプリの On Plate ビューと同じ配置です。

どちらの layout でも、Meshy は出力前に、切断によって生じた潰れた薄片や点状の断片を除去するため、得られるすべてのパーツは印刷可能です。シーンオブジェクトをサポートする形式はパーツごとに1つのオブジェクトを保持し、stl はパーツを1つのソリッドに融合します。

入力モデルのテクスチャを各パーツに保持するかどうかです。true にすると、すべてのパーツに入力のテクスチャが付与され、タスクは texture_urls でマップを返します。false にすると、各パーツは単色の頂点カラーになります。

true にすると、タスクにかかる時間は約2倍になりますが、クレジットのコストは変わりません。テクスチャのない入力は、false の場合と同じように分割されます。Meshy がテクスチャを保持できない場合、タスクはエラーコード textured_split_refused で失敗します。エラーを参照してください。

各カット箇所にほぞ継ぎ（mortise-and-tenon）コネクタを追加し、印刷したパーツ同士がはまり合うようにするかどうかです。

リクエストを実行できません。エラーメッセージには、どの問題が見つかったかが示されます。例:

• prompt の欠落: mode が by_parts または by_color で、prompt が指定されていません。
• 分割なしを指定した、またはパーツが多すぎる prompt: prompt がモデルを1つのまま保つよう求めているか、11個以上のパーツを指定しています。by_parts と by_color は1〜10個の名前付きパーツを受け付けます。Meshy はこのリクエストの料金を請求しません。
• サポートされていない入力タスク: input_task_id が、サポートされているタイプの成功したタスクではない、または Meshy 6 もしくは Meshy 7 で生成されていません。
• 参照画像なし: mode が by_color で、入力がアップロードされた画像から生成されたものではありません。
• 範囲外のコネクタ: connector_size または connector_height が 0.1 から 0.8 の範囲外です。

リクエストを修正してから、再度送信してください。エラーを参照してください。

APIキーが欠落しているか、無効です。Authorization ヘッダーを確認してください。

例:

• クレジット不足: アカウントにこのタスクを実行するのに十分なクレジットがないか、アカウントがクレジットの上限に達しています。クレジット残高を確認してから、再試行してください。
• 無料プラン: タスクの作成には有料プランが必要です。サブスクリプション設定でプランをアップグレードしてから、再試行してください。

以下のいずれかに該当します。

• コンテンツの moderation によって prompt がブロックされました。メッセージは explicit content または prohibited content です。prompt を変更してから、再試行してください。
• input_task_id が bas-relief（浮き彫り）モデルであり、このエンドポイントでは分割できません。メッセージは This model type does not support this operation です。別のモデルを送信してください。

input_task_id が存在しないか、あなたのアカウントに属していません。IDを確認し、そのタスクを作成したアカウントのAPIキーを使用してください。

レート制限を超えました。しばらく待ってから、再試行してください。レート制限を参照してください。

by_parts および by_color のリクエストは、アカウントごとに1分あたり12リクエストという prompt 読み取りの制限も共有します。

prompt による分割（by_parts および by_color）は一時的に利用できません。後で再試行するか、依然として動作する mode: "auto" を送信してください。Meshy はこのリクエストの料金を請求しません。

作成時のレスポンスに含まれるタスクID。

削除するタスクのID。

返すページ番号。1 から始まり、デフォルトは 1 です。

1ページあたりのタスク数。最大 100。デフォルトは 10 です。Meshy はこれより大きい値を 100 として扱います。

ソート順。

利用可能な値：

• +created_at：古い順
• -created_at：新しい順

作成レスポンスから得られるタスク ID です。

タスクID。不透明な文字列として扱い、そのフォーマットに依存しないでください。

タスクの種類で、常に print-split です。

分割後のモデルのダウンロードURLで、リクエストしたフォーマットごとに1つずつ格納されます。リクエストしなかったフォーマットにはキーがありません。シーンオブジェクトをサポートするフォーマットでは各パートが個別のオブジェクトとして保持されますが、stl はパートを1つのソリッドに統合します。

リクエストした layout での、分割後のモデルのプレビュー画像のダウンロードURL。パートがテクスチャを保持している場合、プレビューにはそのテクスチャが表示されます。それ以外の場合、各パートにはそれぞれの色が割り当てられます。

分割後のモデルのテクスチャマップで、1つのオブジェクトを含む配列として提供されます。すべてのパートがこれらのマップを共有します。keep_texture が true で、入力モデルにテクスチャがある場合にのみ存在します。

背景が透過（RGBA）になっている thumbnail_url のバージョンのダウンロードURL。タスクが成功し、Meshy が透過プレビューをレンダリングした場合にのみ存在します。

Meshy が prompt を無視したかどうか。by_parts または by_color リクエストの prompt でパートが1つも指定されていなかったために、Meshy が自動的にモデルを分割した場合に true になります。この場合、結果に含まれるパート名はユーザーのものではなく Meshy によるものです。PENDING 以降は存在します。Meshy は auto タスクの場合、および prompt に従った場合はこのフィールドを省略します。

分割によって生成された、印刷可能なパートの数です。シーンオブジェクトをサポートするフォーマットでは、パートごとに1つのオブジェクトを保持します。stl はパートを1つのソリッドに統合しますが、part_count はそれでもパート数をカウントします。エクスポート前に、Meshy は印刷可能なパートになり得ない、潰れた断片を取り除き、それらはカウントしません。

タスクがどれだけ完了しているかをパーセンテージで示します。タスクが開始するまでは 0 で、成功すると 100 になります。

タスクのステータスで、PENDING、IN_PROGRESS、SUCCEEDED、FAILED、CANCELED のいずれかです。

キュー内でこのタスクより前にあるタスクの数です。この値はタスクが PENDING の間のみ意味を持ちます。

タスクが作成された時刻（Unixミリ秒）。

タスクが開始された時刻（Unixミリ秒）。タスクが開始するまでは 0 です。

タスクが終了した時刻（Unixミリ秒）。タスクが終了するまでは 0 です。

タスクの結果が失効する時刻（Unixミリ秒）。タスクが終了するまでは 0 です。

タスクが失敗した場合のエラー詳細です。エラーを参照してください。

安全性チェックによって入力モデルが拒否された場合、タスクは失敗し、task_error.type に invalid_input が、task_error.code に provider_content_refused が設定されます。別のモデルを送信してください。エラーを参照してください。

keep_texture: true の場合に、Meshy がテクスチャを保持できないと、タスクは失敗し、task_error.code に textured_split_refused が設定されます。エラーを参照してください。

タスクが消費したクレジットの数です。常に存在します。Meshy がタスクを受理した後は 10 で、FAILED タスクの場合は 0 です。これは、タスクが失敗した場合に Meshy がクレジットを返還するためです。PENDING タスクを削除した場合も同様に返還されます。