API Free WeekHundreds of APIs are free to call this week.Browse free APIs

Hunyuan 3D 3.0 Image to 3D

tencent/hunyuan-3d/3.0/image-to-3d

Hunyuan 3d V3 is Tencent's image-to-3D AI model. Transform photographs into production-ready 3D meshes with accurate geometry and texture mapping.

Base price
$0.38USD / run
Execution
async
Model type
image
Input fields
8
Production route

Try the model

Playground

Open playground
Input

PNG, JPEG, WebP, or GIF · 20 MiB maximum

URL of image to use while generating the 3D model.
Generate PBR materials (metallic, roughness, normal). Ignored for Geometry output.
Polygon type. Only takes effect when generate_type is LowPoly. Allowed values: triangle, quadrilateral.
Normal: textured model. LowPoly: polygon reduction. Geometry: white model without texture. Allowed values: Normal, LowPoly, Geometry.
400001500000
Target polygon face count (custom face count is billed as an add-on). Range: 40000 to 1500000.

PNG, JPEG, WebP, or GIF · 20 MiB maximum

Optional back view image URL for multi-view reconstruction.

PNG, JPEG, WebP, or GIF · 20 MiB maximum

Optional left view image URL for multi-view reconstruction.

PNG, JPEG, WebP, or GIF · 20 MiB maximum

Optional right view image URL for multi-view reconstruction.
OutputReady

Your output will appear here

Complete the inputs, then click Run.

Model card

Specifications

Pricing

Base price
$0.38 / run

Context & modalities

Input
Schema-defined
Output
image

Capabilities

Chat
Not supported
Vision
Not supported
Reasoning
Not supported
Structured output
Not supported
Function calling
Not supported
Audio input
Not supported

Access

Provider
Tencent
Model ID
tencent/hunyuan-3d/3.0/image-to-3d
Execution
async
API
Unified Run API
Endpoint
/v1/run

API README

Hunyuan 3D 3.0 Image to 3D

Hunyuan 3D 3.0 Image to 3D occupies a clearly bounded position in a image production pipeline under the route tencent/hunyuan-3d/3.0/image-to-3d. It is best evaluated as a named workflow endpoint rather than as a generic substitute for neighboring versions: planners can assign the route to a specific brief, record the chosen revision, and keep approval history tied to one predictable integration surface from intake through delivery.

A practical rollout of Hunyuan 3D 3.0 Image to 3D should begin with source-readiness checks, ownership of the submitted material, an agreed budget, and a written definition of the final v3 deliverable. Before automation is enabled, the acceptance pass should verify that the returned asset opens correctly, fits the intended downstream toolchain, satisfies the project’s review criteria, and can be reproduced from the stored request and route identity tencent/hunyuan-3d/3.0/image-to-3d.

Highlights

  • Distinct output behavior. For Hunyuan 3D 3.0 Image to 3D, for Hunyuan 3D 3.0 Image to 3D, start with one image and add back, left, or right references for reconstruction In Hunyuan 3D 3.0 Image to 3D, this capability is applied through the exact tencent/hunyuan-3d/3.0/image-to-3d workflow with image as a relevant request control; the image control exposes the corresponding choice in this route; the image control exposes the corresponding choice in this route.
  • Creative control. For Hunyuan 3D 3.0 Image to 3D, for Hunyuan 3D 3.0 Image to 3D, select Normal, LowPoly, or Geometry according to the desired asset In Hunyuan 3D 3.0 Image to 3D, this capability is applied through the exact tencent/hunyuan-3d/3.0/image-to-3d workflow with enable pbr as a relevant request control; the enable pbr control exposes the corresponding choice in this route; the enable pbr control exposes the corresponding choice in this route.
  • Workflow fit. For Hunyuan 3D 3.0 Image to 3D, for Hunyuan 3D 3.0 Image to 3D, request between 40,000 and 1,500,000 faces In Hunyuan 3D 3.0 Image to 3D, this capability is applied through the exact tencent/hunyuan-3d/3.0/image-to-3d workflow with face count as a relevant request control; the face count control exposes the corresponding choice in this route; the face count control exposes the corresponding choice in this route.
  • Production detail. For Hunyuan 3D 3.0 Image to 3D, for Hunyuan 3D 3.0 Image to 3D, pBR is available outside Geometry, and polygon choice is specific to LowPoly In Hunyuan 3D 3.0 Image to 3D, this capability is applied through the exact tencent/hunyuan-3d/3.0/image-to-3d workflow with polygon type as a relevant request control; the polygon type control exposes the corresponding choice in this route; the polygon type control exposes the corresponding choice in this route.

Pricing

ConfigurationPrice
Normal$0.375
LowPoly$0.45
Geometry$0.225
Enable PBR+$0.15
Custom face_count+$0.15
Multi-view images (back/left/right)+$0.15

