# Hunyuan 3D 3.1 - Core.Today AI API

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

- **Provider**: Tencent
- **Model ID**: tencent/hunyuan-3d-3.1
- **Category**: Image Generation
- **Credits**: 1160 per generation
- **Speed**: Slow
- **Quality**: Ultra

## Features
- Text-to-3D AND image-to-3D in one model
- Up to 500K-face high-polygon output
- Optional PBR material generation
- Textured or white-geometry output modes

## Use Cases
- Game-ready asset generation
- Product concept 3D drafts
- Film/animation prop modeling
- High-quality AR content

## API Endpoint

Base URL: https://api.core.today/v1
Create Prediction: POST /predictions
Get Status: GET /predictions/{job_id}

## Authentication
Header: X-API-Key: YOUR_API_KEY

## Input Parameters

### Optional
- **prompt**: string - Text description of the 3D model (use prompt OR image, not both)
- **image**: string - Image to convert to 3D — simple backgrounds recommended (prompt OR image)
- **enable_pbr**: boolean (default: false) - Generate PBR (physically based rendering) materials
- **face_count**: integer (default: 500000) - Number of polygons in the generated model
- **generate_type**: string (default: Normal) - 'Normal' textured model, 'Geometry' white model without textures
  Options: Normal, Geometry

## Examples

### Text to 3D Asset
Generate a textured 3D model from a description
```json
{
  "model": "tencent/hunyuan-3d-3.1",
  "input": {
    "prompt": "A cute low-poly cartoon fox sitting, game asset style",
    "generate_type": "Normal",
    "enable_pbr": true
  }
}
```

## Response Format
```json
{
  "job_id": "abc123",
  "status": "pending | processing | completed | failed",
  "result": "URL or data (when completed)"
}
```

## Usage Flow
1. POST /predictions with model and input -> receive job_id
2. GET /predictions/{job_id} -> poll until status is completed or failed
3. Result contains output URL(s)

## Tips
- Provide prompt OR image — not both
- Enable PBR for assets destined for modern game/render engines
- Lower face_count for lightweight web/AR use; keep high for hero assets
- For quick, cheaper image-to-3D drafts, use TRELLIS (100 credits) first

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