meshy/remesh の API リファレンスです。Comfy Router が Meshy から提供しています。
クイックスタート
お使いの Comfy ワークスペースでキーを作成し、COMFY_API_KEY としてエクスポートします。Python と TypeScript のスニペットは Comfy SDK(pip install comfy-sdk、npm install @comfyorg/sdk)を使用しています。cURL のスニペットは、同じ呼び出しを raw HTTP で行うものです。
モデル ID: meshy/remesh
エンドポイント: POST https://api.comfy.org/v2/models/meshy/remesh
- Wait for the result
- Queue and collect later
スキーマ
入力
boolean
デフォルト:"false"
true の場合、入力モデルファイルの形式のみを変更し、トポロジー、resize_height、target_polycount などの他の入力は無視されます。
string
リメッシュしたい完了済みの Image to 3D または Text to 3D タスクの ID。model_url が指定されていない場合に必須です。
string
3Dモデルへの公開アクセス可能な URL または data URI。対応形式は glb、gltf、obj、fbx、stl。input_task_id が指定されていない場合に必須です。
string
原点の位置。指定可能な値:
bottom、center、“number
デフォルト:"0"
モデルをメートル単位で指定した高さにリサイズします。0 はリサイズなしを意味します。
`glb`, `fbx`, `obj`, `usdz`, `blend`, `stl`[]
デフォルト:"[\"glb\"]"
リメッシュされたモデルのターゲット形式のリスト。
integer
デフォルト:"30000"
生成されるモデルのポリゴン数のターゲットを指定します。有効範囲は 100 から 300,000 です。範囲:
100 から 300000string
デフォルト:"\"triangle\""
生成されるモデルのトポロジーを指定します。指定可能な値:
quad、triangleGET /v2/models/meshy/remesh/openapi.json で提供するスキーマから生成されています。これは、リクエストがプロバイダーに到達する前に Router が呼び出しを検証する際に使用するのと同じドキュメントです。
出力
integer
タスクが作成されたときのタイムスタンプ (ミリ秒単位)。形式:
int64integer
タスクが完了したときのタイムスタンプ (ミリ秒単位)。未完了の場合は 0。形式:
int64string
必須
タスクの一意の識別子。
object
リメッシュされた 3Dモデルファイルのダウンロード URL。
string
Blender ファイルのダウンロード URL。
string
FBX ファイルのダウンロード URL。
string
GLB ファイルのダウンロード URL。
string
OBJ ファイルのダウンロード URL。
string
STL ファイルのダウンロード URL。
string
USDZ ファイルのダウンロード URL。
integer
先行するタスクの数。status が PENDING の場合にのみ意味を持ちます。
integer
タスクの進捗。未開始の場合は 0、成功時は 100。範囲:
0 から 100integer
タスクが開始されたときのタイムスタンプ (ミリ秒単位)。未開始の場合は 0。形式:
int64string
必須
指定可能な値:
SUCCEEDEDobject
タスクが失敗した場合にエラーメッセージを含むエラーオブジェクト。
string
詳細なエラーメッセージ。
string
Remesh タスクのタイプ。指定可能な値:
remesh例
入力
出力
出荷前の確認
SDK はIdempotency-Key を生成し、自動リトライで再利用します。手動リトライでは元のキーを再利用してください。Router は最大 10 分間接続を保持できます。
リクエストが失敗すると、Router は理由を示す X-Comfy-Error-Type レスポンスヘッダーを送信します。422 は、プロバイダーを呼び出す前に Router が入力を拒否したことを意味します。生成されたアセットは 結果 URL の有効期限 があるため、早めにダウンロードしてください。
ヘッダー
認証、冪等性、リクエスト ID、エラー分類、リトライ間隔、支出上限。
Router API の利用
モデルの検出、バリデーションエラー、リトライ、課金。
制限事項
Router が現在対応していないことと、代替手段。