はじめに
Tripo Convert は 3D モデルのファイル形式を変え、必要なら変換中にモデルも整えます。生成、リギング、アニメーション付けの後に使います。同じキャラクターを、ブラウザーゲーム用の GLB、Blender やゲームエンジン用の FBX、プリンター用の STL として出力できます。既定では骨格とアニメーションクリップも引き継ぎます。
主な機能とハイライト
形式を変えてもリグとクリップを維持します
動きの付いた宇宙飛行士を FBX に書き出し、その FBX を GLB に戻しました。78 関節、3 枚のテクスチャマップ、歩行クリップが残り、Web ビューアーですぐに再生できました。
必要な調整だけを加えられます
face_limit はポリゴン数を減らし、quad_mesh はモデリングソフト向けに表面を四角形で組み直します。texture_size と texture_format は画像マップのサイズや形式を変えます。pivot_to_bottom、flatten_bottom、scale_factor は配置や印刷の準備に使います。いずれかを使うと上位料金に切り替わります。
リクエストパラメーター
| パラメーター | 必須 | 説明 |
|---|---|---|
mesh_url | はい | 変換する 90 MB 以下の GLB、バイナリ FBX、OBJ、STL です。リギング済みやアニメーション付きのファイルも使えます。 1 文字以上 |
output_format | はい | 必須です。ブラウザーや Web ゲームには glb、アニメーションソフトやエンジンには fbx、3D プリントには stl(形状のみ)を選びます。 |
quad_mesh | いいえ | 既定で無効です。有効にすると四角形ポリゴンにリメッシュします。 デフォルト値: |
face_limit | いいえ | 任意の最大面数で、48~2,000,000 を指定できます。空欄なら元の面数を保ちます。 |
texture_size | いいえ | 拡散テクスチャのピクセルサイズで、128~8192、既定は 4096 です。ほかの値を指定すると上位料金が適用されます。 |
texture_format | いいえ | 書き出すテクスチャは jpeg(既定)、png、webp から選びます。png または webp では上位料金が適用されます。 |
pivot_to_bottom | いいえ | 既定で無効です。有効にするとピボットを底面の中心に移し、配置時にモデルを地面に接地させやすくします。 デフォルト値: |
scale_factor | いいえ | 書き出し時の一様な拡大縮小倍率で、既定は 1 です。ほかの値を指定すると上位料金が適用されます。 |
flatten_bottom | いいえ | 既定で無効です。有効にすると底面を平らにするため、3D プリントの前処理に使えます。 デフォルト値: |
forward_axis | いいえ | 出力ファイルでモデルが向く軸です。+x(既定)、-x、+y、-y から選びます。 |
fbx_preset | いいえ | FBX 書き出し用の互換プリセットです。blender(既定)、3dsmax、mixamo、 |
bake_textures | いいえ | 既定で有効です。高度なマテリアルをベーステクスチャにベイクします。 デフォルト値: |
keep_animation | いいえ | 既定で有効です。骨格とアニメーションクリップを新しいファイルに書き込みます。 デフォルト値: |
in_place | いいえ | 既定で無効です。有効にすると、書き出すアニメーションクリップから前進移動を取り除きます。 デフォルト値: |
料金
$0.072 / 変換
形式だけを変える場合は基本料金です。quad_mesh、face_limit、flatten_bottom、pivot_to_bottom の使用、texture_size の 4096 以外への変更、texture_format の jpeg 以外への変更、scale_factor の 1 以外への変更のいずれかを行うと、上位料金が適用されます。失敗した処理には課金されません。
ユースケース
FBX を Web 用の GLB に変換します
アニメーションツールや、FBX 出力を選んだ Rig・Animate のファイルはブラウザーでは開けません。GLB に変換すれば、three.js、Babylon.js、Web ゲームエンジンに読み込めます。
ポーズを 3D プリントします
キャラクターにポーズや動きを付け、flatten_bottom を有効にして STL に書き出し、スライサーに渡します。STL に含まれるのは形状だけなので、色と動きは取り除かれます。
プロンプトガイドと実践のヒント
使用先に合わせて形式を選びます
プロンプトは使いません。output_format に glb、fbx、stl を指定します。quad_mesh は必ず FBX を出力するため、四角形化する場合は output_format を fbx にする必要があります。
形式だけの変換は設定を絞ります
形式と forward_axis、fbx_preset、bake_textures、keep_animation、in_place だけの指定なら基本料金のままです。変更が必要なければ、texture_size は 4096、texture_format は jpeg、scale_factor は 1 に保ちます。
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/convert",
"input": {
"fbx_preset": "blender",
"flatten_bottom": false,
"forward_axis": "+x",
"mesh_url": "https://example.com/reference.png",
"output_format": "glb",
"pivot_to_bottom": false,
"quad_mesh": false
}
}'
# 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 リファレンスを参照してください。





