> ## Documentation Index
> Fetch the complete documentation index at: https://docs.gmicloud.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# hunyuan-3d-pro

> API usage guide for hunyuan-3d-pro.

{/* source_model_id: hunyuan-3d-pro */}

{/* source_updated_at: 1782255501 */}

**Model ID**

```bash theme={null}
hunyuan-3d-pro
```

**Calling method:** async

# Hunyuan 3D Pro API Documentation

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:**

```bash theme={null}
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

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

| Parameter       | Type    | Required    | Description                                           |
| :-------------- | :------ | :---------- | :---------------------------------------------------- |
| `prompt`        | string  | Conditional | Text description for 3D generation.                   |
| `image_url`     | string  | Conditional | Reference image URL (mutually exclusive with prompt). |
| `enable_pbr`    | boolean | No          | Enable PBR material generation.                       |
| `face_count`    | integer | No          | Polygon count (40,000 - 1,500,000).                   |
| `generate_type` | string  | No          | Normal, LowPoly, Geometry, or Sketch.                 |

## 5. Example CURL Request

```bash theme={null}
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:**

```bash theme={null}
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.