meshy/animations の API リファレンス。Meshy から Comfy Router が提供します。
クイックスタート
キーを お使いの Comfy ワークスペース で作成し、COMFY_API_KEY としてエクスポートします。Python と TypeScript のスニペットは Comfy SDK (pip install comfy-sdk、npm install @comfyorg/sdk) を使用します。cURL スニペットは、生の HTTP 経由で同じ呼び出しを行います。
モデル ID: meshy/animations
エンドポイント: POST https://api.comfy.org/v2/models/meshy/animations
- Wait for the result
- Queue and collect later
スキーマ
入力
integer
必須
適用するアニメーションアクションの識別子。
object
アニメーションファイルのポストプロセス用パラメータ。
integer
デフォルト:"30"
ターゲットフレームレート。デフォルトは 30 です。operation_type が change_fps の場合にのみ適用されます。指定可能な値:
24、25、30、60string
必須
実行する操作の種類。指定可能な値:
change_fps、fbx2usdz、extract_armaturestring
必須
正常に完了したリグタスクの ID(POST /openapi/v1/rigging から取得)。このタスクのキャラクターがアニメートされます。
GET /v2/models/meshy/animations/openapi.json で提供するスキーマから生成されたものであり、リクエストがプロバイダーに到達する前に Router が呼び出しを検証する際に使用するドキュメントと同じです。
出力
integer
タスクが作成されたときのタイムスタンプ(ミリ秒単位)。フォーマット:
int64integer
タスク結果の有効期限のタイムスタンプ(ミリ秒単位)。フォーマット:
int64integer
タスクが完了したときのタイムスタンプ(ミリ秒単位)。完了していない場合は 0。フォーマット:
int64string
必須
タスクの一意の識別子。
integer
先行するタスクの数。status が PENDING の場合にのみ意味を持ちます。
integer
タスクの進捗(0-100)。範囲:
0 から 100object
タスクが SUCCEEDED の場合、出力アニメーションの URL を含みます。
string
FBX 形式のアニメーションのダウンロード可能な URL。
string
GLB 形式のアニメーションのダウンロード可能な URL。
string
FPS を変更したアニメーションの FBX 形式のダウンロード可能な URL。
string
処理済みのアーマチュアの FBX 形式のダウンロード可能な URL。
string
処理済みのアニメーションの USDZ 形式のダウンロード可能な URL。
integer
タスクが開始されたときのタイムスタンプ(ミリ秒単位)。開始されていない場合は 0。フォーマット:
int64string
必須
指定可能な値:
SUCCEEDEDobject
タスクが失敗した場合にエラーメッセージを含むエラーオブジェクト。
string
詳細なエラーメッセージ。
string
アニメーションタスクのタイプ。指定可能な値:
animate例
入力
出力
出荷前の確認
SDK はIdempotency-Key を生成し、自動リトライで再利用します。手動リトライでは元のキーを再利用してください。Router は最大 10 分間接続を保持できます。
リクエストが失敗すると、Router は理由を示す X-Comfy-Error-Type レスポンスヘッダーを送信します。422 は、プロバイダーを呼び出す前に Router が入力を拒否したことを意味します。生成されたアセットは 結果 URL の有効期限 があるため、早めにダウンロードしてください。
ヘッダー
認証、冪等性、リクエスト ID、エラー分類、リトライ間隔、支出上限。
Router API の利用
モデルの検出、バリデーションエラー、リトライ、課金。
制限事項
Router が現在対応していないことと、代替手段。