meshy/meshy-7 の API リファレンスです。Comfy Router が Meshy から提供しています。
クイックスタート
Comfy ワークスペースでキーを作成し、COMFY_API_KEY としてエクスポートします。Python と TypeScript のスニペットは Comfy SDK(pip install comfy-sdk、npm install @comfyorg/sdk)を使用しています。cURL スニペットは、同じ呼び出しを生の HTTP で実行するものです。
モデル ID: meshy/meshy-7
エンドポイント: POST https://api.comfy.org/v2/models/meshy/meshy-7
- Wait for the result
- Queue and collect later
スキーマ
入力
preview バリアント
string
実行するMeshyモデル。Comfy Routerのルートではこれはパス(
/v2/models/meshy/{model})から供給され、省略するかnullとして送信できます。Routerは検証後にパスのモデルをここへ書き込みます。v1 /proxyルートではMeshyTextTo3DPreviewRequestを参照してください。これはMeshyAiModelに制約します。string
デフォルト:"\"realistic\""
オブジェクトの希望するアートスタイルを記述します。指定可能な値:
realistic、sculptureboolean
デフォルト:"false"
非推奨。代わりにpose_modeを使用してください。モデルをA/Tポーズで生成するかどうか。
string
必須
previewタスクを作成する場合、このフィールドは”preview”に設定する必要があります。指定可能な値:
previewboolean
デフォルト:"false"
trueの場合、入力コンテンツは有害な可能性のあるコンテンツについてスクリーニングされます。
string
生成されるモデルのポーズモードを指定します。指定可能な値:
a-pose、t-pose、“string
必須
3Dモデルがどのようなオブジェクトであるかを記述します。最大600文字。
boolean
デフォルト:"true"
remeshフェーズを有効にするかどうかを制御します。falseの場合、最高精度の三角形メッシュを返します。
string
デフォルト:"\"auto\""
モデル生成中の対称性の挙動を制御します。指定可能な値:
off、auto、oninteger
デフォルト:"30000"
生成されるモデルの目標ポリゴン数を指定します。有効範囲は100から300,000です。範囲:
100 から 300000string
デフォルト:"\"triangle\""
生成されるモデルのトポロジーを指定します。指定可能な値:
quad、triangleboolean
デフォルト:"false"
より高忠実度のジオメトリと、より細かな表面ディテールのためのUltra生成を有効にします。ai_modelがmeshy-7またはlatestの場合のみサポートされます。
refine バリアント
string
実行するMeshyモデル。Comfy Routerのルートではこれはパス(
/v2/models/meshy/{model})から供給され、省略するかnullとして送信できます。Routerは検証後にパスのモデルをここへ書き込みます。v1 /proxyルートではMeshyTextTo3DRefineRequestを参照してください。これはMeshyAiModelに制約します。boolean
デフォルト:"false"
ベースカラーに加えてPBRマップ(メタリック、ラフネス、ノーマル)を生成します。Sculptureスタイルを使用する場合はenable_pbrをfalseに設定する必要があることに注意してください。
string
必須
refineタスクを作成する場合、このフィールドは”refine”に設定する必要があります。指定可能な値:
refineboolean
デフォルト:"false"
trueの場合、入力コンテンツは有害な可能性のあるコンテンツについてスクリーニングされます。
string
必須
対応するpreviewタスクID。指定されたpreviewタスクのステータスはSUCCEEDEDでなければなりません。
string
テクスチャリングプロセスを導くための2D画像を指定します。.jpg、.jpeg、.png形式、またはbase64エンコードされたデータURIをサポートします。
string
テクスチャリングプロセスを導くための追加のテキストプロンプトを指定します。最大600文字。
string
デフォルト:"\"2k\""
生成されるテクスチャのテクスチャ解像度。2k、4k、8kのいずれか。4kと8kにはai_modelがmeshy-6、meshy-7またはlatestが必要です。指定可能な値:
2k、4k、8kGET /v2/models/meshy/meshy-7/openapi.json で提供するスキーマから生成されています。これは、リクエストがプロバイダーに到達する前に呼び出しを検証する際に使用するドキュメントと同じものです。
出力
string
プレビュータスクの作成に使用された、変更されていない art_style。
integer
タスクが作成された時刻のタイムスタンプ(ミリ秒単位)。形式:
int64integer
タスクが完了した時刻のタイムスタンプ(ミリ秒単位)。完了していない場合は 0。形式:
int64string
必須
タスクの一意の識別子。
object
Meshy によって生成されたテクスチャ付き 3Dモデルファイルのダウンロード可能な URL。
string
FBX ファイルのダウンロード可能な URL。
string
GLB ファイルのダウンロード可能な URL。
string
MTL ファイルのダウンロード可能な URL。
string
OBJ ファイルのダウンロード可能な URL。
string
USDZ ファイルのダウンロード可能な URL。
string
後方互換性のために維持されている非推奨のフィールド。
integer
先行タスクの数。status が PENDING の場合にのみ意味を持ちます。
integer
タスクの進捗。開始されていない場合は 0、成功した場合は 100。範囲:
0 から 100string
タスクの作成に使用された、変更されていないプロンプト。
integer
タスクが開始された時刻のタイムスタンプ(ミリ秒単位)。開始されていない場合は 0。形式:
int64string
必須
取り得る値:
SUCCEEDEDobject
タスクが失敗した場合にエラーメッセージを含むエラーオブジェクト。
string
詳細なエラーメッセージ。
string
テクスチャリング処理のガイドに使用されたテクスチャ画像のダウンロード可能な URL。
string
リファイン段階でテクスチャリング処理をガイドするために提供された追加のテキストプロンプト。
string
後方互換性のために維持されている非推奨のフィールド。
object[]
タスクから生成されたテクスチャ URL オブジェクトの配列。
string
ベースカラーマップ画像のダウンロード可能な URL。
string
メタリックマップ画像のダウンロード可能な URL。
string
ノーマルマップ画像のダウンロード可能な URL。
string
ラフネスマップ画像のダウンロード可能な URL。
string
モデルファイルのサムネイル画像のダウンロード可能な URL。
string
Text to 3D タスクの種類。取り得る値:
text-to-3d-preview、text-to-3d-refinestring
プレビュービデオのダウンロード可能な URL を返す非推奨のフィールド。
例
入力
出力
出荷前の確認
SDK はIdempotency-Key を生成し、自動リトライで再利用します。手動リトライでは元のキーを再利用してください。Router は最大 10 分間接続を保持できます。
リクエストが失敗すると、Router は理由を示す X-Comfy-Error-Type レスポンスヘッダーを送信します。422 は、プロバイダーを呼び出す前に Router が入力を拒否したことを意味します。生成されたアセットは 結果 URL の有効期限 があるため、早めにダウンロードしてください。
ヘッダー
認証、冪等性、リクエスト ID、エラー分類、リトライ間隔、支出上限。
Router API の利用
モデルの検出、バリデーションエラー、リトライ、課金。
制限事項
Router が現在対応していないことと、代替手段。