↑↓ Navigateenter Openesc Close
Dashboard
MODEL IDtencent:hunyuan-3d@3.1-pro
live

Hunyuan 3D 3.1 Pro

Hunyuan 3D 3.1 Pro is a production-grade 3D generation model from Tencent that creates high-fidelity assets from text prompts or images. It uses enhanced 8-view reconstruction for improved spatial accuracy and reduced geometric artifacts, producing clean topology, watertight meshes, and PBR materials suitable for game development, 3D printing, and professional animation workflows.

Hunyuan 3D 3.1 Pro
Image to 3D

Scorched Pilgrim Mask Idol

import { createClient } from '@runware/sdk'

const client = await createClient({ apiKey: process.env.RUNWARE_API_KEY })
await client.connect()

const [result] = await client.run({
  model: 'tencent:hunyuan-3d@3.1-pro',
  settings: {
    faceCount: 500000,
    generateType: 'Normal',
    pbr: true
  },
  inputs: {
    images: [
      'https://assets.runware.ai/assets/inputs/04e4e03b-b9be-4819-87fd-dfb09b457567.jpg'
    ]
  }
})
import asyncio
import os

from runware import Runware


async def main():
    async with Runware(api_key=os.environ["RUNWARE_API_KEY"]) as client:
        results = await client.run({
            "model": "tencent:hunyuan-3d@3.1-pro",
            "settings": {
                "faceCount": 500000,
                "generateType": "Normal",
                "pbr": True
            },
            "inputs": {
                "images": [
                    "https://assets.runware.ai/assets/inputs/04e4e03b-b9be-4819-87fd-dfb09b457567.jpg"
                ]
            }
        })


asyncio.run(main())
curl https://api.runware.ai/v1 \
  -H "Authorization: Bearer $RUNWARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '[
    {
      "taskType": "3dInference",
      "taskUUID": "31a23b9d-adfa-4866-b108-f21e50f88e4b",
      "model": "tencent:hunyuan-3d@3.1-pro",
      "settings": {
        "faceCount": 500000,
        "generateType": "Normal",
        "pbr": true
      },
      "inputs": {
        "images": [
          "https://assets.runware.ai/assets/inputs/04e4e03b-b9be-4819-87fd-dfb09b457567.jpg"
        ]
      }
    }
  ]'
runware run tencent:hunyuan-3d@3.1-pro \
  settings.faceCount=500000 \
  settings.generateType=Normal \
  settings.pbr=true \
  inputs.images.0=https://assets.runware.ai/assets/inputs/04e4e03b-b9be-4819-87fd-dfb09b457567.jpg
{
  "taskType": "3dInference",
  "taskUUID": "31a23b9d-adfa-4866-b108-f21e50f88e4b",
  "model": "tencent:hunyuan-3d@3.1-pro",
  "settings": {
    "faceCount": 500000,
    "generateType": "Normal",
    "pbr": true
  },
  "inputs": {
    "images": [
      "https://assets.runware.ai/assets/inputs/04e4e03b-b9be-4819-87fd-dfb09b457567.jpg"
    ]
  }
}
Response
{
  "taskType": "3dInference",
  "taskUUID": "31a23b9d-adfa-4866-b108-f21e50f88e4b",
  "seed": 428532157,
  "cost": 0.675,
  "outputs": {
    "files": [
      {
        "uuid": "68f694e3-0fc5-431a-b14c-3321e47b476f",
        "url": "https://im.runware.ai/image/os/a07dlim3/ws/5/ii/68f694e3-0fc5-431a-b14c-3321e47b476f.glb"
      }
    ]
  }
}
Text to 3D

Ceramic Koi Shrine Relic

import { createClient } from '@runware/sdk'

const client = await createClient({ apiKey: process.env.RUNWARE_API_KEY })
await client.connect()

