Resize API

model_url を送信しない場合は必須です。リサイズしたいモデルを持つ Meshy タスクの ID です。そのタスクのステータスは SUCCEEDED である必要があります。Meshy はリサイズ後のモデルを GLB ファイルとして返します。

input_task_id を送信しない場合は必須です。リサイズするモデルで、公開URLまたはData URIとして指定します。両方送信した場合、Meshy は input_task_id を使用します。

モデルは、http または https の URL からの場合は最大400MB、Data URIの場合は最大100MBの、GLB、glTF、OBJ、FBX、またはSTLファイルである必要があります。Data URIの場合、MIMEタイプには application/octet-stream を使用してください。

100MBを超えるファイルは、さらに以下のルールにも従う必要があります。

• GLB、glTF、FBX、または OBJ ファイルは、最大10,000,000面まで対応しています。Meshy は面を三角形としてカウントするため、四角形は2面としてカウントされ、複数回描画されるメッシュはコピーごとに1回としてカウントされます。
• FBX ファイルは、バイナリFBX 7.1以降である必要があります。
• GLB または glTF ファイルは、Draco圧縮を使用していないこと。

GLB、OBJ、FBX、または STL ファイルは、結果でも同じ形式が維持されます。.gltf ファイルまたはData URIは、GLBとして返されます。

モデルの新しい高さ（メートル単位）で、0より大きい値を指定します。負の値を指定すると 400 が返されます。

モデルの最長辺の新しい長さ（メートル単位）で、0より大きい値を指定します。負の値を指定すると 400 が返されます。Meshy はモデルのアスペクト比を維持します。

AIビジョンでオブジェクトの実世界での高さを推定し、それに合わせてモデルをリサイズするかどうかです。origin_at を設定しない限り、Meshy は原点を底面に配置します。

リサイズ後にモデルの原点をどこに置くか、bottom または center を指定します。

リクエストを実行できません。エラーメッセージには、検出された問題が示されます。例：

• パラメータの欠落: model_url と input_task_id のどちらも送信されていません。
• リサイズモードの欠落: resize_height、resize_longest_side、auto_size のいずれも送信されていません。
• 排他的なパラメータ: リクエストに resize_height、resize_longest_side、auto_size のうち複数が含まれています。1つだけ送信してください。
• 負のサイズ: resize_height または resize_longest_side が負の値です。
• 無効な入力タスク: input_task_id が成功したタスクではありません。
• 無効なモデル形式: model_url のファイルがサポートされていない拡張子です。
• 到達不能なURL: Meshy が model_url のファイルをダウンロードできません。
• モデルファイルが大きすぎる: model_url のファイルが、http または https の URL からの場合は400MBを超えているか、Data URIの場合は100MBを超えています。
• 面が多すぎる: model_url のファイルが100MBを超えており、面数が10,000,000を超えています。面数を減らしてから、ファイルを再送信してください。
• 100MBを超えるASCII FBX: model_url のファイルが100MBを超えるASCII FBXです。バイナリFBXまたはGLBとして送信してください。
• 読み取れないモデルファイル: model_url のファイルが100MBを超えており、Meshy がそのヘッダーを読み取れません。たとえば、Draco圧縮されたGLBまたはglTFであるか、7.1より古いバイナリFBXである場合です。
• モデルヘッダーが複雑すぎる: model_url のファイルが100MBを超えており、そのヘッダーに含まれるメッシュ、ノード、またはレコードが多すぎてチェックできません。ファイル内のオブジェクト数を減らしてから、再送信してください。

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

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

例：

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

input_task_id がバスレリーフモデルであり、このエンドポイントではリサイズできません。メッセージは This model type does not support this operation です。別のモデルを送信してください。

input_task_id がどのタスクとも一致しません。タスクIDを確認してから、リクエストを再送信してください。

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

作成レスポンスから取得したタスクID。

削除するタスクのID。

返却するページ番号。

1ページあたりのタスク数。最大100。

ソート順。

利用可能な値:

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

作成時のレスポンスから取得したタスクIDです。