meshy/rigging の API リファレンス。Meshy から Comfy Router によって提供されます。
クイックスタート
Comfy ワークスペースでキーを作成し、COMFY_API_KEY としてエクスポートします。Python、TypeScript、Swift のスニペットは Comfy SDK(pip install comfy-sdk、npm install @comfyorg/sdk、および ComfySwiftSDK Swift パッケージ)を使用しています。cURL のスニペットは、同じ呼び出しを生の HTTP で実行するものです。
モデル ID: meshy/rigging
エンドポイント: POST https://api.comfy.org/v2/models/meshy/rigging
- 結果を待つ
- キューに送信して後で取得する
スキーマ
入力
number
デフォルト:"1.7"
キャラクターモデルのおおよその高さ(メートル単位)。正の数である必要があります。範囲:
0 ~ …string
リギングが必要な入力タスク。model_url が指定されていない場合は必須です。
string
テクスチャ付きのヒューマノイド GLB ファイルへの公開アクセス可能な URL または Data URI。input_task_id が指定されていない場合は必須です。
string
モデルの UV 展開済みベースカラーテクスチャ画像。公開アクセス可能な URL または Data URI。.png 形式に対応しています。
GET /v2/models/meshy/rigging/openapi.json で提供するスキーマから生成されています。これは、リクエストがプロバイダーに到達する前に Router が呼び出しを検証する際に使用するドキュメントと同じものです。
出力
integer
タスクが作成された時刻のタイムスタンプ(ミリ秒単位)。形式:
int64integer
タスク結果が期限切れになる時刻のタイムスタンプ(ミリ秒単位)。形式:
int64integer
タスクが完了した時刻のタイムスタンプ(ミリ秒単位)。未完了の場合は 0。形式:
int64string
必須
タスクの一意の識別子。
integer
先行するタスクの数。ステータスが PENDING の場合のみ意味を持ちます。
integer
タスクの進捗状況 (0~100)。未開始の場合は 0、成功した場合は 100。範囲:
0 ~ 100object
タスクが SUCCEEDED の場合、出力アセットの URL を含みます。
object
デフォルトのアニメーションの URL を含みます。
string
ランニングアニメーションのアーマチュアを GLB 形式でダウンロードするための URL。
string
ランニングアニメーションを FBX 形式でダウンロードするための URL(スキン付き)。
string
ランニングアニメーションを GLB 形式でダウンロードするための URL(スキン付き)。
string
ウォーキングアニメーションのアーマチュアを GLB 形式でダウンロードするための URL。
string
ウォーキングアニメーションを FBX 形式でダウンロードするための URL(スキン付き)。
string
ウォーキングアニメーションを GLB 形式でダウンロードするための URL(スキン付き)。
string
リギング済みキャラクターを FBX 形式でダウンロードするための URL。
string
リギング済みキャラクターを GLB 形式でダウンロードするための URL。
integer
タスクが開始された時刻のタイムスタンプ(ミリ秒単位)。未開始の場合は 0。形式:
int64string
必須
有効な値:
SUCCEEDEDobject
タスクが失敗した場合にエラーメッセージを含むエラーオブジェクト。
string
詳細なエラーメッセージ。
string
リギングタスクのタイプ。有効な値:
rig例
入力
出力
出荷前の確認
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.workflows、client.assets、client.jobs。Comfy SDKs を参照してください。
ヘッダー
認証、冪等性、リクエスト ID、エラー分類、リトライ間隔、支出上限。
Router API の利用
モデルの検出、バリデーションエラー、リトライ、課金。
制限事項
Router が現在対応していないことと、代替手段。