const [result] = await client.run({
  model: 'tencent:hunyuan-3d@3.1-pro',
  positivePrompt: 'A highly detailed 3D collectible relic shaped like a ceremonial koi idol, designed as a tabletop hero asset. The body is crafted from cracked white porcelain with cobalt wave motifs, inlaid brass fins, a halo-like ring of carved basalt fragments behind the head, and braided crimson cords suspending tiny prayer tags from the tail. The eyes are polished obsidian, the scales are slightly raised and asymmetrical for realism, and the base is a worn black stone plinth with subtle chisel marks. Blend East Asian sacred-object influence with fantasy relic design, emphasizing full object readability from every angle, balanced silhouette, intricate surface detail, believable thickness, clean separations between materials, and premium game-ready craftsmanship. Studio-neutral presentation, isolated object, no environment, no people, no text, no pedestal turntable.',
  settings: {
    faceCount: 850000,
    generateType: 'Normal',
    pbr: true
  }
})
import asyncio
import os

from runware import Runware


async def main():
    async with Runware(api_key=os.environ["RUNWARE_API_KEY"]) as client:
        results = await client.run({
            "model": "tencent:hunyuan-3d@3.1-pro",
            "positivePrompt": "A highly detailed 3D collectible relic shaped like a ceremonial koi idol, designed as a tabletop hero asset. The body is crafted from cracked white porcelain with cobalt wave motifs, inlaid brass fins, a halo-like ring of carved basalt fragments behind the head, and braided crimson cords suspending tiny prayer tags from the tail. The eyes are polished obsidian, the scales are slightly raised and asymmetrical for realism, and the base is a worn black stone plinth with subtle chisel marks. Blend East Asian sacred-object influence with fantasy relic design, emphasizing full object readability from every angle, balanced silhouette, intricate surface detail, believable thickness, clean separations between materials, and premium game-ready craftsmanship. Studio-neutral presentation, isolated object, no environment, no people, no text, no pedestal turntable.",
            "settings": {
                "faceCount": 850000,
                "generateType": "Normal",
                "pbr": True
            }
        })


asyncio.run(main())
curl https://api.runware.ai/v1 \
  -H "Authorization: Bearer $RUNWARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '[
    {
      "taskType": "3dInference",
      "taskUUID": "bb167d53-5bb0-44fd-8293-0e698624cd76",
      "model": "tencent:hunyuan-3d@3.1-pro",
      "positivePrompt": "A highly detailed 3D collectible relic shaped like a ceremonial koi idol, designed as a tabletop hero asset. The body is crafted from cracked white porcelain with cobalt wave motifs, inlaid brass fins, a halo-like ring of carved basalt fragments behind the head, and braided crimson cords suspending tiny prayer tags from the tail. The eyes are polished obsidian, the scales are slightly raised and asymmetrical for realism, and the base is a worn black stone plinth with subtle chisel marks. Blend East Asian sacred-object influence with fantasy relic design, emphasizing full object readability from every angle, balanced silhouette, intricate surface detail, believable thickness, clean separations between materials, and premium game-ready craftsmanship. Studio-neutral presentation, isolated object, no environment, no people, no text, no pedestal turntable.",
      "settings": {
        "faceCount": 850000,
        "generateType": "Normal",
        "pbr": true
      }
    }
  ]'
