Hunyuan3d-2.1 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    "hunyuan3d-2.1",
 9    seed=42,
10    image="https://segmind-resources.s3.amazonaws.com/output/f9e83c41-45aa-4ac0-b126-50e17b2ff935-kangaroo.jpg",
11    steps=30,
12    num_chunks=8000,
13    max_facenum=20000,
14    guidance_scale=7.5,
15    generate_texture=True,
16    octree_resolution=256,
17    remove_background=True,
18)
19print(result["status"])                      # COMPLETED
20print(result.get("output"))                  # model output (e.g. media URL)
21print(result["metrics"]["inference_time"])   # server compute seconds
22
23# --- Or submit + poll manually (track request_id, control the cadence) ---
24from segmind import SegmindClient, InferenceFailed, InferenceTimeout
25
26client = SegmindClient()                      # reads SEGMIND_API_KEY
27payload = {
28    "seed": 42,
29    "image": "https://segmind-resources.s3.amazonaws.com/output/f9e83c41-45aa-4ac0-b126-50e17b2ff935-kangaroo.jpg",
30    "steps": 30,
31    "num_chunks": 8000,
32    "max_facenum": 20000,
33    "guidance_scale": 7.5,
34    "generate_texture": True,
35    "octree_resolution": 256,
36    "remove_background": True,
37}
38job = client.submit_async("hunyuan3d-2.1", **payload)
39print(job.request_id)                         # available immediately
40try:
41    result = job.wait(timeout=600, interval=1.0)
42except InferenceTimeout as e:
43    print("still running:", e.request_id)
44except InferenceFailed as e:
45    print("failed:", e.detail)