後処理

オートリグ & アニメート

POST/v1/assets/{id}/animate

ヒューマノイドや動物をオートリグし、必要に応じてプリセットクリップをリターゲットします。手動のウェイトペイントは不要です。

非同期 idを返します。ポーリングまたはWebhookで受け取ります目安 ~2–4 minコストエンジンにより異なる

パス内の {id} は元のモデルです。結果（リギングされ、-rig-animate の場合はアニメーションも適用されたメッシュ）は新しいアセットに書き込まれます。

パラメーター

パラメーター	説明
engine任意 string	使用するリグエンジン。例: `tripo-rig-animate`, `tripo-rig`, `meshy-rig-animate`, `meshy-rig`。`-rig-animate` エンジンはリギングと同時にプリセットクリップを適用し、`-rig` エンジンはリギングのみ行います。省略するとデフォルトを使用します。一覧: `GET /v1/models?category=animate`。
preset任意 string	`-rig-animate` エンジン用のアニメーションプリセットid（例: `walk`）。最大64文字。カタログは `GET /v1/animations` で参照できます。省略するとリギングのみ行います。
license任意 string	結果物の使用権限。デフォルトは非公開（全権利留保）です。
callbackUrl任意 string	ポーリングの代わりに、完成したアセットをサーバーへプッシュします。Webhook を参照してください。

元モデルはリグ可能な形状である必要があります オートリグには明確なヒューマノイドや動物の形状が必要です。小道具、背景、抽象的な形状は 400 と error.code 13008 で失敗します。

リクエスト

curl -X POST https://api.picoberry.ai/v1/assets/019…/animate \
  -H "Authorization: Bearer pb_live_xxx" -H "Content-Type: application/json" \
  -d '{"engine":"tripo-rig-animate","preset":"walk"}'

requests.post(f"{BASE}/v1/assets/{id}/animate", headers=headers,
    json={"engine": "tripo-rig-animate", "preset": "walk"})

await fetch(`${BASE}/v1/assets/${id}/animate`, { method: "POST",
  headers: { ...headers, "Content-Type": "application/json" },
  body: JSON.stringify({ engine: "tripo-rig-animate", preset: "walk" }) });

アニメーションプリセット

GET/v1/animations?engine=tripo|meshy

エンジンで利用できるプリセットクリップを一覧表示します。プリセットはエンジン固有です。Tripo のプリセットは Meshy エンジンでは動作しないため、常にアニメートに使用するエンジンと同じエンジンから選んでください。

リクエスト

curl "https://api.picoberry.ai/v1/animations?engine=tripo" \
  -H "Authorization: Bearer pb_live_xxx"

requests.get("https://api.picoberry.ai/v1/animations", headers=headers,
    params={"engine": "tripo"})

await fetch(`${BASE}/v1/animations?engine=tripo`, { headers });

レスポンス · 200

{ "success": true, "data": [
  { "id": "walk", "name": "Walk", "category": "Movement" },
  { "id": "run", "name": "Run", "category": "Movement" },
  { "id": "slash", "name": "Slash", "category": "Combat" }
] }

各プリセットには id（/animate に preset として渡します）、表示用の name、category があります。カテゴリーは Movement, Combat, Emotion, Dance, Sports, Daily, Gesture のいずれかです。

レスポンス

レスポンス · 200

{ "success": true, "data": { "id": "019…", "taskStatus": 0 } }

taskStatus が 2 になるまで GET /v1/assets/{id} をポーリングしてください。完成した files.model にリグとベイクされたクリップが含まれます。非同期とポーリングを参照してください。

プリセットはエンジン固有です Tripo のプリセットは Meshy エンジンでは動作しません。アニメートに使用するエンジンと同じエンジンからプリセットを選んでください。