後処理

オートリグ & アニメート

POST/v1/assets/{id}/animate

ヒューマノイドを(PB Animation なら四足やその他のキャラクターも)オートリグし、必要に応じてプリセットクリップをリターゲットします。手動のウェイトペイントは不要です。

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

パス内の {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 のモーションは 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" }) });

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

GET/v1/animations?engine=tripo|meshy|pb

エンジンで利用できるプリセットクリップを一覧表示します。プリセットはエンジン固有です。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 });
レスポンス · 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 のいずれかです。

engine=pb では PB Animation のモーションが返ります。picoberry.ai に表示される一覧と同じなので、そこで非表示のモーションはここにもありません。各モーションには、そのモーションが再生されるリグの体型 body が付きます。四足のモーションはまだ提供されていないため、現在の一覧はすべて humanoid です。PB のモーションには独自のカテゴリーがあります(Walk, Run, Knight, Dance …)。

レスポンス · 200 · engine=pb
{ "success": true, "data": [
  { "id": "walk", "name": "Walk", "category": "Movement", "engine": "pb", "body": "humanoid" },
  { "id": "run", "name": "Run", "category": "Movement", "engine": "pb", "body": "humanoid" }
] }

レスポンス

レスポンス · 200
{ "success": true, "data": { "id": "019…", "taskStatus": 0 } }

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

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