使用ガイド
Tripo H3.1 上手指南:3 つの入力方式、パラメータ、価格の選び方
開発者向け 3D 生成接続の意思決定とコスト制御の実践
このページの内容
Tripo H3.1 にできること、境界はどこか
Tripo H3.1 は 3D 生成モデルであり、HiAPI.ai の統一インターフェースに接続され、1 つの API key で呼び出せます。入力形態は 3 種類をサポートします。自然言語の記述(text-to-3D)、物体の単一画像(image-to-3D)、そして同一物体の 2〜4 枚のマルチビュー画像(multiview-to-3D)です。
出力は固定の成果物の組み合わせです。1 つの GLB モデルファイル + 1 枚のプレビュー画像。追加のマテリアルテクスチャパックも、プロジェクトファイルも、ボーンリグやアニメーションもありません。GLB は汎用フォーマットであり、受け取った後はそのまま Blender、Three.js、Unity、または glTF をサポートする任意のパイプラインに取り込めます。
境界も明確にしておきます。
- これはオブジェクト単位の生成であり、シーン単位の生成ではありません。 椅子の画像を入力すると、椅子が 1 脚得られるのであり、椅子が置かれた部屋が得られるわけではありません。シーンが必要なら複数のモデルを自分で組み合わせてください。
- 「動作」を理解しません。 静的アセットが得意分野です。リグ、スキニング、モーションシーケンスは能力の範囲外です。
- 素材の品質が出力の上限です。 ぼやけた入力、複数物体、複雑な遮蔽のある入力画像は幾何品質を著しく低下させます。これは 3 経路すべてに当てはまります。
- 課金は従量制で、1 回の呼び出しで 1 モデルを生成し、token 単位や秒単位の中間状態はありません。この特性はコスト見積もりに有利です。呼び出し回数がそのまま課金単位になります。
この範囲を理解してこそ、次の選択が意味を持ちます。3 経路は同じものの 3 つの入口ではなく、単価、素材のハードル、適用シーンがそれぞれ異なります。