runware run tencent:hunyuan-3d@3.1-pro \
  positivePrompt="A highly detailed 3D collectible relic shaped like a ceremonial koi idol, designed as a tabletop hero asset. The body is crafted from cracked white porcelain with cobalt wave motifs, inlaid brass fins, a halo-like ring of carved basalt fragments behind the head, and braided crimson cords suspending tiny prayer tags from the tail. The eyes are polished obsidian, the scales are slightly raised and asymmetrical for realism, and the base is a worn black stone plinth with subtle chisel marks. Blend East Asian sacred-object influence with fantasy relic design, emphasizing full object readability from every angle, balanced silhouette, intricate surface detail, believable thickness, clean separations between materials, and premium game-ready craftsmanship. Studio-neutral presentation, isolated object, no environment, no people, no text, no pedestal turntable." \
  settings.faceCount=850000 \
  settings.generateType=Normal \
  settings.pbr=true
{
  "taskType": "3dInference",
  "taskUUID": "bb167d53-5bb0-44fd-8293-0e698624cd76",
  "model": "tencent:hunyuan-3d@3.1-pro",
  "positivePrompt": "A highly detailed 3D collectible relic shaped like a ceremonial koi idol, designed as a tabletop hero asset. The body is crafted from cracked white porcelain with cobalt wave motifs, inlaid brass fins, a halo-like ring of carved basalt fragments behind the head, and braided crimson cords suspending tiny prayer tags from the tail. The eyes are polished obsidian, the scales are slightly raised and asymmetrical for realism, and the base is a worn black stone plinth with subtle chisel marks. Blend East Asian sacred-object influence with fantasy relic design, emphasizing full object readability from every angle, balanced silhouette, intricate surface detail, believable thickness, clean separations between materials, and premium game-ready craftsmanship. Studio-neutral presentation, isolated object, no environment, no people, no text, no pedestal turntable.",
  "settings": {
    "faceCount": 850000,
    "generateType": "Normal",
    "pbr": true
  }
}
Response
{
  "taskType": "3dInference",
  "taskUUID": "bb167d53-5bb0-44fd-8293-0e698624cd76",
  "seed": 277347751,
  "cost": 0.675,
  "outputs": {
    "files": [
      {
        "uuid": "f4c307e4-b1ea-45b4-aa74-e5f52cd1d54b",
        "url": "https://im.runware.ai/image/os/a06dlim3/ws/5/ii/f4c307e4-b1ea-45b4-aa74-e5f52cd1d54b.glb"
      }
    ]
  }
}
Image to 3D

Verdigris Astrolabe Beetle Totem

import { createClient } from '@runware/sdk'

const client = await createClient({ apiKey: process.env.RUNWARE_API_KEY })
await client.connect()

const [result] = await client.run({
  model: 'tencent:hunyuan-3d@3.1-pro',
  settings: {
    faceCount: 850000,
    generateType: 'Normal',
    pbr: true
  },
  inputs: {
    images: [
      'https://assets.runware.ai/assets/inputs/d781cd9f-d5a9-4336-8a49-43fc0756556b.jpg'
    ]
  }
})
import asyncio
import os

from runware import Runware


async def main():
    async with Runware(api_key=os.environ["RUNWARE_API_KEY"]) as client:
        results = await client.run({
            "model": "tencent:hunyuan-3d@3.1-pro",
            "settings": {
                "faceCount": 850000,
                "generateType": "Normal",
                "pbr": True
            },
            "inputs": {
                "images": [
                    "https://assets.runware.ai/assets/inputs/d781cd9f-d5a9-4336-8a49-43fc0756556b.jpg"
                ]
            }
        })


asyncio.run(main())
curl https://api.runware.ai/v1 \
  -H "Authorization: Bearer $RUNWARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '[
    {
      "taskType": "3dInference",
      "taskUUID": "6d1ea289-b727-4c86-b5d8-4a6bc82e0dfb",
      "model": "tencent:hunyuan-3d@3.1-pro",
      "settings": {
        "faceCount": 850000,
        "generateType": "Normal",
        "pbr": true
      },
      "inputs": {
        "images": [
          "https://assets.runware.ai/assets/inputs/d781cd9f-d5a9-4336-8a49-43fc0756556b.jpg"
        ]
      }
    }
  ]'
