Tripo H3.1 API

關於 Tripo H3.1

一張產品照產出結構準、顏色真的 3D 模型。

在 POST /jobs/createTask 把模型名稱填成 tripo/h3.1/image-to-3d 就能呼叫，US$0.432 起。

簡介

Tripo H3.1 是 Tripo AI 於 2026 年 3 月推出的圖生 3D 模型，面向可直接用於正式製作的資產，相較先前的 H 系列模型，幾何更銳利、與輸入圖片的對齊更準確，貼圖品質也更高。你送出一張圖片（image_url），取回一個二進位 glTF 檔案（.glb）。不同於只有單一開關的轉換工具，流程的每個階段都可以控制：是否為網格加上貼圖、是否加入 PBR 貼圖、高清貼圖、精細幾何、四邊面拓樸、目標面數、實際尺寸縮放、最終朝向，以及兩個獨立的 seed。沒有提示詞。

主要特色

形狀忠於圖片

在我們的靴子測試中，模型保留了照片的比例，並把後跟環、鞋帶掛鉤與鞋底花紋放在正確的一側，儘管照片只拍到正面。帶貼圖的結果把磨損的皮革、紅色鞋帶與車縫線都帶到了網格上。

貼圖可開關、可升級

貼圖預設開啟，並以完整的 PBR 套件輸出。我們的預設設定檔在一個材質中包含 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 個三角面與三張貼圖。面數如此密集，所以任何要在瀏覽器中展示的內容都應設定 face_limit。

請求參數

價格

價格以美元計。API 使用獨立的美元餘額。網站點數不能用於 API，也不能轉入 API 餘額；API 餘額同樣不能轉為網站點數。 任務受理時，從 API 餘額中保留報價的最高金額；完成後按實際用量結算，實際扣款不超過保留金額，並釋放剩餘金額。任務失敗則釋放保留金額。

執行前，將相同請求內容傳送至 POST /jobs/quote，即可查看預估費用與最高費用，單位為美元。報價不會執行任務或扣款。

適用情境

遊戲、AR 與即時場景的資產

把 face_limit 設為場景的預算；若資產之後還要編輯，開啟 quad_mesh；保持 PBR 開啟，讓模型能回應場景光線。

產品視覺化與列印

用於產品檢視器時，保持貼圖開啟，並在標籤或車縫線需要清楚可讀時使用 texture_quality: detailed。用於 3D 列印或雕塑時，關閉兩個貼圖開關，並設定 auto_size，讓網格以真實比例輸出。

提示詞指南與進階技巧

從乾淨的圖片開始

一個主體、完整入框、純色背景。四分之三視角比正面平視圖更能告訴模型深度資訊。可接受 JPEG、PNG 或 WebP，最大 10 MB。

只開啟需要的功能

先用預設設定加上 face_limit 跑一次，再只升級未達標的那個階段。

用兩個 seed 反覆調整

seed 固定幾何，texture_seed 固定貼圖。保持 seed 不變、改 texture_seed，可以在同一形狀上嘗試新的表面；保持 texture_seed 不變，則可以探索不同的形狀。

檢查被遮住的那一面

使用前，先在檢視器中打開 GLB 並完整旋轉一圈。如果看不到的那一面不對，換一個來源圖片的拍攝角度，比調任何設定都有效。

API 快速上手

三步驟呼叫 Tripo H3.1 API

1. 建立 API 金鑰. 登入 PopNow，在 API 主控台建立金鑰。金鑰以 sk-popnow- 開頭，API 呼叫使用獨立的美元餘額。
2. 送出請求. 對 POST /jobs/createTask 送出請求，model 填 tripo/h3.1/image-to-3d，input 依照參數表填寫。回應會立即傳回任務 ID。
3. 取得結果. 用任務 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 常見問題

其他圖片 API

• Seed3D 2.0 API一張圖產出貼圖豐富的 3D 模型，角色公仔尤其好US$0.48 起 /次

更多 Tripo H3.1 相關內容

試用

Tripo H3.1 AI 生成圖片 線上使用在 PopNow 用 Tripo H3.1 生成圖片

文件

API 文件中的 Tripo H3.1 模型名稱與輸入格式PopNow API 快速入門：送出第一個請求PopNow API 圖片生成指南Webhook：不用輪詢也能取得 Tripo H3.1 的結果