はじめに
Tripo P1 は Smart Mesh P1.0 とも呼ばれる Tripo AI の画像から 3D を作るモデルです。50~20,000 面を目安に、扱いやすいローポリメッシュを直接生成します。ゲームやモバイルの 3D、小物を作る遊びに向いています。テクスチャは必要に応じて GLB に含められます。
主な機能とハイライト
少ない面でも形を伝えます
オレンジと白の宇宙飛行士のおもちゃは、4,970 三角形でバイザーとバックパックを保ちました。既定設定の実測は 82 秒、2.67 MB の GLB で、UV と 2048 ピクセルのテクスチャ 3 枚を含みます。
自分で仕上げるための白モデルです
3,000 面を指定し、テクスチャと UV をオフにしたブーツは、19 秒で 2,804 三角形、0.07 MB になりました。材質はありませんが、靴ひも、かかと、靴底の溝が見えます。
リクエストパラメーター
| パラメーター | 必須 | 説明 |
|---|---|---|
image_url | はい | P1 では、10 MB 以下の JPEG、PNG、WebP で、一つの物体全体を指定します。 1 文字以上 |
generate_texture | いいえ | P1 では、既定で有効です。P1 では、色のテクスチャをなくすには |
generate_pbr | いいえ | P1 では、既定で有効です。P1 では、 |
texture_quality | いいえ | P1 では、standard が既定です。P1 では、detailed と extreme(8K)は追加料金があり、fast は v3.5 を使って standard と同額になります。 |
texture_version | いいえ | P1 では、既定の v3.0-20250812 または v3.5-20260815 を選びます。P1 では、fast と照明除去には v3.5 を使います。 |
remove_lighting | いいえ | P1 では、既定で有効ですが、v3.5 のみで働きます。P1 では、参考画像に焼き付いた照明を除去します。 デフォルト値: |
face_limit | いいえ | P1 では、50~20,000 面を目標にします。P1 では、省略するとモデルが決めます。 |
image_autofix | いいえ | P1 では、既定で無効です。P1 では、ぼけた画像や低解像度画像を先に補正するため、処理が長くなります。 デフォルト値: |
model_orientation | いいえ | P1 では、default は通常の向き、 |
texture_alignment | いいえ | P1 では、 |
auto_size | いいえ | P1 では、既定で無効です。P1 では、実寸を推定して調整し、テクスチャ出力を必要とします。 デフォルト値: |
uv_unwrap | いいえ | P1 では、既定で有効です。P1 では、オフにすると速く小さくなりますが、後からテクスチャを付けるための UV 座標がなくなります。 デフォルト値: |
seed | いいえ | P1 では、形状段階のシードです。P1 では、一度に一設定を変える比較に使えますが、完全な再現は保証されません。 |
texture_seed | いいえ | P1 では、テクスチャ段階の比較用シードです。P1 では、同じ表面が必ず得られるわけではありません。 |
料金
$0.72 / モデル
P1 はモデルの納品ごとに一度課金されます。メッシュの基本料金に、generate_texture または generate_pbr が有効な場合のテクスチャ料金が加わります。detailed と extreme(8K)はそれぞれ追加段階があり、fast は standard と同額です。白モデルではテクスチャ品質の追加料金はありません。ほかの P1 設定で料金は変わらず、失敗したリクエストには課金されません。
ユースケース
モバイル向けの小物に使えます
ゲームや AR の面数予算に合わせて調整し、実際に表示する距離から輪郭を確認します。
印刷準備の出発点にできます
材質なしのメッシュを用意し、3D プリント前に壁の厚さ、穴、寸法を別のソフトで確認します。
プロンプトガイドと実践のヒント
物体全体を写します
被写体は一つにして、端に余白を残します。斜めからの写真なら奥行きも伝わります。image_url に 10 MB 以下の JPEG、PNG、WebP を指定します。このタスクに文章の入力欄はありません。
形と仕上げを選びます
face_limit は 50~20,000 で指定するか、省略して P1 に任せます。白モデルには generate_texture と generate_pbr の両方をオフにします。後からテクスチャを付けるなら uv_unwrap を有効にします。
一度に一つだけ変えて比較します
seed と texture_seed は比較を整理するために使います。同じ結果を保証するものではありません。remove_lighting は v3.5-20260815 のみ、auto_size はテクスチャ出力時に使えます。背面と底面も確認します。
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/p1/image-to-3d",
"input": {
"generate_pbr": true,
"generate_texture": true,
"image_url": "https://example.com/reference.png",
"model_orientation": "default",
"texture_alignment": "original_image",
"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 リファレンスを参照してください。







