# Hunyuan 3D 3.1

> Tencent's flagship 3D generation — create high-polygon textured 3D models from a text prompt OR an image, with optional PBR materials.

- **Provider**: replicate
- **Model ID**: tencent/hunyuan-3d-3.1
- **Category**: 3d_generation
- **Credits**: 1160 per request
- **Pricing Type**: fixed

## API Endpoint

Base URL: https://api.core.today/v1

### Create Prediction
POST /predictions

### Get Status
GET /predictions/{job_id}

### Cancel
DELETE /predictions/{job_id}

## Authentication

Header: `X-API-Key: YOUR_API_KEY`

## Input Parameters

- `prompt` (string, optional): Text description of the 3D model to generate. Either prompt OR image must be provided, but not both. Supports up to 1024 characters.
- `face_count` (integer, optional): Number of faces (polygons) in the generated 3D model. (Default: `500000`; Range: min: 40000, max: 1500000)
- `generate_type` (string, optional): Type of 3D generation. 'Normal' generates textured model, 'Geometry' generates white model without textures (EnablePBR has no effect). (Default: `Normal`; Options: `Normal`, `Geometry`)
- `image` (string, optional): Input image to convert to 3D. Either prompt OR image must be provided, but not both. Recommendations: simple background, no text, single object, object occupies >50% of frame. Supported formats: jpg, png, jpeg, webp. Resolution: 128-5000px per side, max 6MB.
- `enable_pbr` (boolean, optional): Enable PBR (Physically Based Rendering) material generation. (Default: `False`)

## Example Request

```json
{
  "model": "tencent/hunyuan-3d-3.1",
  "input": {
    "enable_pbr": false,
    "generate_type": "Normal",
    "face_count": 500000,
    "prompt": "An elegant and opulent 3D chair shaped like an avocado, the outer shell forming a deep green velvet seat, the pit replaced with a polished golden cushion, luxurious materials, ornate carved gold trim, subtle botanical motifs, rich emerald and gold color palette, dramatic studio lighting, ultra-detailed textures, photorealistic 3D render, high-end interior design style, soft shadows, 4K, centered on a dark neutral background"
  }
}
```

## Response Format

```json
{
  "job_id": "abc123",
  "status": "pending",
  "provider": "replicate",
  "model": "black-forest-labs/flux-schnell",
  "created_at": "2026-01-01T00:00:00Z",
  "result": null,
  "error": null
}
```

Status values: `pending`, `processing`, `completed`, `failed`, `cancelled`

## Usage Flow

1. POST /predictions with model and input → receive job_id
2. Poll GET /predictions/{job_id} until status is `completed` or `failed`
3. Result contains output URL(s) or data

## Output Type

url

## Tags

3d-generation, text-to-3d, image-to-3d, pbr, hunyuan, tencent

## Documentation

https://replicate.com/tencent/hunyuan-3d-3.1