Tripo H3.1 API：料金・パラメーター・コード

Name: Tripo H3.1 API
SKU: tripo/h3.1/image-to-3d
Price: 0.432 USD
Availability: InStock

Tripo H3.1 について

製品写真1枚から形も色も正確な3Dモデル。

POST /jobs/createTask でモデル名に tripo/h3.1/image-to-3d を指定すれば呼び出せます。$0.432から。

はじめに

Tripo H3.1 は、Tripo AI が 2026 年 3 月に発表した、本番運用向けアセットのための画像→3D モデルです。以前の H シリーズと比べて、より鋭い形状、入力画像へのより正確な整合、より高品質なテクスチャを備えます。画像 1 枚（image_url）を送ると、バイナリ glTF ファイル（.glb）が 1 つ返ります。単一のスイッチで変換するツールと違い、パイプラインの各段階を操作できます。メッシュにテクスチャを付けるか、PBR マップ、HD テクスチャ、詳細なジオメトリ、四角形トポロジー、目標の面数、実寸スケーリング、最終的な向き、2 つの独立した seed を設定できます。プロンプトはありません。

主な特長

画像に沿った形状

ブーツのテストでは、写真が正面しか写していなくても、モデルは写真の比率を保ち、かかとのループ、靴紐のフック、トレッドを正しい側に配置しました。テクスチャを付けた結果では、使い込まれた革、赤い靴紐、ステッチがメッシュに正しく乗りました。

切り替え・アップグレードできるテクスチャ

テクスチャは既定で有効で、PBR 一式で出力されます。既定設定の私たちのファイルには、1 つのマテリアルに 2048 ピクセルのベースカラーマップ、メタルラフネスマップ、ノーマルマップが含まれていました。

トポロジーとサイズを自分で管理

face_limit は面数を 1,000〜2,000,000 の範囲で制限します。quad_mesh はモデリングツールで編集しやすい四角形ポリゴンに切り替えます。geometry_quality: detailed は細かい表面ディテールにより多くの処理を割きます。auto_size はメッシュを実寸に合わせてスケールし、model_orientation: align_image は画像と一致するように向きを揃えます。

私たちの計測

既定の設定で、革ブーツの正面図（1024×1024）は 167 秒で、45.8 MB の GLB、1,471,382 三角形、テクスチャ 3 枚として返されました。この密度が、ブラウザに表示するものには face_limit を設定すべき理由です。

リクエストパラメーター

パラメーター	必須	説明
`auto_size`	いいえ	メッシュを推定される実寸に合わせて拡大縮小します。既定ではオフ。デフォルト: false
`face_limit`	いいえ	目標の面数（1,000〜2,000,000）。空欄ならモデルが決めます（100 万面を超えることもあります）。料金は変わりません。 ≥ 1000 · ≤ 2000000
`generate_pbr`	いいえ	PBR マテリアルマップ（メタルラフネスと法線）を追加します。既定でオンで、テクスチャも有効になります。デフォルト: true
`generate_texture`	いいえ	メッシュにテクスチャを描画します。既定でオン。オフにしても、generate_pbr もオフの場合にのみテクスチャが外れます。デフォルト: true
`geometry_quality`	いいえ	形状の細かさ：standard（既定）または detailed。detailed は表面のより細かいディテールを作り、料金が高くなります。 standard · detailed · デフォルト: standard
`image_url`	はい	出発点になる画像。
`model_orientation`	いいえ	default は標準の向きを保ちます。align_image は画像に合わせてモデルを回転します。 default · align_image · デフォルト: default
`quad_mesh`	いいえ	三角形ではなく四角形（quad）のポリゴンで返します。モデリングツールで編集するための機能で、ファイルは GLB ではなく FBX で返ります。既定ではオフで、料金が加算されます。デフォルト: false
`seed`	いいえ	同じ seed と設定で、比較条件をそろえられます。 ≥ 0 · ≤ 2147483647
`texture_alignment`	いいえ	テクスチャを元画像に合わせる（既定）か、生成されたジオメトリに合わせるかを選びます。 original_image · geometry · デフォルト: original_image
`texture_quality`	いいえ	テクスチャの解像度：standard（既定）または detailed。detailed は料金が高く、テクスチャ付きのメッシュにのみ適用されます。 standard · detailed · デフォルト: standard
`texture_seed`	いいえ	テクスチャ工程のシード。seed を固定したままこの値を変えると、同じ形状で別のテクスチャを試せます。 ≥ 0 · ≤ 2147483647

料金

料金は米ドル表示です。API は専用の米ドル残高を使用します。サイトのクレジットは API で使えず、API 残高との相互振替もできません。タスクの受理時に、見積もりの上限額を API 残高から確保します。完了後は実際の使用量で精算し、確保額を超える請求はせず、差額を解放します。タスクが失敗した場合は確保額を解放します。

オプション	USD /回
標準	$0.432

実行前に同じリクエスト本文を POST /jobs/quote に送ると、想定料金と上限額を米ドルで確認できます。見積もりではタスクの実行も課金も行いません。

活用シーン