When to Use

ScenarioWhy this model fits
Choose Hunyuan 3D 3.0 Image to 3DUse it when the required deliverable is specifically the image-to-3d result documented for tencent/hunyuan-3d/3.0/image-to-3d.
Match the source materialSelect this route when your inputs naturally map to image, enable_pbr, face_count, polygon_type.
Use its distinguishing capabilityFor Hunyuan 3D 3.0 Image to 3D, start with one image and add back, left, or right references for reconstruction In Hunyuan 3D 3.0 Image to 3D, this capability is applied through the exact tencent/hunyuan-3d/3.0/image-to-3d workflow with image as a relevant request control; the image control exposes the corresponding choice in this route
Plan repeatable productionFor Hunyuan 3D 3.0 Image to 3D, select Normal, LowPoly, or Geometry according to the desired asset In Hunyuan 3D 3.0 Image to 3D, this capability is applied through the exact tencent/hunyuan-3d/3.0/image-to-3d workflow with enable pbr as a relevant request control; the enable pbr control exposes the corresponding choice in this route
Confirm cost and deliveryUse the pricing combinations below and the output contract above when budgeting or automating Hunyuan 3D 3.0 Image to 3D jobs.

Prompt Guide

Build the request around the exact tencent/hunyuan-3d/3.0/image-to-3d schema. Start with required fields, then add only the controls needed for the intended output; keep URLs reachable and enum values exactly as shown in Technical Specs.

{
  "image": "https://static.sandbase.ai/examples/tencent/hunyuan-3d/3.0/image-to-3d/input_image_0.png",
  "enable_pbr": false,
  "face_count": 500000,
  "polygon_type": "triangle"
}

Technical Specs

SpecificationValue
Model IDtencent/hunyuan-3d/3.0/image-to-3d
Execution modeasync
Required inputsimage
Request fieldsimage (string, required); enable_pbr (boolean, optional); face_count (integer, optional, min 40000, max 1500000); polygon_type (string, optional, options: triangle / quadrilateral); generate_type (string, optional, options: Normal / LowPoly / Geometry); back_image_url (string, optional); left_image_url (string, optional); right_image_url (string, optional)
Outputurl (string); content_type (string)

Related Models

Start building

Send your first request

OpenAI-compatible endpoint with unified authentication and usage tracking.

Production API
Unified Run API endpoint
https://api.sandbase.ai/v1/run
Model ID
tencent/hunyuan-3d/3.0/image-to-3d
# The quoted heredoc keeps Unicode and shell metacharacters unchanged.
result=$(curl --fail-with-body --silent \
  -X POST "https://api.sandbase.ai/v1/run" \
  -H "Authorization: Bearer $SANDBASE_API_KEY" \
  -H "Content-Type: application/json" \
  --data-binary @- <<'SANDBASE_JSON'
{
  "model": "tencent/hunyuan-3d/3.0/image-to-3d",
  "image": "https://static.sandbase.ai/examples/tencent/hunyuan-3d/v3/input_image_0.png",
  "enable_pbr": false,
  "face_count": 500000,
  "polygon_type": "triangle",
  "generate_type": "Normal"
}
SANDBASE_JSON
)
run_id=$(printf '%s' "$result" | jq -r .id)
for attempt in $(seq 1 120); do
  status=$(printf '%s' "$result" | jq -r .status)
  case "$status" in completed|failed|timeout) break ;; esac
  sleep 2
  result=$(curl --fail-with-body --silent \
    -H "Authorization: Bearer $SANDBASE_API_KEY" \
    "https://api.sandbase.ai/v1/run/$run_id")
done
status=$(printf '%s' "$result" | jq -r .status)
[ "$status" = completed ] || { echo "Generation ended: $status" >&2; exit 1; }
printf '%s\n' "$result"

Choose your model

Compare models

All image & video models
ModelTypeDefault priceReleased
TencentImage$0.38 / runDec 16, 2025
TencentImage$0.45 / runJan 28, 2026
TencentImage$0.38 / runJan 27, 2026
TencentImage$0.38 / runJan 27, 2026
TencentImage$0.10 / runSep 28, 2025

Questions

FAQ

How do I call Tencent Hunyuan 3D 3.0 Image to 3D through SandBase?

Create a SandBase API key, then send requests with the model ID "tencent/hunyuan-3d/3.0/image-to-3d" to Unified Run API (/v1/run) at https://api.sandbase.ai. The request examples on this page show the exact payload.

Do I need a separate Tencent account?

No. One SandBase API key and balance gives you access to Tencent Hunyuan 3D 3.0 Image to 3D and the other models in the catalog; you do not need to sign up with Tencent separately.