Hunyuan 3D v3.1 Pro Text to 3D

curl --request POST \
  --url https://api.vidgo.ai/api/generate/submit \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "hunyuan-3d/v3.1/pro/text-to-3d",
  "input": {
    "prompt": "A quiet forest under soft morning light, with natural detail.",
    "face_count": 500000,
    "enable_pbr": true,
    "generate_type": "Normal"
  }
}
'

{
  "code": 200,
  "data": {
    "task_id": "task-unified-example",
    "status": "running",
    "created_time": "2026-09-10T08:00:00"
  }
}

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

Request timeout

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

Generate 3D objects from text with Hunyuan 3D v3.1 Pro, with control over mesh complexity and geometry-only output.

​

Models

• hunyuan-3d/v3.1/pro/text-to-3d - Generate a 3D model from a text prompt.

​

Features

• Generate a 3D model from a text prompt.
• Retrieve model assets and available previews or supporting files from the task result.

​

Output Options

​

Generate Type

• generate_type: Optional. Choose Normal for a textured model or Geometry for a geometry-only white model.

​

Face Count

• face_count: Optional. Set the target face count. Integer from 40000 to 1500000. Default: 500000.

​

Advanced Parameters

Set model and optional callback_url at the request root. Place all workflow parameters, including output options, inside input. Use the input parameters listed below.

​

Prompt

• prompt: Required. Describe the desired 3D object. Length: 1-1,024 characters.
• Use a nonblank string when providing this parameter.

​

PBR

• enable_pbr: Optional. Set true to generate PBR materials in textured mode. Geometry-only generation takes precedence over this setting.

​

Output Files

• Read every item in the returned files array.
• Model assets use file_type: "3d"; previews use file_type: "image".
• Additional artifacts may use file_type: "other". Retain returned textures, material files, and file metadata.