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、meshy-t2.5）モデルはサポートされていません。テクスチャ付きモデルは受け付けられますが、そのテクスチャは結果に引き継がれません。

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

利用可能な値:

• 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表示と同じ配置です。

どちらの配置においても、切断によって生じた潰れた薄片や点状の残りパーツは、エクスポート前に除去されるため、取得するパーツはすべて印刷可能です。シーンオブジェクトをサポートする形式では、パーツごとに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 based splitting（by_partsとby_color）は一時的に利用できません。後で再試行するか、その影響を受けないmode: "auto"を使用してください。料金は発生しません。

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

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

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

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

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

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

ストリーミング対象の Auto Split タスクを識別する一意の ID です。

タスクの一意な識別子です。実装の詳細として、タスク ID には k-sortable UUID を使用していますが、id のフォーマットについて何らかの前提を置くべきではありません。

タスクのタイプです。値は print-split です。

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

分割されたモデルのレンダリングプレビューへのダウンロード可能な URL で、各パーツが異なる色で表示され、リクエストされた layout で表示されます。

by_parts または by_color リクエストの prompt でパーツ名が指定されなかった場合に true となり、この場合 Meshy は自動的にモデルを分割します — 結果に含まれるパーツ名はあなたが指定したものではなく Meshy によるものです。PENDING 以降は常に存在します。auto タスクの場合、および prompt が反映された場合は省略されます。

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

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

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

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

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

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

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

失敗したタスクのエラー詳細です。task_error オブジェクトの完全なリファレンスについては エラー を参照してください。モデルプロバイダーの安全性チェックが入力モデルを拒否した場合、タスクは task_error.type が invalid_input、code が provider_content_refused として失敗します。エラー を参照してください。

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