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

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

Hunyuan 3D v3.1 Rapid Image to 3D turns one reference image into a 3D asset with geometry and PBR material controls. Use a clear view of the object to guide its shape, then inspect a white model or textured result.

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
OutputModel ready
Loading 3D preview…
Current cost: 36 credits
Continue using

Hunyuan 3D v3.1 Rapid Image to 3D

Hunyuan 3D v3.1 Rapid Image to 3D is a Tencent model that generates 3D objects from a single reference image. The image guides the object appearance, while geometry mode and PBR controls let you choose how to review shape and materials. Use product photos or prop references to prepare assets for visual evaluation, scene planning, and further work in a 3D application.

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

  • Work from a single referenceProvide one object image through a public URL or upload it directly in the playground.

  • Review the shape as a white modelEnable geometry mode to focus the review on the generated object geometry.

  • Prepare textured assetsKeep geometry mode off and enable PBR to request material generation with the model.

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.

enable_geometryOptional

Set true for a geometry-only white model or false for textured generation.

enable_pbrOptional

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

How to Use

  1. Prepare your inputProvide one clear object image in Image Urls.

  2. Choose geometry and materialsChoose Enable Geometry and Enable Pbr for geometry or textured output.

  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.180. PBR in textured mode adds $0.120; geometry mode uses the base rate.

GenerationCostBilling unit
Base generation$0.180 · 36 creditsPer generation
PBR materials+$0.120 · 24 creditsPBR enabled in textured mode

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.
  • Change one input detail at a time to compare generated results.

Output Files

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

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

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

Hunyuan 3D v3.1 Rapid Image to 3D is a Tencent model for generating 3D objects from reference images. Provide one object image through a public URL or upload it directly in the playground. The geometry switch selects white-model output, while PBR settings guide materials in textured mode. You can call it programmatically or try it from the playground above.

Which photo works well with Hunyuan 3D v3.1 Rapid Image to 3D?

Choose a clear image of one object with its main parts visible. Use a simple background and enough space around the silhouette to make the subject easy to distinguish.

How many reference images does Hunyuan 3D v3.1 Rapid Image to 3D use?

Provide exactly one image URL in image_urls. Choose the angle that best shows the object shape and the features you want to guide the generation.

How should I frame a product for Hunyuan 3D v3.1 Rapid Image to 3D?

Keep the full object in frame and make it the dominant subject. Use even lighting to show its shape and surface appearance clearly, including handles, corners, and other characteristic parts.

How do I generate a white model with Hunyuan 3D v3.1 Rapid Image to 3D?

Set enable_geometry to true. The result focuses on geometry for inspecting shape and proportions; this mode takes precedence over the PBR material setting.

How do I generate PBR materials with Hunyuan 3D v3.1 Rapid Image to 3D?

Set enable_geometry to false and enable_pbr to true. Review the generated model alongside its returned texture and material files to assess its surface appearance.

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

Choose Pro Image to 3D when you have additional views of the object or want to set a target face count. Rapid Image to 3D uses one image with geometry and PBR controls.

How can I use Hunyuan 3D v3.1 Rapid Image to 3D for product visualization?

Generate the object from a clear product image, inspect the returned 3D model, and download its files. Review the asset in your scene for scale, silhouette, and material appearance before assembling the product presentation.