Hunyuan3D-2 Serverless API

 1# pip install "segmind>=1.1.0"
 2# export SEGMIND_API_KEY="YOUR_API_KEY"
 3import segmind
 4
 5# Async (v2): submit to the queue and block until COMPLETED.
 6# run() returns the final result dict (600s deadline, 1.0s poll by default).
 7result = segmind.run(
 8    "hunyuan-3d-2",
 9    image="https://i.ibb.co/8nbymYTS/hunyuan-image.png",
10    octree_resolution="256",
11    num_inference_steps=30,
12    guidance_scale=5.5,
13    seed=12467,
14    face_count=40000,
15    texture=False,
16    mesh=None,
17)
18print(result["status"])                      # COMPLETED
19print(result.get("output"))                  # model output (e.g. media URL)
20print(result["metrics"]["inference_time"])   # server compute seconds
21
22# --- Or submit + poll manually (track request_id, control the cadence) ---
23from segmind import SegmindClient, InferenceFailed, InferenceTimeout
24
25client = SegmindClient()                      # reads SEGMIND_API_KEY
26payload = {
27    "image": "https://i.ibb.co/8nbymYTS/hunyuan-image.png",
28    "octree_resolution": "256",
29    "num_inference_steps": 30,
30    "guidance_scale": 5.5,
31    "seed": 12467,
32    "face_count": 40000,
33    "texture": False,
34    "mesh": None,
35}
36job = client.submit_async("hunyuan-3d-2", **payload)
37print(job.request_id)                         # available immediately
38try:
39    result = job.wait(timeout=600, interval=1.0)
40except InferenceTimeout as e:
41    print("still running:", e.request_id)
42except InferenceFailed as e:
43    print("failed:", e.detail)