はじめに
Tripo Auto Rig は、静止した 3D モデルに骨格を組み込みます。人物、動物、空想のクリーチャーを扱え、メッシュとテクスチャを変えずに GLB または FBX を返します。手持ちのツールでポーズやアニメーションを付けられます。骨格だけが必要なときに使い、同じリクエストで動きも付けたいときは Tripo 3D Tools の Animate エンドポイントを選びます。
主な機能とハイライト
9 種類の骨格から選べます
rig_type では biped、quadruped、hexapod、octopod、avian、serpentine、aquatic、others に加え、形状から選択する auto を指定できます。直立した宇宙飛行士のおもちゃでは、auto が指ごとの関節も含む 78 関節の人型リグを選びました。
エンジンに合うボーン名を使えます
biped のリグでは、bone_naming で Tripo 独自の名前と Mixamo、ActorCore、Unity、Unreal、VRM の命名規則を切り替えられます。手作業で名前を変えなくても、リターゲティングツールやアバターシステムにボーンを認識させられます。
リクエストパラメーター
| パラメーター | 必須 | 説明 |
|---|---|---|
mesh_url | はい | リギングする 90 MB 以下の GLB、バイナリ FBX、OBJ、STL です。直接リンクは対応する拡張子で終わる必要があります。 1 文字以上 |
rig_type | いいえ | 骨格の種類です。auto(既定)は形状から判断します。 |
bone_naming | いいえ | biped の骨格で使うボーン名です。tripo(既定)、mixamo、actorcore、unity、unreal、vrm から選びます。 |
output_format | いいえ | ブラウザーや Web エンジンには glb(既定)、デスクトップのアニメーションソフトには fbx を選びます。料金は変わりません。 |
料金
$0.36 / リグ
骨格の種類、ボーン名、出力形式にかかわらず、正常に納品されたモデルごとに固定料金がかかります。非対応ファイルを含め、失敗した処理には課金されません。
ユースケース
生成したキャラクターにポーズを付けます
画像から 3D を作るツールの出力をリギングし、Blender や Web ビューアーでポーズを調整します。静止画やサムネイル、動きのある姿勢での 3D プリントに使えます。
アバターや NPC を準備します
Unity、Unreal、VRM のボーン名でリギングすれば、既存のアニメーションセットやアバターの制作工程にキャラクターを組み込めます。
プロンプトガイドと実践のヒント
輪郭を分かりやすくします
文章のプロンプトは使いません。直立し、腕を胴体から少し離し、脚を開いたモデルがきれいにリギングしやすくなります。手足が一体化していたり腕を組んでいたりすると、関節の位置を決めにくくなります。
次の工程に形式を合わせます
Web で使う場合や Convert エンドポイントに渡す場合は output_format を glb に保ち、デスクトップソフト向けには fbx を選びます。アップロードは 90 MB 以下の GLB、バイナリ FBX、OBJ、STL に対応します。JSON 形式の .gltf ファイルは先に .glb に書き出します。
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/rig",
"input": {
"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 リファレンスを参照してください。





