Hunyuan3d-2.1 Serverless API

Transform 2D images into photorealistic, high-fidelity 3D assets effortlessly.

~150.14s
~$0.158
PlaygroundAPI
Pricing
 1import requests
 2import json
 3
 4url = "https://api.segmind.com/v1/hunyuan3d-2.1"
 5headers = {
 6    "x-api-key": "YOUR_API_KEY",
 7    "Content-Type": "application/json"
 8}
 9
10data = {
11    "seed": 42,
12    "image": "https://segmind-resources.s3.amazonaws.com/output/f9e83c41-45aa-4ac0-b126-50e17b2ff935-kangaroo.jpg",
13    "steps": 30,
14    "num_chunks": 8000,
15    "max_facenum": 20000,
16    "guidance_scale": 7.5,
17    "generate_texture": true,
18    "octree_resolution": 256,
19    "remove_background": true
20}
21
22response = requests.post(url, headers=headers, json=data)
23
24if response.status_code == 200:
25    result = response.json()
26    print(json.dumps(result, indent=2))
27else:
28    print(f"Error: {response.status_code}")
29    print(response.text)

API Endpoint

POSThttps://api.segmind.com/v1/hunyuan3d-2.1

Parameters

generate_textureoptional
boolean

Enables texture generation. Set true for detailed texture.

Default: true
guidance_scaleoptional
number

Adjusts guidance scale. 7.5 for balanced generation, 10 for creative.

Default: 7.5Range: 1 - 20
imageoptional
string (uri)

URL of the input image for 3D conversion. Use clear images for best results.

Default: "https://segmind-resources.s3.amazonaws.com/output/f9e83c41-45aa-4ac0-b126-50e17b2ff935-kangaroo.jpg"
max_facenumoptional
integer

Controls max mesh faces. 15000 for smaller models, 20000 for larger.

Default: 20000Range: 10000 - 200000
num_chunksoptional
integer

Sets mesh generation chunk count. 5000 for speed, 8000 for detail.

Default: 8000Range: 1000 - 200000
octree_resolutionoptional
integer

Choose octree resolution. 256 for balance, 512 for detailed meshes.

Default: 256
Allowed values :
196256384512
remove_backgroundoptional
boolean

Option to remove image background. Enable for isolated objects.

Default: true
seedoptional
integer

Sets the random seed

Default: 42
stepsoptional
integer

Defines inference steps. Lower for speed, higher for quality.

Default: 30Range: 5 - 50

Response Type

Returns: 3D Model

Common Error Codes

The API returns standard HTTP status codes. Detailed error messages are provided in the response body.

400

Bad Request

Invalid parameters or request format

401

Unauthorized

Missing or invalid API key

403

Forbidden

Insufficient permissions

404

Not Found

Model or endpoint not found

406

Insufficient Credits

Not enough credits to process request

429

Rate Limited

Too many requests

500

Server Error

Internal server error

502

Bad Gateway

Service temporarily unavailable

504

Timeout

Request timed out