3 つの入力経路の選び方
経路選択の第一原則は「どれが良い結果を出すか」ではなく、手元にどんな素材があるかです。
テキスト記述しかない → text-to-3D。 コンセプト探索、プレースホルダーアセット、初期プロトタイプに適しています。生成方向を完全に制御できますが、不確実性もすべて引き受けます。モデルが面数や形態を推測する根拠は、あなたの記述語だけです。開始価格帯が最も低く、大量の試行錯誤に向いています。
きれいな製品画像や物体写真が 1 枚ある → image-to-3D。 ほとんどの開発者が実際に通る経路です。物体に正対した背景のきれいな画像 1 枚は、テキスト記述 1 段落よりもはるかに情報量が多く、幾何の再現度が明らかに安定します。素材のハードルも高くありません。撮影して背景を切り抜くだけです。
異なる角度の画像が 2〜4 枚ある → multiview-to-3D。 すでに多角度の素材(たとえば製品撮影スタジオの標準 4 面図、あるいは既存 3D アセットからレンダリングしたターンテーブルフレーム)がある場合、マルチビューは精度上限が最も高い段階です。単一画像生成における「背面を推測する」という構造的な問題を解決します。
注目すべき価格の事実として、image-to-3D と multiview-to-3D は同価格で、text-to-3D がより安価です。したがって素材が揃っている前提では、マルチビューに追加の割増はありません。素材があればマルチビューを使えばよく、単一画像に戻る理由はありません。
意思決定は一文に簡略化できます。素材がマルチビュー分あればマルチビュー、良い画像が 1 枚あれば image-to-3D、何もなければ text-to-3D です。
入力パラメータと素材準備の要点
3 経路の入力フィールドはそれぞれ異なり、混用すると直接失敗します。
text-to-3D(モデルページ)は自然言語の記述を受け取ります。prompt をうまく書く要点は具体化です。物体の種類、材質の傾向、形態の特徴を書くほうが、形容詞を積み重ねるより効果的です。
image-to-3D(モデルページ)は image_url を使用し、HTTPS の画像 1 枚を指定します。素材の要件は次のとおりです。
- 単一の物体とし、複数物体を同じ画面に収めない
- 背景はきれいにし、被写体と同色の雑然とした環境を避ける
- 物体の被写体をできるだけ画面いっぱいに写す
- URL は公開アクセス可能(HTTPS)であること。認証が必要なプライベートアドレスを渡さない
multiview-to-3D(モデルページ)は image_urls を使用し、同一物体の 2〜4 枚の画像を、順序は前・左・後・右に固定します。順序の誤りは最もよくある失敗要因の 1 つです。モデルは位置に応じて視点を仮定するため、画像を誤った位置に置くことは誤った幾何制約を与えることになります。
素材準備には 2 つの一般的な推奨があります。第一に、マルチビューの各画像はできるだけ同一の照明とスケールに揃えてください。異なる来源の写真を混用すると、モデルが接合部で曖昧さを生じます。第二に、画像解像度は極端に大きくする必要はなく、鮮明で被写体が明確であることが画素数より重要です。
パラメータが不正なリクエスト(フィールド欠落、URL 形式エラー、ビュー数の範囲外)は直ちに拒否され、課金されません。この点は次の節のトラブルシューティング一覧でも活用します。
face_limit と幾何品質:モデルの複雑さの制御
face_limit は出力面数を制御する中核パラメータで、値の範囲は 1000〜1,500,000 です。geometry_quality を detailed に設定すると上限は 2,000,000 に緩和されます。
重要な設計は、このパラメータは省略できることです。省略時はモデルが適応的に面数を決定し、通常は物体の複雑さに見合った妥当な値を出します。手動指定が必要なのは、下流の面数予算を明確に把握している場合だけです。
- モバイルまたは Web のリアルタイムレンダリング:低めの段階で、数万面以内に抑える
- ゲーム内の中景アセット:中程度の段階
- 映像級またはオフラインレンダリング:上限に近づけ、詳細な幾何と組み合わせる
geometry_quality には 2 つの値があります。standard(標準幾何、デフォルト)と detailed(詳細幾何)です。detailed はより高い幾何ディテールとより高い面数上限をもたらしますが、追加料金が発生するオプションであり、3 経路すべてで同様です。判断基準は直接的です。そのアセットが近距離で見られる場合、またはディテール自体が売りである場合にのみ有効にする価値があります。遠景やプレースホルダーアセットで detailed を有効にするのは純粋な無駄です。
両者を組み合わせる実践的な推奨は、まずデフォルト設定(face_limit を省略、geometry_quality は standard)で 1 版実行して効果を確認し、その後具体的なアセットに合わせてパラメータを調整することです。最初からパラメータを上限まで引き上げると、余計なコストがかかるうえ、必ずしもより良い結果が得られるわけではありません。
価格構造の分解:どの段階にお金がかかるか
Tripo H3.1 は従量課金で、1 回の呼び出しでモデル + プレビュー画像を生成します。価格は 4 つの変数で決まります。入力経路、Texture スイッチ、PBR スイッチ、幾何品質。この構造を理解したうえで、以下の完全な掲載価格と照らし合わせて段階を選んでください。
現在のテスト環境の掲載価格は次のとおりです。1 回、モデル 1 つあたり、単位は USD。
text-to-3D(tripo-h3.1/text-to-3d)
| 仕様 | 標準テクスチャ | 高精細テクスチャ |
|---|---|---|
| PBR オフ · Texture オフ | $0.150 | $0.150 |
| PBR オフ · Texture オン | $0.290 | $0.430 |
| PBR オン | $0.290 | $0.430 |
image-to-3D(tripo-h3.1/image-to-3d)と multiview-to-3D(tripo-h3.1/multiview-to-3d)は同価格
| 仕様 | 標準テクスチャ | 高精細テクスチャ |
|---|---|---|
| PBR オフ · Texture オフ | $0.290 | $0.290 |
| PBR オフ · Texture オン | $0.430 | $0.580 |
| PBR オン | $0.430 | $0.580 |
上記の各段階で詳細幾何を選択した場合、別途 $0.290 が加算されます。
第一層:入力経路。 text-to-3D の開始段階が最も低く、image-to-3D と multiview-to-3D は同価格で、text-to-3D より高いです。これは直感に沿います。image-to-3D と multiview-to-3D はより多くの情報を入力するため、モデルが行う作業も多くなります。
第二層:Texture と PBR のスイッチ、これが価格の主な増幅要因です。 両方のスイッチをオフにすると基礎段階です。Texture をオンにすると単価が一段上がります。PBR をオンにすると同じ段階かより高い段階になります。言い換えれば、「純粋な幾何」から「テクスチャ付き PBR 付き」の完全なアセットへ移ると、単価は 2 倍以上になる可能性があります。 これは表全体で最大の価格変数であり、入力経路の差よりもはるかに顕著です。
第三層:テクスチャの精細度。 テクスチャがオンの前提で、標準テクスチャと高精細テクスチャは 2 つの価格です。高精細テクスチャは text-to-3D 経路での割増が特に顕著です。
第四層:幾何品質。 detailed 詳細幾何を選択すると、上記価格に追加で加算され、その加算額は 3 経路で同じです。
これらからいくつかの価格判断が得られます。
- 下流で幾何体のみが必要な場合(たとえば衝突体を作る、後で手動テクスチャを貼るベースモデルを作る)、Texture と PBR をオフにすれば単価は直ちに最低段階に戻ります。
- プロトタイプ検証だけを行う場合、text-to-3D + 全スイッチオフが最も安い組み合わせです。
- 本当に高価なのは「高精細テクスチャ + PBR + 詳細幾何」の 3 点セットをすべてオンにした完全納品であり、これはアセットを正式リリースすると確認してから行う決定であるべきです。

