Skip to main content
使用 Tripo3D 及其他供應商,透過文字或圖片生成 3D 模型。這是一個非同步 API。建立回應會返回任務身分,並且在可用時返回優先使用的 poll_url 公開 3D operation 會從請求形狀推導:僅包含 prompt 的請求解析為 text-to-3d,帶 imageimage_url 的請求解析為 image-to-3d。此 endpoint 不公開 operation 請求欄位;不要傳送舊的 3d-generation 值。

請求主體

string
預設值:"tripo-h3.1"
要使用的模型,例如 tripo-h3.1tripo-p1.0。依賴某個輸入類型或輸出格式前,請先查詢 GET /v1/models?recommended_for=3d
string
必填
要生成的 3D 模型文字描述。
string
用於圖片轉 3D 生成的 Base64 編碼圖片。
string
用於圖片轉 3D 生成的圖片 URL。
string
預設值:"glb"
輸出格式:glbfbxobjusdz
string
預設值:"standard"
品質等級:draftstandardhigh
string
模型的風格預設。
integer
用於可重現生成的種子值。
string
終端用戶的唯一識別碼。

回應 (Response)

string
用於輪詢狀態的任務 ID。
string
適配器返回時的非同步任務 ID 別名。
string
可用時返回的優先輪詢 URL。
string
任務狀態:pendingprocessingcompletedfailed
integer
任務建立的 Unix 時間戳記。