はじめに
Tripo Animate は、静止した 3D キャラクターに動きを付けて返します。1 回のリクエストで骨格を加え、Tripo のプリセット集から最大 5 つのモーションを適用します。画像から生成したモデルを、手動でリギングせずに歩かせたり走らせたり、剣を振らせたりできます。モーションごとに名前付きクリップを作り、1 つの GLB または FBX に保存します。
主な機能とハイライト
体形に応じた 16 種のプリセットです
人型には idle、walk、run、dive、climb、jump、slash、shoot、hurt、fall、turn を使えます。ほかの体形には専用のサイクル quadruped:walk、hexapod:walk、octopod:walk、serpentine:march、aquatic:march があります。
クリップを切り替えて再生できます
jump と slash を指定したテストでは、3.0 MB の GLB に jump(2.2 秒)と slash(6.6 秒)の 2 クリップが入りました。Web ビューアーやゲームエンジンで名前から選び、場面に必要な動きを再生できます。
リクエストパラメーター
| パラメーター | 必須 | 説明 |
|---|---|---|
mesh_url | はい | 動きを付ける 90 MB 以下の GLB、バイナリ FBX、OBJ、STL です。骨格は同じ処理内で追加されるため、事前のリギングは不要です。 1 文字以上 |
animations | はい | 1~5 行で、各行に walk、run、jump、slash などのプリセット名を指定します。各行はファイル内の独立したクリップとなり、その分の料金が加算されます。 1 件以上 · 5 件以内 |
rig_type | いいえ | 骨格の種類で、既定は auto です。対応する歩行・前進プリセットを使うときは quadruped、hexapod、octopod、serpentine、aquatic を選びます。 |
bone_naming | いいえ | biped の骨格のボーン名です。tripo(既定)、mixamo、actorcore、unity、unreal、vrm を選べます。 |
output_format | いいえ | glb(既定)または fbx です。どちらも骨格と指定したすべてのクリップを含みます。 |
in_place | いいえ | 既定で無効です。有効にするとクリップから前進移動が取り除かれ、キャラクターはその場で動きます。 デフォルト値: |
料金
$0.504 / アニメーション付きモデル
納品ごとの固定料金に、animations に指定したモーションごとの一定額が加わります。そのため 5 つのモーションは 1 つより高くなります。骨格の種類、ボーン名、in_place、出力形式で料金は変わりません。失敗した処理には課金されません。
ユースケース
生成した主人公をブラウザーゲームで動かします
in_place を有効にして idle、walk、jump を指定し、GLB を Web エンジンに読み込みます。体の動きはクリップで再生し、位置の移動はキャラクターコントローラーで扱えます。
アニメーション映像の動きを仮組みします
walk や run から動きを作り、シンプルなグレーのプレビューとしてレンダリングします。それを 3D レイアウトを完成映像に仕上げる動画モデルへ渡せます。
プロンプトガイドと実践のヒント
体形とモーションを合わせます
文章のプロンプトはなく、animations の各行で動きを決めます。2 足のキャラクターには人型用プリセットを使います。動物やクリーチャーには rig_type と併せて、対応する歩行・前進プリセットを選びます。
ルートモーションを先に決めます
in_place が無効なら、walk と run はシーン内を前進するため、カットシーンやプレビューに向いています。ゲームのコードで位置を移動させる場合は有効にします。モーションを追加するたびに料金が増えるので、使うクリップだけを指定します。
API クイックスタート
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "tripo/tools/animate",
"input": {
"animations": [
{
"name": "idle"
}
],
"bone_naming": "tripo",
"mesh_url": "https://example.com/reference.png",
"output_format": "glb",
"rig_type": "auto"
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
認証、完全なスキーマ、ポーリング、エラー処理は API リファレンスを参照してください。





