Hyper3d Lowpoly Image To 3d
This page lists parameters from the ModelFold model catalog.
Overview
| Field | Value |
|---|---|
| Model ID | hyper3d-lowpoly-image-to-3d |
| Family slug | hyper3d-lowpoly-image-to-3d |
| Modality | Image Generation (image) |
| Endpoint | POST /v1/images/generations |
Request parameters
modelstringRequiredUse
hyper3d-lowpoly-image-to-3d.mesh_modestringOptionalPolygon type. Quad uses quadrilaterals, Raw uses triangles, and NGon uses polygons.
texture_modestringOptionalTexture detail. Higher levels add detail but take longer. extreme-high gives 6K textures, or 12K with High resolution. legacy uses the older texture pipeline.
face_countintegerOptionalTarget number of faces in the low-poly mesh.
resolutionstringOptionalTexture resolution. Basic gives 2K textures and High gives 4K textures.
materialstringOptionalTexture material. None returns geometry without textures.
image_labelsarray<string>OptionalOptional 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.
promptstringOptionalOptional description of details the images do not show clearly, such as surface materials.
image_urlsarray<string>RequiredOne to five images of the object, used for both the mesh and the textures.
geometry_file_formatstringOptionalOutput format. GLB, USDZ, and FBX embed textures in the file.
uhd_texturebooleanOptionalDouble the texture resolution to sharpen fine detail. Has no effect with extreme-high. Turn it off if artifacts appear.
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}'