MODEL IDtencent:hunyuan-3d@3.1-rapid
live

Hunyuan 3D 3.1 Rapid

Hunyuan 3D 3.1 Rapid is a speed-optimized 3D generation model from Tencent designed for fast prototyping and iteration. It generates 3D assets from text prompts or single images in seconds, producing clean meshes with PBR materials. Ideal for concept evaluation, rapid asset library building, and early-stage design workflows where speed is prioritized over maximum geometric detail.

Hunyuan 3D 3.1 Rapid
Text to 3D

Porcelain Koi Music Box

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-rapid',
  positivePrompt: 'A porcelain koi music box, circular jade base, enamel fins, brass inlay, tiny reeds and lily pads, elegant collectible figurine, stylized product design, clean silhouette, PBR materials',
  settings: {
    pbr: true,
    geometryOnly: false
  }
})
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-rapid",
            "positivePrompt": "A porcelain koi music box, circular jade base, enamel fins, brass inlay, tiny reeds and lily pads, elegant collectible figurine, stylized product design, clean silhouette, PBR materials",
            "settings": {
                "pbr": True,
                "geometryOnly": False
            }
        })


asyncio.run(main())
curl https://api.runware.ai/v1 \
  -H "Authorization: Bearer $RUNWARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '[
    {
      "taskType": "3dInference",
      "taskUUID": "68277cbc-f0d4-4044-aec1-e0d787faa2bc",
      "model": "tencent:hunyuan-3d@3.1-rapid",
      "positivePrompt": "A porcelain koi music box, circular jade base, enamel fins, brass inlay, tiny reeds and lily pads, elegant collectible figurine, stylized product design, clean silhouette, PBR materials",
      "settings": {
        "pbr": true,
        "geometryOnly": false
      }
    }
  ]'
runware run tencent:hunyuan-3d@3.1-rapid \
  positivePrompt="A porcelain koi music box, circular jade base, enamel fins, brass inlay, tiny reeds and lily pads, elegant collectible figurine, stylized product design, clean silhouette, PBR materials" \
  settings.pbr=true \
  settings.geometryOnly=false
{
  "taskType": "3dInference",
  "taskUUID": "68277cbc-f0d4-4044-aec1-e0d787faa2bc",
  "model": "tencent:hunyuan-3d@3.1-rapid",
  "positivePrompt": "A porcelain koi music box, circular jade base, enamel fins, brass inlay, tiny reeds and lily pads, elegant collectible figurine, stylized product design, clean silhouette, PBR materials",
  "settings": {
    "pbr": true,
    "geometryOnly": false
  }
}
Response
{
  "taskType": "3dInference",
  "taskUUID": "68277cbc-f0d4-4044-aec1-e0d787faa2bc",
  "seed": 227731155,
  "cost": 0.375,
  "outputs": {
    "files": [
      {
        "uuid": "42f6931c-2771-47d9-90bf-1e177cea464a",
        "url": "https://im.runware.ai/image/os/a09dlim3/ws/5/ii/42f6931c-2771-47d9-90bf-1e177cea464a.glb"
      }
    ]
  }
}
Text to 3D

Basalt Shrine Relic Figurine

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-rapid',
  positivePrompt: 'A palm-sized volcanic stone guardian idol, carved rings, copper inlay seams, turquoise eyes, ceremonial relic, stylized game asset, clean silhouette, centered single object',
  settings: {
    pbr: true,
    geometryOnly: false
  }
})
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-rapid",
            "positivePrompt": "A palm-sized volcanic stone guardian idol, carved rings, copper inlay seams, turquoise eyes, ceremonial relic, stylized game asset, clean silhouette, centered single object",
            "settings": {
                "pbr": True,
                "geometryOnly": False
            }
        })


asyncio.run(main())
curl https://api.runware.ai/v1 \
  -H "Authorization: Bearer $RUNWARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '[
    {
      "taskType": "3dInference",
      "taskUUID": "415d285d-3f28-4ba8-8618-36770f6bc462",
      "model": "tencent:hunyuan-3d@3.1-rapid",
      "positivePrompt": "A palm-sized volcanic stone guardian idol, carved rings, copper inlay seams, turquoise eyes, ceremonial relic, stylized game asset, clean silhouette, centered single object",
      "settings": {
        "pbr": true,
        "geometryOnly": false
      }
    }
  ]'