runware run tencent:hunyuan-3d@3.1-pro \
  settings.faceCount=850000 \
  settings.generateType=Normal \
  settings.pbr=true \
  inputs.images.0=https://assets.runware.ai/assets/inputs/d781cd9f-d5a9-4336-8a49-43fc0756556b.jpg
{
  "taskType": "3dInference",
  "taskUUID": "6d1ea289-b727-4c86-b5d8-4a6bc82e0dfb",
  "model": "tencent:hunyuan-3d@3.1-pro",
  "settings": {
    "faceCount": 850000,
    "generateType": "Normal",
    "pbr": true
  },
  "inputs": {
    "images": [
      "https://assets.runware.ai/assets/inputs/d781cd9f-d5a9-4336-8a49-43fc0756556b.jpg"
    ]
  }
}
Response
{
  "taskType": "3dInference",
  "taskUUID": "6d1ea289-b727-4c86-b5d8-4a6bc82e0dfb",
  "seed": 213870862,
  "cost": 0.675,
  "outputs": {
    "files": [
      {
        "uuid": "d1500378-4bd2-478f-947c-b310350cb41c",
        "url": "https://im.runware.ai/image/os/a06dlim3/ws/5/ii/d1500378-4bd2-478f-947c-b310350cb41c.glb"
      }
    ]
  }
}
Image to 3D

Basalt Diver Helmet Relic

import { createClient } from '@runware/sdk'

const client = await createClient({ apiKey: process.env.RUNWARE_API_KEY })
await client.connect()

const [result] = await client.run({
  model: 'tencent:hunyuan-3d@3.1-pro',
  settings: {
    faceCount: 600000,
    generateType: 'Normal',
    pbr: true
  },
  inputs: {
    images: [
      'https://assets.runware.ai/assets/inputs/69a3730c-6114-4f20-8688-0e6988847817.jpg'
    ]
  }
})
import asyncio
import os

from runware import Runware


async def main():
    async with Runware(api_key=os.environ["RUNWARE_API_KEY"]) as client:
        results = await client.run({
            "model": "tencent:hunyuan-3d@3.1-pro",
            "settings": {
                "faceCount": 600000,
                "generateType": "Normal",
                "pbr": True
            },
            "inputs": {
                "images": [
                    "https://assets.runware.ai/assets/inputs/69a3730c-6114-4f20-8688-0e6988847817.jpg"
                ]
            }
        })


asyncio.run(main())
curl https://api.runware.ai/v1 \
  -H "Authorization: Bearer $RUNWARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '[
    {
      "taskType": "3dInference",
      "taskUUID": "331c939d-44b0-4133-a709-d751021c4b69",
      "model": "tencent:hunyuan-3d@3.1-pro",
      "settings": {
        "faceCount": 600000,
        "generateType": "Normal",
        "pbr": true
      },
      "inputs": {
        "images": [
          "https://assets.runware.ai/assets/inputs/69a3730c-6114-4f20-8688-0e6988847817.jpg"
        ]
      }
    }
  ]'
runware run tencent:hunyuan-3d@3.1-pro \
  settings.faceCount=600000 \
  settings.generateType=Normal \
  settings.pbr=true \
  inputs.images.0=https://assets.runware.ai/assets/inputs/69a3730c-6114-4f20-8688-0e6988847817.jpg
{
  "taskType": "3dInference",
  "taskUUID": "331c939d-44b0-4133-a709-d751021c4b69",
  "model": "tencent:hunyuan-3d@3.1-pro",
  "settings": {
    "faceCount": 600000,
    "generateType": "Normal",
    "pbr": true
  },
  "inputs": {
    "images": [
      "https://assets.runware.ai/assets/inputs/69a3730c-6114-4f20-8688-0e6988847817.jpg"
    ]
  }
}
Response
{
  "taskType": "3dInference",
  "taskUUID": "331c939d-44b0-4133-a709-d751021c4b69",
  "seed": 978329941,
  "cost": 0.675,
  "outputs": {
    "files": [
      {
        "uuid": "91f6b852-94e5-4adb-8e6f-f516e0997e1a",
        "url": "https://im.runware.ai/image/os/a05d22/ws/5/ii/91f6b852-94e5-4adb-8e6f-f516e0997e1a.glb"
      }
    ]
  }
}
Ask AI
Send feedback