ゲーム、AR、リアルタイムシーン向けアセット

face_limit をシーンの予算に合わせて設定し、アセットを後で編集する場合は quad_mesh を有効にし、シーンの照明に反応するよう PBR はオンのままにしてください。

商品ビジュアライズと印刷

商品ビューアには、テクスチャをオンにしたまま、ラベルやステッチを読みやすく保つ必要がある場合は texture_quality: detailed を使ってください。3D プリントや彫刻には、両方のテクスチャスイッチをオフにし、auto_size を設定して現実的なスケールでメッシュを得てください。

プロンプトガイドと上級者向けのコツ

きれいな画像から始める

被写体は 1 つ、フレーム内に全体が収まり、背景は無地。4 分の 3 の視点は、正面の平面図より奥行きの情報をモデルに多く伝えます。JPEG、PNG、WebP を 10 MB まで受け付けます。

必要なものだけオンにする

face_limit を付けて既定設定で最初のパスを実行し、不足している段階だけをアップグレードしてください。

2 つの seed で反復する

seed はジオメトリを、texture_seed はテクスチャを固定します。seed を保って texture_seed を変えると、同じ形状で新しい表面を試せます。逆に texture_seed を保てば、形状を探索できます。

見えない側を確認する

使用前にビューアで GLB を開き、全方向に回転させてください。見えない側がおかしい場合は、設定を変えるより、元画像のカメラ角度を変えた方が効果的です。

API クイックスタート

Tripo H3.1 API を 3 ステップで呼び出す

API キーを作成する. PopNow にログインし、API コンソールでキーを作成します。キーは sk-popnow- で始まり、API 呼び出しには専用の米ドル残高を使用します。
リクエストを送る. POST /jobs/createTask に、model を tripo/h3.1/image-to-3d、input をパラメーター表どおりにして送ります。レスポンスですぐにタスク ID が返ります。
結果を受け取る. タスク ID で GET /jobs/recordInfo をポーリングするか、callBackUrl を渡せば結果がそこへ送られます。タスクが成功したら出力リンクからダウンロードします。

# 1. Create the task. Keep the Idempotency-Key if you retry after a network error.
export IDEMPOTENCY_KEY="$(uuidgen)"
curl -X POST https://api.popnow.ai/api/v1/jobs/createTask \
  -H "Authorization: Bearer $POPNOW_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $IDEMPOTENCY_KEY" \
  -d '{
  "model": "tripo/h3.1/image-to-3d",
  "input": {
    "image_url": "https://media.popnow.ai/influencer/examples/marco.webp",
    "generate_texture": true,
    "generate_pbr": true,
    "texture_quality": "standard",
    "geometry_quality": "standard",
    "model_orientation": "default"
  }
}'

# 2. Copy data.taskId from the response, then poll until state is succeeded, failed, canceled or expired.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
  -H "Authorization: Bearer $POPNOW_API_KEY"

プロンプトとリンクはご自身のものに置き換えてください。API タブにレスポンス、ポーリング、コールバックのリファレンスがあります。

Tripo H3.1 API についての質問

Tripo H3.1 API の料金はいくらですか？

Tripo H3.1は$0.432/回です。API は専用の米ドル残高を使用します。サイトのクレジットは API で使えず、API 残高との相互振替もできません。タスクの受理時に、見積もりの上限額を API 残高から確保します。完了後は実際の使用量で精算し、確保額を超える請求はせず、差額を解放します。タスクが失敗した場合は確保額を解放します。

API でのTripo H3.1のモデル名は？

POST /jobs/createTask の model フィールドに画像から3Dは tripo/h3.1/image-to-3d を指定します。

GLB には何が入っていますか？

マテリアルを埋め込んだメッシュが 1 つです。既定設定では、ベースカラー、メタリック／ラフネス、法線の 3 枚のテクスチャが入っていて、すべて 2048 ピクセルでした。generate_texture と generate_pbr をオフにすると素のメッシュになります。

ファイルを小さくするには？

face_limit を指定します。Web ビューアーなら 5 万〜20 万が目安です。空のままだとモデル任せになり、検証では 100 万面を超えました。

結果を再現できますか？

できます。seed で形状の段階を、texture_seed でテクスチャの段階を固定できるので、形はそのままでテクスチャだけ変える、またはその逆ができます。

Tripo H3.1 API の制限は？

アップロードの上限：10 MB。この範囲を超えるリクエストは、課金される前に拒否されます。

コードを書かずにTripo H3.1を試せますか？

API キーなしで、API の米ドル残高を使って Playground から Tripo H3.1 を実行できます。各実行は対応するコードとともに開発者の履歴に記録されます。

Tripo H3.1 についてさらに

試す: Tripo H3.1 のAI画像生成をオンラインで PopNow で Tripo H3.1 を使って画像を作る
ドキュメント: API ドキュメントの Tripo H3.1 モデル ID と入力スキーマ PopNow API クイックスタート：最初のリクエストを送る PopNow API 画像生成ガイド Webhook：ポーリングせずに Tripo H3.1 の結果を受け取る