Skip to main content
Hunyuan 3D Pro is Tencent’s intelligent 3D content generation model. It creates high-quality 3D models from text descriptions or reference images with support for PBR materials.

​
1. API Endpoint & Authentication

Base URL: https://console.gmicloud.ai Endpoint: POST /api/v1/ie/requestqueue/apikey/requests Header: sh 
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

​
Submit Video Generation Request

​
Endpoint

sh 
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

Provide a text prompt describing the 3D object you want to create.

​
Image-to-3D

Provide a reference image URL. Best results with:
  • Simple/solid background
  • Single object
  • Object occupies >50% of frame
  • No text overlays

​
4. Parameter Reference

ParameterTypeRequiredDescription
promptstringConditionalText description for 3D generation.
image_urlstringConditionalReference image URL (mutually exclusive with prompt).
enable_pbrbooleanNoEnable PBR material generation.
face_countintegerNoPolygon count (40,000 - 1,500,000).
generate_typestringNoNormal, LowPoly, Geometry, or Sketch.

​
5. Example CURL Request

sh 
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

Endpoint: sh 
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.