はじめに
Tripo H3.1 は、Tripo AI が 2026 年 3 月に発表した、制作現場向けアセットのための画像から 3D を作るモデルです。従来の H シリーズより形状がシャープになり、入力画像への忠実さとテクスチャの品質が上がっています。画像 1 枚(image_url)を送ると、バイナリ glTF ファイル(.glb)が 1 つ返ります。スイッチ 1 つだけの変換ツールと違い、パイプラインの各段階が開放されています。メッシュにテクスチャを付けるか、PBR マップ、高精細テクスチャ、精細な形状、四角形ポリゴン、目標面数、実寸スケール、最終的な向き、2 つの別々のシード。プロンプトはありません。
主な機能とハイライト
画像に沿った形
ブーツのテストでは、写真の比率が保たれ、写真が正面だけだったにもかかわらず、かかとのループ、靴ひものフック、靴底が正しい側に付きました。テクスチャ付きの結果には、使い込んだ革、赤い靴ひも、ステッチがメッシュの上に再現されていました。
切り替えも強化もできるテクスチャ
テクスチャは既定でオンで、PBR 一式として出てきます。既定設定のファイルには、2048 ピクセルのベースカラー、メタリック/ラフネス、法線の 3 枚が 1 つのマテリアルに入っていました。texture_quality: detailed で高解像度のテクスチャ、extreme で 8K のテクスチャを指定でき、fast は標準サイズのまま、より早く仕上がります。generate_texture と generate_pbr を両方オフにすると、いちばん安い無地のメッシュが返ります。
トポロジーとサイズを自分で決める
face_limit は面数の上限を 1,000〜2,000,000 の範囲で決め、quad_mesh はモデリングソフトで編集しやすい四角形ポリゴンに切り替え、geometry_quality: detailed は表面の細部により多くを費やします。auto_size はメッシュを実寸にスケーリングし、model_orientation: align_image は画像に合わせて向きを変えます。
ローポリメッシュとパーツ分割
low_poly は、密でスキャンのような表面を、きれいなローポリ・トポロジーに置き換えます。単純な小物向けです。検証用のブーツを face_limit: 5000 で処理したところ、約 3 分で 0.38 MB の GLB になり、三角面は 7,675 でした。generate_parts は、被写体を一つの GLB の中で名前付きのパーツに分けます。検証用の宇宙飛行士のおもちゃは 78 秒で、テクスチャなしのパーツ 18 個、合計 47,304 三角面になりました。
実測した内容
既定設定で革のブーツを正面から撮った 1024×1024 の画像は、167 秒で 1,471,382 三角面、テクスチャ 3 枚、45.8 MB の GLB になりました。この密度こそ、ブラウザーで見せるものには face_limit を指定すべき理由です。
リクエストパラメーター
| パラメーター | 必須 | 説明 |
|---|---|---|
image_url | はい | モデル化する画像。JPEG・PNG・WebP、10 MB まで。 1 文字以上 |
generate_texture | いいえ | 既定でオン。メッシュにテクスチャを塗ります。 デフォルト値: |
generate_pbr | いいえ | 既定でオン。ベースカラーに加えて PBR のマテリアルマップ(メタリック/ラフネスと法線)を作り、 |
texture_quality | いいえ | standard(既定)、detailed、extreme、fast のいずれか。detailed は高解像度のテクスチャ、extreme は 8K のテクスチャを作り、どちらも料金に加算されます。 |
texture_version | いいえ | v3.0-20250812(既定)か、新しい v3.5-20260815。 |
remove_lighting | いいえ | 既定でオン。テクスチャを付ける前に、画像に焼き込まれたハイライトや影を取り除き、モデルが手元のシーンの照明に反応するようにします。 デフォルト値: |
geometry_quality | いいえ | standard(既定)か detailed。detailed は表面の細部をより細かく作り、いちばん高い加算オプションです。 |
quad_mesh | いいえ | 既定でオフ。オンにすると三角形ではなく四角形ポリゴンで返り、モデリングソフトで編集しやすくなります。 デフォルト値: |
low_poly | いいえ | 既定でオフ。オンにすると、手作業でモデリングしたような、きれいで軽いトポロジーのメッシュを作り、単純な小物に向きます。 デフォルト値: |
generate_parts | いいえ | 既定でオフ。オンにすると、モデルを一つの GLB の中の名前付きパーツとして返します(おもちゃの宇宙飛行士の例では 18 パーツ)。 デフォルト値: |
face_limit | いいえ | 任意の目標面数、1,000〜2,000,000。空のままだとモデル任せで 100 万面を超えることもあります。 |
image_autofix | いいえ | 既定でオフ。オンにすると、モデル化の前にぼやけた、ノイズの多い、または低解像度の画像を補正します。 デフォルト値: |
model_orientation | いいえ | default はモデル標準の向き、 |
texture_alignment | いいえ |
|
auto_size | いいえ | 既定でオフ。オンにすると推定した実寸にメッシュをスケーリングし、AR や 3D プリントに便利です。 デフォルト値: |
uv_unwrap | いいえ | 既定でオン。オフにすると UV 展開を省くため、生成が速くなり、ファイルも小さくなります。 デフォルト値: |
seed | いいえ | 形状の段階の任意のシード。固定すると同じ形を再現できます。 |
texture_seed | いいえ | テクスチャの段階の任意のシード。seed を固定してこれを変えると、同じ形に別のテクスチャを試せます。 |
料金
$0.432 / モデル
モデルが納品された時点で 1 リクエストにつき 1 回課金されます。メッシュの基本料金に、テクスチャ(generate_texture または generate_pbr)、高精細または 8K のテクスチャ、精細な形状、四角形ポリゴン、ローポリ・トポロジー、パーツ分割の定額加算が付きます。generate_parts をオンにすると、パーツはテクスチャなしの三角形メッシュになるため、テクスチャと四角形ポリゴンの加算は外れます。面数、スケール、向き、テクスチャの合わせ方、テクスチャのバージョン、照明の除去、UV 展開、画像の補正、シードは料金に影響せず、失敗したリクエストは課金されません。
ユースケース
ゲーム、AR、リアルタイムシーン向けのアセット
face_limit をシーンの予算に合わせ、編集するアセットなら quad_mesh をオンにし、シーンの照明に反応するよう PBR はオンのままにします。小物 1 つにつきリクエスト 1 回にすると、アセット一式の統一感が保たれ、作り直しも安く済みます。
商品の可視化と 3D プリント
商品ビューアーにはテクスチャをオンのまま使い、ラベルやステッチを読めるようにしたいときは texture_quality: detailed を指定します。3D プリントやスカルプトには、テクスチャのスイッチを 2 つともオフにし、auto_size で現実的な大きさのメッシュにしてください。
プロンプトガイドと実践のヒント
きれいな画像から始める
被写体は 1 つ、全体がフレームに収まり、背景は無地。斜め 45 度の画像は真正面よりも奥行きの情報を多く伝えます。JPEG・PNG・WebP の 10 MB まで。
必要なものだけオンにする
有料のオプションはどれも料金に加算されます。テクスチャ、高精細テクスチャや 8K テクスチャ、精細な形状、四角形ポリゴン、ローポリ・トポロジー、パーツ分割です。まず既定設定に face_limit を付けて試し、足りない段階だけを強化してください。
2 つのシードで試行錯誤する
seed は形状を、texture_seed はテクスチャを固定します。seed を保ったまま texture_seed を変えると同じ形に新しい表面を試せ、texture_seed を保ったまま形を探ることもできます。
見えない側を確認する
使う前に 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/h3.1/image-to-3d",
"input": {
"generate_parts": false,
"generate_pbr": true,
"generate_texture": true,
"geometry_quality": "standard",
"image_url": "https://example.com/reference.png",
"low_poly": 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 リファレンスを参照してください。










