Skip to content

Hyper3d Lowpoly Image To 3d ​

本页列出 ModelFold 模型目录中的参数信息。

概览 ​

字段值
模型 IDhyper3d-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.
可选值QuadRawNGon默认Quad
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.
可选值extreme-lowlowmediumhighextreme-highlegacy默认medium
face_countinteger可选
Target number of faces in the low-poly mesh.
默认4000minimum 200maximum 10000
resolutionstring可选
Texture resolution. Basic gives 2K textures and High gives 4K textures.
可选值BasicHigh默认Basic
materialstring可选
Texture material. None returns geometry without textures.
可选值PBRShadedHybridAllNone默认Shaded
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.
可选值FFLFRBBLBRLRUD?maxItems 5
promptstring可选
Optional description of details the images do not show clearly, such as surface materials.
maxLength 1024
image_urlsarray<string>必填
One to five images of the object, used for both the mesh and the textures.
maxItems 5
geometry_file_formatstring可选
Output format. GLB, USDZ, and FBX embed textures in the file.
可选值glbobjstl默认glb
uhd_textureboolean可选
Double the texture resolution to sharpen fine detail. Has no effect with extreme-high. Turn it off if artifacts appear.
默认false

调用示例 ​

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 — 一个 API,接入所有主流 AI 模型。