Hunyuan 3D v3.1 Pro Image to 3D API

hunyuan-3d/v3.1/pro/image-to-3d

Hunyuan 3D v3.1 Pro Image to 3D builds models from a front image with seven optional views, PBR materials, and face count control. Supply matching angles to describe the object from more sides and guide its reconstructed shape.

Input
Required
Image Urls

Drag and drop files, paste from clipboard, or provide a URL. Provide exactly one publicly accessible HTTP(S) image URL.

1/1 files added

Optional
Optional
Optional
Optional
Additional views
Optional
Back Image Url

Drag and drop files, paste from clipboard, or provide a URL. Provide a public HTTP(S) image URL showing the same object from the back view.

Optional
Left Image Url

Drag and drop files, paste from clipboard, or provide a URL. Provide a public HTTP(S) image URL showing the same object from the left view.

Optional
Right Image Url

Drag and drop files, paste from clipboard, or provide a URL. Provide a public HTTP(S) image URL showing the same object from the right view.

Optional
Top Image Url

Drag and drop files, paste from clipboard, or provide a URL. Provide a public HTTP(S) image URL showing the same object from the top view.

Optional
Bottom Image Url

Drag and drop files, paste from clipboard, or provide a URL. Provide a public HTTP(S) image URL showing the same object from the bottom view.

Optional
Left Front Image Url

Drag and drop files, paste from clipboard, or provide a URL. Provide a public HTTP(S) image URL showing the same object from the left front view.

Optional
Right Front Image Url

Drag and drop files, paste from clipboard, or provide a URL. Provide a public HTTP(S) image URL showing the same object from the right front view.

OutputModel ready
Loading 3D preview…
Current cost: 60 credits
Continue using

Examples

Curled armadillo

Curled armadillo

Hunyuan 3D v3.1 Pro Image to 3D

Hunyuan 3D v3.1 Pro Image to 3D is a Tencent model for turning object images into 3D assets. A primary front image can be paired with seven named views to describe the back, sides, top, bottom, and front diagonals. Face count and material controls help prepare the resulting model for product visualization, prop review, and further editing in a 3D application.

Why Choose Hunyuan 3D v3.1 Pro Image to 3D?

  • Describe the object from eight anglesUse one front image and seven named extra views to provide visual information about different sides of the object.

  • Choose the mesh targetSet a target face count between 40000 and 1500000 for the model generation.

  • Review geometry and surfacesChoose Geometry for a white model or Normal with PBR to generate materials alongside the asset.

Generation Parameters

ParameterRequirementWhat it controls
promptOptional

Optionally add a nonblank description of the object.

image_urlsRequired

Provide exactly one publicly accessible HTTP(S) image URL.

generate_typeOptional

Choose Normal for a textured model or Geometry for a geometry-only white model.

NormalGeometry
enable_pbrOptional

Set true to generate PBR materials in textured mode. Geometry mode takes precedence.

face_countOptional

Set an integer target face count from 40000 to 1500000. Default: 500000.

Default500000
back_image_urlOptional

Provide a public HTTP(S) image URL showing the same object from the back view.

left_image_urlOptional

Provide a public HTTP(S) image URL showing the same object from the left view.

right_image_urlOptional

Provide a public HTTP(S) image URL showing the same object from the right view.

top_image_urlOptional

Provide a public HTTP(S) image URL showing the same object from the top view.

bottom_image_urlOptional

Provide a public HTTP(S) image URL showing the same object from the bottom view.

left_front_image_urlOptional

Provide a public HTTP(S) image URL showing the same object from the left front view.

right_front_image_urlOptional

Provide a public HTTP(S) image URL showing the same object from the right front view.

How to Use

  1. Prepare your inputProvide one front image in Image Urls and add matching object views in Additional views.

  2. Choose geometry and materialsSet Generate Type and Face Count, then choose Enable Pbr for materials.

  3. Submit the generationReview the current cost and select Run. Follow the task in the output panel.

  4. Inspect and downloadPreview the returned 3D model and download the model, textures, and companion files.

Pricing

Base generation costs $0.300. Active add-ons are cumulative. Geometry mode uses the base rate plus applicable face-count and multi-view options.

GenerationCostBilling unit
Base generation$0.300 · 60 creditsPer generation
PBR materials+$0.120 · 24 creditsPBR enabled in textured mode
Custom face count+$0.120 · 24 creditsface_count differs from 500000
Multi-view references+$0.120 · 24 creditsOnce when any extra view is supplied

Best Use Cases

  • Prop concept reviewGenerate an object from reference imagery to review its silhouette and main parts.

  • Product visualization preparationInspect the model and materials while preparing a presentation scene in your 3D application.

  • Scene asset editingDownload returned assets for further work on scale, placement, and surface appearance.

Pro Tips

  • Choose a clear object reference with its complete silhouette visible.
  • Use geometry mode to concentrate on shape review.
  • Use textured mode and PBR settings to inspect material direction.
  • Keep framing and lighting consistent across extra views of the same object.

Output Files

  • Use returned label, format, and file_type values to identify model, preview, texture, and material files.

Hunyuan 3D v3.1 Pro Image to 3D API frequently asked questions

What is the Hunyuan 3D v3.1 Pro Image to 3D API?

Hunyuan 3D v3.1 Pro Image to 3D is a Tencent model for generating 3D objects from reference images. Use one front image and seven named extra views to provide visual information about different sides of the object. Face-count and generation-mode controls guide geometry, while PBR settings guide material generation. You can call it programmatically or try it from the playground above.

Which image should lead Hunyuan 3D v3.1 Pro Image to 3D?

Place one front-view image in image_urls. Use a clearly visible, single object with consistent framing so that its silhouette and main parts are easy to distinguish.

How many views can I use with Hunyuan 3D v3.1 Pro Image to 3D?

Provide one primary image plus up to seven named extra views: back, left, right, top, bottom, left_front, and right_front. Each extra view has its own image URL field.

How should I prepare extra views for Hunyuan 3D v3.1 Pro Image to 3D?

Use images of the same object with consistent materials, lighting, and proportions. Assign each image to the field matching its viewing direction, and keep the object framing comparable across views.

What do the diagonal views add to Hunyuan 3D v3.1 Pro Image to 3D?

left_front_image_url and right_front_image_url provide front-diagonal references. Use them to show the transition from the front to each side, such as a handle, corner, or projecting component.

How do I set mesh complexity in Hunyuan 3D v3.1 Pro Image to 3D?

Set face_count to an integer from 40000 to 1500000. The default target is 500000. Review the generated mesh in your 3D application against the needs of the scene.

How do geometry and PBR work in Hunyuan 3D v3.1 Pro Image to 3D?

Choose Normal with enable_pbr: true for textured generation with PBR materials. Choose Geometry for a white model focused on shape; this mode takes precedence over the material setting.

When should I choose Hunyuan 3D v3.1 Pro Image to 3D over Rapid?

Choose Pro Image to 3D for named multi-view references and a configurable face count. Rapid Image to 3D uses one reference image with geometry and PBR controls.