はじめに
Tripo H3.1 Text to 3D は物体の説明文から、通常はテクスチャ付き GLB を作成します。最初に参考画像を生成し、そこからメッシュを作ります。image_seed は最初の画像段階に対応し、形状とテクスチャには別のシードがあります。
主な機能とハイライト
言葉で金属の表情を指定できます
古びた潜水ヘルメットは既定設定で 141 秒、46.9 MB、約 149 万三角形、2048 ピクセルのマップ 3 枚になりました。鋲、緑青、丸い窓が見えます。
構造ごとに確認できます
おもちゃのロボットは 118 秒で 1.48 MB の GLB になり、材質なしの 17 ノード、48,411 三角形を含みます。generate_parts ではテクスチャと四角面の設定は無効です。それ以外では quad_mesh により FBX を出力できます。
リクエストパラメーター
| パラメーター | 必須 | 説明 |
|---|---|---|
prompt | はい | 文章入力では、必須の物体説明を 1,024 文字以内で指定します。文章入力では、全体の形、材質、色、作風、大きさを記載します。 1 文字以上 · 1024 文字以内 |
negative_prompt | いいえ | 文章入力では、不要な台や台座などを、255 文字以内で簡潔に指定します。 255 文字以内 |
generate_texture | いいえ | 文章入力では、既定で有効です。文章入力では、色のテクスチャをなくすには |
generate_pbr | いいえ | 文章入力では、既定で有効です。文章入力では、 |
texture_quality | いいえ | 文章入力では、standard が既定です。文章入力では、detailed と extreme(8K)は追加料金があり、fast は v3.5 を使って standard と同額になります。 |
texture_version | いいえ | 文章入力では、既定の v3.0-20250812 または v3.5-20260815 を選びます。文章入力では、fast と照明除去には v3.5 を使います。 |
remove_lighting | いいえ | 文章入力では、既定で有効ですが、v3.5 のみで働きます。文章入力では、参考画像に焼き付いた照明を除去します。 デフォルト値: |
geometry_quality | いいえ | 文章入力では、standard または detailed を選びます。文章入力では、detailed は形状の細部を増やし、追加料金がかかります。 |
quad_mesh | いいえ | 文章入力では、四角面の FBX を GLB の代わりに出力します。文章入力では、 |
low_poly | いいえ | 文章入力では、手作り風のローポリ処理で追加料金がかかります。文章入力では、 |
generate_parts | いいえ | 文章入力では、材質なしの三角形パーツに分けます。文章入力では、テクスチャと四角面の指定と追加料金を外し、分割用の料金に置き換えます。 デフォルト値: |
face_limit | いいえ | 文章入力では、文章から作るメッシュは 1,000~2,000,000 面を指定できます。文章入力では、 |
auto_size | いいえ | 文章入力では、既定で無効です。文章入力では、実寸を推定して調整し、テクスチャ出力を必要とします。 デフォルト値: |
uv_unwrap | いいえ | 文章入力では、既定で有効です。文章入力では、オフにすると速く小さくなりますが、後からテクスチャを付けるための UV 座標がなくなります。 デフォルト値: |
seed | いいえ | 文章入力では、形状段階のシードです。文章入力では、一度に一設定を変える比較に使えますが、完全な再現は保証されません。 |
image_seed | いいえ | 文章入力では、3D 化前の参考画像段階のシードです。文章入力では、比較に使えますが、完全な再現は保証されません。 |
texture_seed | いいえ | 文章入力では、テクスチャ段階の比較用シードです。文章入力では、同じ表面が必ず得られるわけではありません。 |
料金
$0.288 / モデル
文章入力は H3.1 の画像入力よりメッシュの基本料金が低く、テクスチャ、detailed または 8K、詳細形状、四角面、ローポリの追加体系は共通です。generate_parts ではテクスチャと四角面の追加料金が外れ、パーツ分割の料金に置き換わります。失敗時は課金されません。
ユースケース
写真のない小物を考えられます
ヘルメット、ティーポット、おもちゃを文章で描写し、まず比率、色、材質の方向性を確認します。
編集用の構造を用意できます
分かれたパーツをエディターで確認し、自分で材質を付けられます。印刷前には形状と寸法を確認します。
プロンプトガイドと実践のヒント
最初に物体の形を書きます
全体が見える一つの物体について、形、材質、色、作風、大きさを書きます。prompt は 1,024 文字まで、negative_prompt は短い除外指定を 255 文字まで受け付けます。
複雑な見立ては簡略化されます
キツネの要素は一部だけ表現されています。オレンジ色の釉薬のティーポットは、注ぎ口に尖った耳、鼻、目のある小さなキツネの頭があり、背面には耳や尾のようなオレンジ色の突起があります。丸まって眠るキツネの胴体と、尾を取っ手にした形は実現していません。取っ手は通常の背の高い輪形です。実測では 91 秒で、59,722 三角形、3.38 MB のファイルが得られました。
出力を調整します
face_limit は 1,000~2,000,000 で、low_poly では 20,000 以下が目安です。三つのシードで段階ごとに比較しますが、完全な再現は保証されません。隠れた面や穴も確認します。
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/text-to-3d",
"input": {
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"low_poly": false,
"quad_mesh": false,
"generate_pbr": true,
"generate_parts": false,
"texture_quality": "standard"
}
}'
# 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 リファレンスを参照してください。










