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

Hunyuan 3D 3.1 Pro Image to 3D

tencent/hunyuan-3d/3.1/pro/image-to-3d

Hunyuan 3d 3.1 Pro by Tencent - convert 2D images into 3D models with AI. Generate textured 3D assets from single photos for games, AR/VR, e-commerce, and digital content creation.

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

Try the model

Playground

Open playground
Input

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

Front view image URL. Resolution: 128-5000px, max 8MB, formats: JPG/PNG/WEBP. Tips: simple background, single object, object >50% of frame.

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

Optional top view image URL for multi-view reconstruction.

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

Optional back view image URL for multi-view reconstruction.
Generate PBR materials (metallic, roughness, normal). Ignored for Geometry output.
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 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.

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

Optional bottom view image URL for multi-view reconstruction.
Normal: textured model. Geometry: geometry-only white model. Allowed values: Normal, Geometry.

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

Optional left-front view image URL for multi-view reconstruction.

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

Optional right-front 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.1/pro/image-to-3d
Execution
async
Base URL
https://api.sandbase.ai
API
Unified Run API
Endpoint
/v1/run

API README

Hunyuan 3D 3.1 Pro Image to 3D

Hunyuan 3D 3.1 Pro turns an image (plus up to six extra views) into a high-detail textured or geometry-only 3D model.

Fields

FieldTypeDefaultNotes
imageimage URL, required—Front view. JPEG, PNG, or WebP URL.
top_imageimage URL—Optional extra view.
back_imageimage URL—Optional extra view.
enable_pbrbooleanfalsePBR materials.
face_countinteger 40000–1500000—Target face count.
left_imageimage URL—Optional extra view.
right_imageimage URL—Optional extra view.
bottom_imageimage URL—Optional extra view.
generate_typeNormal / GeometryNormalNormal textured, LowPoly, or Geometry (untextured).
left_front_imageimage URL—Optional extra view.
right_front_imageimage URL—Optional extra view.

Billing

$0.375 per model; PBR, a custom face count, and extra views each add $0.15.

RequestPrice
Default$0.375
With PBR$0.525
With custom face count$0.525

Failed runs are not charged.

Also on SandBase

Other Hunyuan 3D endpoints: tencent/hunyuan-3d/3.1/pro/text-to-3d, tencent/hunyuan-3d/3.0/image-to-3d.

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.1/pro/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.1/pro/image-to-3d",
  "image": "https://static.sandbase.ai/examples/tencent/hunyuan-3d/3.1/pro/image-to-3d/input_image_0.png",
  "enable_pbr": false,
  "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 / runJan 27, 2026
TencentImage$0.45 / runJan 28, 2026
TencentImage$0.38 / runJan 27, 2026
TencentImage$0.63 / runDec 16, 2025
TencentImage$0.10 / runSep 28, 2025

Questions

FAQ

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

Create a SandBase API key, then send requests with the model ID "tencent/hunyuan-3d/3.1/pro/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.1 Pro Image to 3D and the other models in the catalog; you do not need to sign up with Tencent separately.