典型的なシーンの推奨構成とコスト見積もり
構造を具体的な組み合わせに落とし込みます。以下の方案はすべて 1 回の呼び出し単位で、実際のコストは呼び出し回数に応じて累積します。
プロトタイプとコンセプト探索
text-to-3D、Texture オフ、PBR オフ、geometry_quality は standard、face_limit は省略。これはモデル全体の最低段階で、一度に十数方向を生成して素早く選別するのに適しています。選別を通った後に、候補方案に対してテクスチャ付きの版をもう一度実行します。
EC / 製品展示アセット
製品画像があれば image-to-3D、標準 4 面図の素材があれば multiview-to-3D を使います。Texture オン、PBR オン(PBR は材質感の表現に実際の価値があり、展示シーンではこのコストをかける価値があります)、テクスチャは標準段階、幾何は standard。商品がクローズアップで見られる場合は、高精細テクスチャへのアップグレードを検討します。
ゲーム / リアルタイムレンダリングアセット
image-to-3D または multiview-to-3D、Texture オン、PBR はレンダリングパイプライン次第(パイプラインが PBR をサポートするならオン)。face_limit は対象プラットフォームに応じて手動で設定し、適応に任せないでください。幾何品質はデフォルトの standard。リアルタイムレンダリングでは detailed の利点は通常現れません。
幾何ベースモデルのみ
任意の経路、Texture と PBR は全オフ、幾何品質は必要に応じて選択。これはコストを構造上の最低に抑える方法で、後続のテクスチャはアートの工程に任せます。
一般的なコスト削減のリズムは、まず低価格帯で方向性を検証し、確認したアセットに対して高価格帯で再実行することです。すべての試行錯誤に全額を払わないでください。
接続時のトラブルシューティングと検証チェックリスト
接続期の最も重要な仕組みは、パラメータが不正なリクエストは直ちに拒否され、課金されないことです。これは開発段階で大胆に試行錯誤できることを意味します。フィールド名の綴り間違い、URL 形式の不正、ビュー数の範囲外は、請求ではなくエラーが代償です。この特性を活かし、まずパラメータ検証を通してから効果を論じてください。
リリース前の検証チェックリスト:
- URL のアクセス性:匿名リクエストで
image_url/image_urlsを一度テストし、HTTPS で認証不要でアクセスできることを確認します。ローカルで開けても、公網から取得できるとは限りません。 - マルチビューの順序:前・左・後・右であるかを 1 枚ずつ確認します。これは最も頻度の高いサイレントエラーです。リクエストは成功しますが結果が悪化し、原因特定が難しくなります。
- ビュー数:マルチビューは厳密に 2〜4 枚に保ちます。
face_limitの境界:手動指定する場合は 1000〜1,500,000 の範囲内であることを確認します。detailedを使う場合にのみ上限が 2,000,000 に緩和されます。範囲外は拒否されます。- スイッチと期待の一致:Texture / PBR スイッチが期待する価格段階と一致しているか確認します。デフォルト設定と最終設定の間で「オフにしたつもりが実はオンだった」というずれが最も起きやすいです。
- 成果物の検証:各呼び出しで GLB 1 つとプレビュー画像 1 枚を受け取るはずです。接続層で両方の存在を検証してから下流に進みます。
- 失敗時のリトライ戦略:「パラメータ拒否」(パラメータを修正し、リトライしない)と「ネットワーク/サービス異常」(リトライ可能)を区別し、必ず失敗するリクエストに繰り返し課金呼び出しを行わないようにします。
このチェックリストを一通り確認すれば、接続期のほとんどの問題は初回リリース前に解決できます。
3 つの入力経路は 3 つの素材状況に対応し、2 つのスイッチが価格の桁を決め、face_limit は明確な予算がある場合にのみ触れる必要があります。この順序で意思決定すれば、Tripo H3.1 の接続はかなり直接的です。モデルページから最初の呼び出しを実行するだけです。
関連記事
すべての記事を見る →-
使用ガイド
HiAPI API で qwen-image-2.1-turbo を使って EC 商品画像を生成する
開発者向けの素早いカタログビジュアルワークフロー:透過 PNG 出力と実行可能な API リクエスト
-
使用ガイド
HiAPI API で topaz-upscale/video を使用する:ショート動画の画質向上ワークフロー
フレーム補間、強化設定、そして動作する縦型動画 HiAPI リクエスト
-
使用ガイド
HiAPI API で gpt-image-2.5-sunburst/image-to-image を使い、EC 商品画像を生成する
参照画像、背景置換、ライフスタイルシーン、そして動作する HiAPI リクエスト