Skip to content

Hyper3d Lowpoly Image To 3d ​

This page lists parameters from the ModelFold model catalog.

Overview ​

FieldValue
Model IDhyper3d-lowpoly-image-to-3d
Family slughyper3d-lowpoly-image-to-3d
ModalityImage Generation (image)
EndpointPOST /v1/images/generations

Request parameters ​

modelstringRequired
Use hyper3d-lowpoly-image-to-3d.
mesh_modestringOptional
Polygon type. Quad uses quadrilaterals, Raw uses triangles, and NGon uses polygons.
AllowedQuadRawNGonDefaultQuad
texture_modestringOptional
Texture detail. Higher levels add detail but take longer. extreme-high gives 6K textures, or 12K with High resolution. legacy uses the older texture pipeline.
Allowedextreme-lowlowmediumhighextreme-highlegacyDefaultmedium
face_countintegerOptional
Target number of faces in the low-poly mesh.
Default4000minimum 200maximum 10000
resolutionstringOptional
Texture resolution. Basic gives 2K textures and High gives 4K textures.
AllowedBasicHighDefaultBasic
materialstringOptional
Texture material. None returns geometry without textures.
AllowedPBRShadedHybridAllNoneDefaultShaded
image_labelsarray<string>Optional
Optional viewing direction of each image, in image_urls order: F front, FL front-left, FR front-right, B back, BL back-left, BR back-right, L left, R right, U top, D bottom, ? unknown. Leave empty to label every image unknown.
AllowedFFLFRBBLBRLRUD?maxItems 5
promptstringOptional
Optional description of details the images do not show clearly, such as surface materials.
maxLength 1024
image_urlsarray<string>Required
One to five images of the object, used for both the mesh and the textures.
maxItems 5
geometry_file_formatstringOptional
Output format. GLB, USDZ, and FBX embed textures in the file.
AllowedglbobjstlDefaultglb
uhd_texturebooleanOptional
Double the texture resolution to sharpen fine detail. Has no effect with extreme-high. Turn it off if artifacts appear.
Defaultfalse

Request example ​

bash
export API_BASE="https://modelfold.ai/v1"
export MODELFOLD_API_KEY="mf-..."   # 在控制台 API Key 页面创建
curl -X POST "$API_BASE/images/generations" \
  -H "Authorization: Bearer $MODELFOLD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"hyper3d-lowpoly-image-to-3d","image_urls":["https://example.com/reference.png"],"mesh_mode":"Quad","texture_mode":"medium","face_count":4000,"resolution":"Basic","material":"Shaded","prompt":"A paper boat drifting down a rainy street.","geometry_file_format":"glb","uhd_texture":false}'

ModelFold — one API for all the best AI models.