Skip to main content
meshy/rigging の API リファレンス。Meshy から Comfy Router によって提供されます。

クイックスタート

Comfy ワークスペースでキーを作成し、COMFY_API_KEY としてエクスポートします。Python と TypeScript のスニペットは Comfy SDK(pip install comfy-sdknpm install @comfyorg/sdk)を使用しています。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 形式に対応しています。
Router が GET /v2/models/meshy/rigging/openapi.json で提供するスキーマから生成されています。これは、リクエストがプロバイダーに到達する前に Router が呼び出しを検証する際に使用するドキュメントと同じものです。

出力

integer
タスクが作成された時刻のタイムスタンプ(ミリ秒単位)。形式: int64
integer
タスク結果が期限切れになる時刻のタイムスタンプ(ミリ秒単位)。形式: int64
integer
タスクが完了した時刻のタイムスタンプ(ミリ秒単位)。未完了の場合は 0。形式: int64
string
必須
タスクの一意の識別子。
integer
先行するタスクの数。ステータスが PENDING の場合のみ意味を持ちます。
integer
タスクの進捗状況 (0~100)。未開始の場合は 0、成功した場合は 100。範囲: 0100
object
タスクが 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。形式: int64
string
必須
有効な値: SUCCEEDED
object
タスクが失敗した場合にエラーメッセージを含むエラーオブジェクト。
string
詳細なエラーメッセージ。
string
リギングタスクのタイプ。有効な値: rig

入力

出力

出荷前の確認

SDK は Idempotency-Key を生成し、自動リトライで再利用します。手動リトライでは元のキーを再利用してください。Router は最大 10 分間接続を保持できます。 リクエストが失敗すると、Router は理由を示す X-Comfy-Error-Type レスポンスヘッダーを送信します。422 は、プロバイダーを呼び出す前に Router が入力を拒否したことを意味します。生成されたアセットは 結果 URL の有効期限 があるため、早めにダウンロードしてください。

ヘッダー

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

Router API の利用

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

制限事項

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