オートリグ & アニメート
ヒューマノイドを(PB Animation なら四足やその他のキャラクターも)オートリグし、必要に応じてプリセットクリップをリターゲットします。手動のウェイトペイントは不要です。
パス内の {id} は元のモデルです。結果(リギングされ、-rig-animate の場合はアニメーションも適用されたメッシュ)は新しいアセットに書き込まれます。
パラメーター
| パラメーター | 説明 |
|---|---|
| engine任意 string | 使用するリグエンジン。例: tripo-rig-animate, tripo-rig, meshy-rig-animate, meshy-rig, pb-rig, pb-rig-animate, pb-retarget。-rig エンジンはリギングのみ、-rig-animate エンジンはリギングと同時にプリセットクリップを適用し、-retarget エンジンは同じエンジンでリギング済みのアセット({id} がそのアセット)にクリップだけを適用します。省略するとデフォルト(tripo-rig)を使用します。一覧とクレジットコスト: GET /v1/models?category=animate。 |
| preset任意 string | -rig-animate・-retarget エンジン用のアニメーションプリセットid(例: walk)。最大64文字。同じエンジンの GET /v1/animations から選んでください。エンジンの接頭辞は自動で付き、別のエンジンの接頭辞(preset:・meshy:・pb:)が付いたプリセットは 400 になります。PB エンジンは GET /v1/animations?engine=pb の一覧にある id だけを受け付けます。それ以外は 400 になります。pb-rig-animate と pb-retarget ではプリセットが必須で、リギングのみの pb-rig は受け付けません。リギングだけなら -rig エンジンを使ってください。Tripo・Meshy の -rig-animate エンジンにプリセットなしで送ってもリギングのみ行いますが、-rig-animate の料金がかかります。 |
| body任意 string | PB Animation 専用。リギングする対象の体型: humanoid(デフォルト)、quadruped(四足)、other(その他)。リグを新しく作る pb-rig と pb-rig-animate だけが受け付けます。ほかのエンジンに送ると 400 になります。Tripo・Meshy はヒューマノイドのみをリギングし、pb-retarget は元のアセットをリギングしたときの体型をそのまま使います。現在 quadruped と other はリギングのみです。pb-rig を使ってください(PB Animation を参照)。 |
| 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" }) });PB Animation
PicoBerry 独自のリガーは body で選んだ体型に合わせてボーンに名前を付けるため、ヒューマノイド以外もリギングできます。
- ヒューマノイド —
pb-rigはリギングのみ、pb-rig-animateはリギングとモーションを同時に行います。モーションを追加するには、リギング済みのアセットにpb-retargetを呼び出してください。リギングし直さず、そのリグを使います。 - 四足 —
pb-rigに"body": "quadruped"。四足のモーションはまだ提供されていないため(picoberry.ai と同じです)、現在はリギングのみです。四足の体型やリグへのモーション、quad_*モーションのリクエストは、クレジットが消費される前に400を返します。 - その他 — それ以外の形状は
pb-rigに"body": "other"。専用のモーションはありません。
PB のモーションは GET /v1/animations?engine=pb から選びます。picoberry.ai と同じ一覧です。一覧にないモーションは、クレジットが消費される前に 400 を返します。
curl -X POST https://api.picoberry.ai/v1/assets/019…/animate \
-H "Authorization: Bearer pb_live_xxx" -H "Content-Type: application/json" \
-d '{"engine":"pb-rig","body":"quadruped"}'requests.post(f"{BASE}/v1/assets/{id}/animate", headers=headers,
json={"engine": "pb-rig", "body": "quadruped"})await fetch(`${BASE}/v1/assets/${id}/animate`, { method: "POST",
headers: { ...headers, "Content-Type": "application/json" },
body: JSON.stringify({ engine: "pb-rig", body: "quadruped" }) });アニメーションプリセット
エンジンで利用できるプリセットクリップを一覧表示します。プリセットはエンジン固有です。Tripo のプリセットは Meshy・PB エンジンでは動作しないため、常にアニメートに使用するエンジンと同じエンジンから選んでください。
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 });{ "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 のいずれかです。
engine=pb では PB Animation のモーションが返ります。picoberry.ai に表示される一覧と同じなので、そこで非表示のモーションはここにもありません。各モーションには、そのモーションが再生されるリグの体型 body が付きます。四足のモーションはまだ提供されていないため、現在の一覧はすべて humanoid です。PB のモーションには独自のカテゴリーがあります(Walk, Run, Knight, Dance …)。
{ "success": true, "data": [
{ "id": "walk", "name": "Walk", "category": "Movement", "engine": "pb", "body": "humanoid" },
{ "id": "run", "name": "Run", "category": "Movement", "engine": "pb", "body": "humanoid" }
] }レスポンス
{ "success": true, "data": { "id": "019…", "taskStatus": 0 } }taskStatus が 2 になるまで GET /v1/assets/{id} をポーリングしてください。完成した files.model にリグとベイクされたクリップが含まれます。非同期とポーリング を参照してください。