runware run tencent:hunyuan-3d@3.1-rapid \
  positivePrompt="A palm-sized volcanic stone guardian idol, carved rings, copper inlay seams, turquoise eyes, ceremonial relic, stylized game asset, clean silhouette, centered single object" \
  settings.pbr=true \
  settings.geometryOnly=false
{
  "taskType": "3dInference",
  "taskUUID": "415d285d-3f28-4ba8-8618-36770f6bc462",
  "model": "tencent:hunyuan-3d@3.1-rapid",
  "positivePrompt": "A palm-sized volcanic stone guardian idol, carved rings, copper inlay seams, turquoise eyes, ceremonial relic, stylized game asset, clean silhouette, centered single object",
  "settings": {
    "pbr": true,
    "geometryOnly": false
  }
}
Response
{
  "taskType": "3dInference",
  "taskUUID": "415d285d-3f28-4ba8-8618-36770f6bc462",
  "seed": 715837225,
  "cost": 0.375,
  "outputs": {
    "files": [
      {
        "uuid": "d838e76b-dc73-411a-8472-ea0e2ec68e31",
        "url": "https://im.runware.ai/image/os/a06dlim3/ws/5/ii/d838e76b-dc73-411a-8472-ea0e2ec68e31.glb"
      }
    ]
  }
}
Image to 3D

Tri-View Festival Mask 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-rapid',
  settings: {
    pbr: true,
    geometryOnly: false
  },
  inputs: {
    image: 'https://assets.runware.ai/assets/inputs/bd85c711-e459-44fb-b47f-c07afcbba8bd.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-rapid",
            "settings": {
                "pbr": True,
                "geometryOnly": False
            },
            "inputs": {
                "image": "https://assets.runware.ai/assets/inputs/bd85c711-e459-44fb-b47f-c07afcbba8bd.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": "84b3d708-9d9f-4af5-9553-6f2b0dce2a7a",
      "model": "tencent:hunyuan-3d@3.1-rapid",
      "settings": {
        "pbr": true,
        "geometryOnly": false
      },
      "inputs": {
        "image": "https://assets.runware.ai/assets/inputs/bd85c711-e459-44fb-b47f-c07afcbba8bd.jpg"
      }
    }
  ]'
runware run tencent:hunyuan-3d@3.1-rapid \
  settings.pbr=true \
  settings.geometryOnly=false \
  inputs.image=https://assets.runware.ai/assets/inputs/bd85c711-e459-44fb-b47f-c07afcbba8bd.jpg
{
  "taskType": "3dInference",
  "taskUUID": "84b3d708-9d9f-4af5-9553-6f2b0dce2a7a",
  "model": "tencent:hunyuan-3d@3.1-rapid",
  "settings": {
    "pbr": true,
    "geometryOnly": false
  },
  "inputs": {
    "image": "https://assets.runware.ai/assets/inputs/bd85c711-e459-44fb-b47f-c07afcbba8bd.jpg"
  }
}
Response
{
  "taskType": "3dInference",
  "taskUUID": "84b3d708-9d9f-4af5-9553-6f2b0dce2a7a",
  "seed": 90923366,
  "cost": 0.375,
  "outputs": {
    "files": [
      {
        "uuid": "00f016d6-b704-4ba2-9d12-58df85d927d8",
        "url": "https://im.runware.ai/image/os/a10dlim3/ws/5/ii/00f016d6-b704-4ba2-9d12-58df85d927d8.glb"
      }
    ]
  }
}
Text to 3D

Clockwork Orchard Sentinel

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-rapid',
  positivePrompt: 'A whimsical brass orchard guardian automaton, pear-shaped torso, pruning-shear hands, ceramic face, coiled spring joints, lacquered wood backpack of seed drawers, game-ready collectible asset',
  settings: {
    pbr: true,
    geometryOnly: false
  }
})
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-rapid",
            "positivePrompt": "A whimsical brass orchard guardian automaton, pear-shaped torso, pruning-shear hands, ceramic face, coiled spring joints, lacquered wood backpack of seed drawers, game-ready collectible asset",
            "settings": {
                "pbr": True,
                "geometryOnly": False
            }
        })


