Auto Split API

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

モデルをどのようにパーツに分割するかを指定します。

使用可能な値：

• auto: Meshy が切断位置を選択します。prompt は無視されます。
• by_parts: prompt で指定した構造的なパーツ（頭、腕、胴体など）に沿って切断します。
• by_color: prompt で指定した色の領域に沿って切断します。アップロードされた画像から生成された入力（画像から3D または マルチ画像から3D）が必要です。それ以外の入力は 400 で拒否されます。

分割されたモデルをエクスポートする形式です。各パーツは、どの形式においても個別のオブジェクトになります。glb は常に生成され model_urls で返されます。これに加えて必要な他の形式を指定してください。

使用可能な値：glb、obj、fbx、usdz、blend、3mf。

3mf はスライサー向けに書き出されます。パーツごとに1つのオブジェクトとし、それぞれが独自のフィラメントスロットに割り当てられるため、Bambu Studio ではファイルを開くと個別に色分けされた、それぞれ選択可能なパーツとして表示されます（アーカイブには Bambu Studio のプロジェクト設定が含まれています。他のスライサーはジオメトリを読み取ります）。Meshy の他の印刷用フォーマットと同様に単位はミリメートルで、このエンドポイントは目標サイズを受け付けないため、モデル全体は最長辺が150 mmになるようスケーリングされます。これは他の印刷用フォーマットのエクスポートで使われているのと同じ上限で、主要なビルドプレートに収まるように選ばれています。layout: "on_plate" の場合、この上限はレイアウトされたプレート全体に適用されるため、そのままスライスできる状態になります。assembled の場合は、パーツは元のモデルにあった位置のまま配置され、スライサー側で配置を調整することになります。

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

使用可能な値：

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

どちらのレイアウトでも、エクスポートされるファイルにはパーツごとに1つのオブジェクトのみが含まれます。切断によって生じた、つぶれた薄片や点のようなパーツは、エクスポート前に除去されるため、ファイル内に存在するすべてのオブジェクトは印刷可能です。

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

リクエストが受理されませんでした。一般的な原因：

• prompt が欠落している: mode が by_parts または by_color の場合、prompt は必須です。
• prompt で指定されたパーツが2つ未満: by_parts / by_color には、少なくとも2つの名前付きパーツ（例えば head, torso, base）が必要です。split into individual parts（個々のパーツに分割する）のような一般的な指示は拒否されます。料金は発生しません。
• サポートされていない入力タスク: input_task_id は、サポートされているタイプの、成功したタスクを参照している必要があり、Meshy 6 または Meshy 7 で生成されている必要があります。
• テクスチャ付きの入力: 入力モデルにテクスチャが付いています。現時点ではテクスチャなしのモデルのみサポートされています。
• 参照画像がない: by_color には、アップロードされた画像から生成された入力が必要です。
• サポートされていない形式: target_formats に stl が含まれています。
• 範囲外のコネクタ設定: connector_size または connector_height が 0.1 〜 0.8 の範囲外です。

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

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

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

レート制限を超えました。by_parts および by_color のリクエストは、アカウントごとに1分あたり12件という 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 を使用していますが、id のフォーマットについて何らかの前提を置くべきではありません。

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

分割されたモデルのダウンロード可能な URL で、リクエストしたフォーマットごとに1つずつ格納されます。各パーツはファイル内でそれぞれ別個のオブジェクトになります。リクエストされなかったフォーマットのプロパティは省略されます。

分割されたモデルのレンダリングプレビューをダウンロードできる URL です。各パーツがそれぞれ異なる色で表示され、指定した layout で描画されます。

by_parts または by_color リクエストの prompt にパーツ名が指定されていなかったため、Meshy が自動的にモデルを分割した場合に true になります — この場合、結果に含まれるパーツ名はあなたが指定したものではなく、Meshy が付けたものです。PENDING の時点から存在します。auto タスクの場合、およびプロンプトの内容が反映された場合は省略されます。

分割モデル内の印刷可能なパーツの数です — エクスポートされたファイル内のオブジェクト1つにつき1パーツです。セグメンテーションによって印刷可能なパーツにできなかった潰れた薄片は、エクスポート前にファイルから取り除かれ、カウントには含まれません。

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

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

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

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

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

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

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

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