Hyper3d Lowpoly Image To 3d
本页列出 ModelFold 模型目录中的参数信息。
概览
| 字段 | 值 |
|---|---|
| 模型 ID | hyper3d-lowpoly-image-to-3d |
| 所属系列 | hyper3d-lowpoly-image-to-3d |
| 模态 | 图像生成 (image) |
| 调用端点 | POST /v1/images/generations |
请求参数
modelstring必填填
hyper3d-lowpoly-image-to-3d。mesh_modestring可选Polygon type. Quad uses quadrilaterals, Raw uses triangles, and NGon uses polygons.
texture_modestring可选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.
face_countinteger可选Target number of faces in the low-poly mesh.
resolutionstring可选Texture resolution. Basic gives 2K textures and High gives 4K textures.
materialstring可选Texture material. None returns geometry without textures.
image_labelsarray<string>可选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.
promptstring可选Optional description of details the images do not show clearly, such as surface materials.
image_urlsarray<string>必填One to five images of the object, used for both the mesh and the textures.
geometry_file_formatstring可选Output format. GLB, USDZ, and FBX embed textures in the file.
uhd_textureboolean可选Double the texture resolution to sharpen fine detail. Has no effect with extreme-high. Turn it off if artifacts appear.
调用示例
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}'