TencentSlowUltra

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 (physically based rendering) materials.

1160 credits

per generation

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

Run it right now

Test this model instantly in the Console Playground — no code required

Use with AI Assistant

Copy usage instructions for Claude, ChatGPT, or other AI

llms.txtllms.txt ↗

Quick Start

curl -X POST "https://api.core.today/v1/predictions" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: cdt_your_api_key" \
  -d '{
  "model": "tencent/hunyuan-3d-3.1",
  "input": {
    "prompt": "A cute low-poly cartoon fox sitting, game asset style",
    "generate_type": "Normal",
    "enable_pbr": true
  }
}'

Parameters

Parameter	Type	Required	Default	Description
`prompt`	string	No	-	Text description of the 3D model (use prompt OR image, not both)
`image`	string	No	-	Image to convert to 3D — simple backgrounds recommended (prompt OR image)
`enable_pbr`	boolean	No	false	Generate PBR (physically based rendering) materials
`face_count`	integer	No	500000	Number of polygons in the generated model
`generate_type`	string	No	Normal	'Normal' textured model, 'Geometry' white model without textures NormalGeometry

How to Provide File Input

There are 3 ways to provide files for the image parameter:

Recommended

Direct Upload (Multipart)

Attach files directly to POST /v1/predictions/upload. No separate upload step needed.

curl -X POST "https://api.core.today/v1/predictions/upload" \
  -H "X-API-Key: cdt_your_api_key" \
  -F "model=tencent/hunyuan-3d-3.1" \
  -F 'input={"prompt":"your prompt here"}' \
  -F "file:image=@your_file.png"

Image URL

Pass a publicly accessible URL directly. You can also use file_url from the Storage API.

{
  "model": "tencent/hunyuan-3d-3.1",
  "input": {
    "prompt": "your prompt here",
    "image": "https://example.com/image.jpg"
  }
}

See the File Upload docs for more upload methods including Presigned URLs.

Common Parameters

Common parameters used when calling POST /v1/predictions.

Parameter	Type	Required	Default	Description
`model`	string	Yes	-	Model identifier
`input`	object	Yes	-	Object containing the model-specific parameters from the table above
`output_folder`	string	No	-	Folder path for output files (max 256 chars, '..' not allowed)
`webhook_url`	string	No	-	Webhook URL to call on completion
`is_public`	boolean	No	false	If true, output files are also available via permanent public URLs

Examples

Text to 3D Asset

Generate a textured 3D model from a description

curl -X POST "https://api.core.today/v1/predictions" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: cdt_your_api_key" \
  -d '{
  "model": "tencent/hunyuan-3d-3.1",
  "input": {
    "prompt": "A cute low-poly cartoon fox sitting, game asset style",
    "generate_type": "Normal",
    "enable_pbr": true
  }
}'