hunyuan-3d-pro

​

Hunyuan 3D Pro API Documentation

​

1. API Endpoint & Authentication

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

​

Submit Video Generation Request

​

Endpoint

POST /api/v1/ie/requestqueue/apikey/requests

​

2. Model Specifications

• Pricing: $0.375 per 3D model
• Concurrent Tasks: Up to 3 simultaneous jobs
• Output Format: 3D model file
• Face Count Range: 40,000 - 1,500,000 polygons

​

3. Generation Modes

​

Text-to-3D

​

Image-to-3D

• Simple/solid background
• Single object
• Object occupies >50% of frame
• No text overlays

​

4. Parameter Reference

​

5. Example CURL Request

curl -X POST "https://console.gmicloud.ai/api/v1/ie/requestqueue/apikey/requests" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "hunyuan-3d-pro",
    "payload": {
      "prompt": "A cute cartoon cat",
      "enable_pbr": true,
      "face_count": 500000
    }
  }'

​

6. Checking Request Status

GET /api/v1/ie/requestqueue/apikey/requests/{request_id}

• queued: Waiting in line.
• processing: Generating 3D model.
• success: Completed. Find URL in outcome.media_urls.
• failed: Request failed.