Skip to main content
Comfy Router が Meshy から提供する meshy/meshy-7.1 の API リファレンス。

クイックスタート

ご自身の Comfy ワークスペースでキーを作成し、COMFY_API_KEY としてエクスポートします。Python、TypeScript、Swift のスニペットは Comfy SDK(pip install comfy-sdknpm install @comfyorg/sdk、および ComfySwiftSDK Swift パッケージ)を使用しています。cURL のスニペットは、同じ呼び出しを生の HTTP で行うものです。 モデル ID: meshy/meshy-7.1 エンドポイント: POST https://api.comfy.org/v2/models/meshy/meshy-7.1

スキーマ

入力

preview バリアント

string
実行するMeshyモデル。Comfy Routerルートではこれはパス(/v2/models/meshy/{model})から提供され、省略するか null として送信できます。Routerは検証後にパスのモデルをここに書き込みます。v1 /proxyルートではMeshyTextTo3DPreviewRequestを参照してください。これはこれをMeshyAiModelに制約します。
string
デフォルト:"\"realistic\""
オブジェクトの希望するアートスタイルを記述します。指定可能な値: realisticsculpture
string
デフォルト:"\"standard\""
生成されるメッシュのジオメトリ解像度。2kと4kは、より細かい表面ディテールのためにUltraパスを実行します。2kには ai_model meshy-7、meshy-7.1 または latest が必要です。4kには meshy-7.1 または latest が必要です。指定可能な値: standard2k4k
boolean
デフォルト:"false"
非推奨。代わりに pose_mode を使用してください。モデルをA/Tポーズで生成するかどうか。
string
必須
プレビュータスクを作成する場合、このフィールドは “preview” に設定する必要があります。指定可能な値: preview
boolean
デフォルト:"false"
true の場合、入力コンテンツは有害な可能性のあるコンテンツがないかスクリーニングされます。
string
生成されるモデルのポーズモードを指定します。指定可能な値: a-poset-pose、“
string
必須
3Dモデルがどのようなオブジェクトであるかを記述します。最大600文字。
boolean
デフォルト:"true"
リメッシュフェーズを有効にするかどうかを制御します。false の場合、最も高精度な三角形メッシュを返します。
string
デフォルト:"\"auto\""
モデル生成中の対称性の動作を制御します。指定可能な値: offautoon
integer
デフォルト:"30000"
生成されるモデルのポリゴンの目標数を指定します。有効範囲は100~300,000です。範囲: 100300000
string
デフォルト:"\"triangle\""
生成されるモデルのトポロジーを指定します。指定可能な値: quadtriangle
boolean
デフォルト:"false"
非推奨。代わりに geometry_resolution を使用してください。true は geometry_resolution 2k と同等です。ai_model が meshy-7、meshy-7.1 または latest の場合にのみサポートされます。

refine バリアント

string
実行するMeshyモデル。Comfy Routerルートではこれはパス(/v2/models/meshy/{model})から提供され、省略するか null として送信できます。Routerは検証後にパスのモデルをここに書き込みます。v1 /proxyルートではMeshyTextTo3DRefineRequestを参照してください。これはこれをMeshyAiModelに制約します。
boolean
デフォルト:"false"
ベースカラーに加えてPBRマップ(metallic、roughness、normal)を生成します。Sculptureスタイルを使用する場合は enable_pbr を false に設定する必要があることに注意してください。
string
必須
リファインタスクを作成する場合、このフィールドは “refine” に設定する必要があります。指定可能な値: refine
boolean
デフォルト:"false"
true の場合、入力コンテンツは有害な可能性のあるコンテンツがないかスクリーニングされます。
string
必須
対応するプレビュータスクID。指定したプレビュータスクのステータスは SUCCEEDED である必要があります。
string
テクスチャリング処理をガイドする2D画像を提供します。.jpg、.jpeg、.png 形式、または base64 エンコードされたデータURIをサポートします。
string
テクスチャリング処理をガイドする追加のテキストプロンプトを提供します。最大600文字。
string
デフォルト:"\"2k\""
生成されるテクスチャのテクスチャ解像度。2k、4k、8k のいずれかです。4k と 8k には ai_model meshy-6、meshy-7、meshy-7.1 または latest が必要です。指定可能な値: 2k4k8k
GET /v2/models/meshy/meshy-7.1/openapi.json で Router が提供するスキーマから生成されています。これは、リクエストがプロバイダーに到達する前に Router が呼び出しを検証する対象となる、同じドキュメントです。

出力

string
プレビュータスクの作成に使用された、変更されていないart_style。
integer
タスクが作成されたときのタイムスタンプ(ミリ秒単位)。形式: int64
integer
タスクが完了したときのタイムスタンプ(ミリ秒単位)。完了していない場合は0。形式: int64
string
必須
タスクの一意の識別子。
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 から 100
string
タスクの作成に使用された、変更されていないプロンプト。
integer
タスクが開始されたときのタイムスタンプ(ミリ秒単位)。開始されていない場合は0。形式: int64
string
必須
可能な値: SUCCEEDED
object
タスクが失敗した場合にエラーメッセージを含むエラーオブジェクト。
string
詳細なエラーメッセージ。
string
テクスチャリングプロセスをガイドするために使用されたテクスチャ画像をダウンロードできるURL。
string
リファイン段階でテクスチャリングプロセスをガイドするために提供される追加のテキストプロンプト。
string
後方互換性のために維持されている非推奨のフィールド。
object[]
タスクから生成されるテクスチャURLオブジェクトの配列。
string
ベースカラーマップ画像をダウンロードできるURL。
string
メタリックマップ画像をダウンロードできるURL。
string
ノーマルマップ画像をダウンロードできるURL。
string
ラフネスマップ画像をダウンロードできるURL。
string
モデルファイルのサムネイル画像をダウンロードできるURL。
string
Text to 3Dタスクのタイプ。可能な値: text-to-3d-previewtext-to-3d-refine
string
プレビュービデオをダウンロードできるURLを返す非推奨のフィールド。

入力

出力

出荷前の確認

SDK は Idempotency-Key を生成し、自動リトライで再利用します。手動リトライでは元のキーを再利用してください。Router は最大 10 分間接続を保持できます。 リクエストが失敗すると、Router は理由を説明する X-Comfy-Error-Type レスポンスヘッダーを送信します。422 は、プロバイダーを呼び出す前に Router が入力を拒否したことを意味し、413 はリクエスト本文が Router の受け入れ可能なサイズを超えていたことを意味します。生成されたアセットは 結果 URL の有効期限 があるため、早めにダウンロードしてください。 上記のフィールド説明に記載されているサイズ制限は、プロバイダーの仕様から引用した、そのフィールドに対するプロバイダー自身の上限です。Router はリクエスト本文全体に対して別の上限を適用し、base64 エンコードされたメディアもこれにカウントされます。リクエスト本文のサイズ を参照してください。 このページは、Comfy Router 経由で呼び出す 1 つのパートナーモデルについて説明しています。同じ comfy-sdk / @comfyorg/sdk パッケージには、Comfy Cloud 上で ComfyUI のワークフローグラフ全体を実行するための 2 つ目のクライアントも含まれています: Comfy(api_key=...) / new Comfy({ apiKey })、および client.workflowsclient.assetsclient.jobsComfy SDKs を参照してください。

ヘッダー

認証、冪等性、リクエスト ID、エラー分類、リトライ間隔、支出上限。

Router API の利用

モデルの検出、バリデーションエラー、リトライ、課金。

制限事項

Router が現在対応していないことと、代替手段。