Auto Split API

分割対象のモデルを持つ、成功したタスクのID。サポートされているタスクタイプ:画像から3D、マルチ画像から3D、テキストから3D（プレビュー）、リメッシュ、変換、リサイズ。タスクのステータスは SUCCEEDED である必要があり、そのモデルはMeshy 6またはMeshy 7（ai_model が meshy-6、meshy-7、meshy-7.1、または latest）で生成されたものである必要があります。ローポリおよびSmart Topology（meshy-t2）のモデルはサポートされていません。テクスチャ付きモデルは受け付けられますが、そのテクスチャは結果に引き継がれません。

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

利用可能な値:

• auto:Meshyが分割位置を選択します。prompt は無視されます。
• by_parts:prompt で指定した頭部、腕、胴体などの構造的なパーツに沿って分割します。
• by_color:prompt で指定した色の領域に沿って分割します。アップロードされた画像から生成された入力（画像から3D または マルチ画像から3D）が必要です。その他の入力は 400 で拒否されます。色領域の境界は、入力モデルのテクスチャではなく、元の画像から取得されます。マルチ画像から3Dの場合、Auto Splitは最初のソース画像を使用します。

分割済みモデルをエクスポートする形式。シーンオブジェクトをサポートする形式（glb、obj、fbx、usdz、blend、3mf）は、各パーツを個別のオブジェクトとして保持します。stl にはオブジェクトを分ける概念がないため、layout に従って配置されたすべてのパーツを1つのソリッドに統合します（スライサーで個別に選択可能なパーツが必要な場合は 3mf をリクエストしてください）。glb は常に生成され、model_urls に返されます。それ以外の形式が必要な場合は、追加でリストに指定してください。

利用可能な値:glb、obj、fbx、stl、usdz、blend、3mf。

各出力形式、およびサムネイルにおけるパーツの配置方法。

利用可能な値:

• assembled:パーツは元のモデルにあった位置のままです。
• on_plate:パーツは平らに並べられ、ビルドプレート上に広げられ、すぐにスライスできる状態になります。これはウェブアプリのOn Plate表示と同じ配置です。

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

各切断面にほぞ継ぎ（mortise-and-tenon）コネクタを追加し、印刷したパーツ同士がぴったり組み合うようにします。

リクエストが受理できませんでした。よくある原因:

• promptの欠落:mode が by_parts または by_color の場合、prompt は必須です。
• promptが分割を指定していない、またはパーツ数が多すぎる:by_parts / by_color は1〜10個の名前付きパーツを受け付けます。モデルを1つのまま保つよう求める記述、または10個を超えるパーツを指定する記述は拒否されます。料金は発生しません。
• サポートされていない入力タスク:input_task_id は、サポートされているタイプの、Meshy 6またはMeshy 7で生成された、成功したタスクを参照している必要があります。
• 参照画像がない:by_color にはアップロードされた画像から生成された入力が必要です。
• コネクタの値が範囲外:connector_size または connector_height が 0.1 〜 0.8 の範囲外です。

認証に失敗しました。APIキーを確認してください。

このタスクを実行するためのクレジットが不足しています。

input_task_id が存在しないか、あなたのアカウントに属していません。

レート制限を超えました。by_parts および by_color のリクエストは、アカウントごとに1分あたり12リクエストというprompt解析の制限も共有しています。

prompt指定による分割（by_parts および by_color）は一時的に利用できません。しばらく待ってから再試行するか、影響を受けない mode: "auto" を使用してください。料金は発生しません。

取得するAuto SplitタスクのID。

削除するAuto SplitタスクのID。

ページネーション用のページ番号です。1 から始まり、デフォルトは 1 です。

ページサイズの上限です。デフォルトは 10 件です。最大 100 件まで許可されており、それを超える値は 100 に制限されます。

並べ替えに使用するフィールドです。利用可能な値：

• +created_at: 作成時刻の昇順で並べ替えます。
• -created_at: 作成時刻の降順で並べ替えます。

ストリーミングする Auto Split タスクの一意の識別子。

タスクの一意な識別子です。実装の詳細としてはタスクIDにk-sortableなUUIDを使用していますが、この形式についてはいかなる前提も置かないでください。

タスクの種類です。値は print-split です。

分割済みモデルのダウンロード可能なURLで、リクエストしたフォーマットごとに1つずつ存在します。シーンオブジェクトをサポートするフォーマットでは各パーツが個別のオブジェクトとして保持されますが、stl はそれらを1つのソリッドに統合します。リクエストされなかったフォーマットのプロパティは省略されます。

分割済みモデルのレンダリングプレビューのダウンロード可能なURLです。各パーツが異なる色で表示され、指定した layout に従って配置されます。

by_parts または by_color リクエストの prompt でパーツ名が指定されなかったために、Meshyが代わりに自動でモデルを分割した場合に true になります。この場合、結果に含まれるパーツ名はあなたが指定したものではなく、Meshyが付けたものです。PENDING 以降常に存在します。auto タスクの場合、およびプロンプトの指示に従って分割できた場合は省略されます。

分割によって生成された印刷可能なパーツの数です。シーンオブジェクトをサポートするフォーマットではパーツごとに1つのオブジェクトが含まれますが、stl はそれらを1つのソリッドに統合しても、この数値はパーツ数を報告します。セグメンテーションで印刷可能な形状にできず潰れてしまった断片は、エクスポート前にファイルから除去され、カウントされません。

タスクの進行状況です。タスクがまだ開始されていない場合、このプロパティは 0 です。タスクが成功すると、100 になります。

タスクのステータスです。取り得る値は PENDING、IN_PROGRESS、SUCCEEDED、FAILED、CANCELED のいずれかです。

先行するタスクの数です。

タスクが作成された時刻のタイムスタンプ（ミリ秒）です。

タスクが開始された時刻のタイムスタンプ（ミリ秒）です。タスクがまだ開始されていない場合、このプロパティは 0 です。

タスクが完了した時刻のタイムスタンプ（ミリ秒）です。タスクがまだ完了していない場合、このプロパティは 0 です。

失敗したタスクのエラー詳細です。task_error オブジェクトの完全なリファレンスは エラー を参照してください。

このタスクによって消費されたクレジット数です。常に存在し、タスクが受理された時点で 10、FAILED タスクの場合は失敗時に課金分が返金されるため 0 になります。タスクが PENDING のまま削除された場合も返金されます。