asyncio.run(main())
curl https://api.runware.ai/v1 \
  -H "Authorization: Bearer $RUNWARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '[
    {
      "taskType": "3dInference",
      "taskUUID": "e6abe8c6-8216-4581-b4f8-6f2cc0cfd2a4",
      "model": "tencent:hunyuan-3d@3.1-rapid",
      "positivePrompt": "A whimsical brass orchard guardian automaton, pear-shaped torso, pruning-shear hands, ceramic face, coiled spring joints, lacquered wood backpack of seed drawers, game-ready collectible asset",
      "settings": {
        "pbr": true,
        "geometryOnly": false
      }
    }
  ]'
runware run tencent:hunyuan-3d@3.1-rapid \
  positivePrompt="A whimsical brass orchard guardian automaton, pear-shaped torso, pruning-shear hands, ceramic face, coiled spring joints, lacquered wood backpack of seed drawers, game-ready collectible asset" \
  settings.pbr=true \
  settings.geometryOnly=false
{
  "taskType": "3dInference",
  "taskUUID": "e6abe8c6-8216-4581-b4f8-6f2cc0cfd2a4",
  "model": "tencent:hunyuan-3d@3.1-rapid",
  "positivePrompt": "A whimsical brass orchard guardian automaton, pear-shaped torso, pruning-shear hands, ceramic face, coiled spring joints, lacquered wood backpack of seed drawers, game-ready collectible asset",
  "settings": {
    "pbr": true,
    "geometryOnly": false
  }
}
Response
{
  "taskType": "3dInference",
  "taskUUID": "e6abe8c6-8216-4581-b4f8-6f2cc0cfd2a4",
  "seed": 1991836112,
  "cost": 0.375,
  "outputs": {
    "files": [
      {
        "uuid": "5aa160a4-4a7c-4e4a-a164-53b26d29075d",
        "url": "https://im.runware.ai/image/os/a09dlim3/ws/5/ii/5aa160a4-4a7c-4e4a-a164-53b26d29075d.glb"
      }
    ]
  }
}
Image to 3D

Glazed Lantern Beetle Figurine

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-rapid',
  settings: {
    pbr: true,
    geometryOnly: false
  },
  inputs: {
    image: 'https://assets.runware.ai/assets/inputs/23b6e5f2-2831-41a6-9454-086f5a4257af.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-rapid",
            "settings": {
                "pbr": True,
                "geometryOnly": False
            },
            "inputs": {
                "image": "https://assets.runware.ai/assets/inputs/23b6e5f2-2831-41a6-9454-086f5a4257af.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": "7923d696-d436-4458-bc07-06db1d20a37e",
      "model": "tencent:hunyuan-3d@3.1-rapid",
      "settings": {
        "pbr": true,
        "geometryOnly": false
      },
      "inputs": {
        "image": "https://assets.runware.ai/assets/inputs/23b6e5f2-2831-41a6-9454-086f5a4257af.jpg"
      }
    }
  ]'
runware run tencent:hunyuan-3d@3.1-rapid \
  settings.pbr=true \
  settings.geometryOnly=false \
  inputs.image=https://assets.runware.ai/assets/inputs/23b6e5f2-2831-41a6-9454-086f5a4257af.jpg
{
  "taskType": "3dInference",
  "taskUUID": "7923d696-d436-4458-bc07-06db1d20a37e",
  "model": "tencent:hunyuan-3d@3.1-rapid",
  "settings": {
    "pbr": true,
    "geometryOnly": false
  },
  "inputs": {
    "image": "https://assets.runware.ai/assets/inputs/23b6e5f2-2831-41a6-9454-086f5a4257af.jpg"
  }
}
Response
{
  "taskType": "3dInference",
  "taskUUID": "7923d696-d436-4458-bc07-06db1d20a37e",
  "seed": 1263920624,
  "cost": 0.375,
  "outputs": {
    "files": [
      {
        "uuid": "2a63429c-9fad-4dc4-8cda-4c891664e241",
        "url": "https://im.runware.ai/image/os/a05d22/ws/5/ii/2a63429c-9fad-4dc4-8cda-4c891664e241.glb"
      }
    ]
  }
}