Search across models, guides, examples and the API.
↑↓ Navigateenter Openesc Close
Dashboard
live
MODEL IDtencent:hunyuan-3d@3.1-pro
Try in Playground

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

text-to-3d

Runway Friction Tester Trailer$0.525~2m 16s
Try in Playground
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: 'Single complete towable runway friction-testing trailer, designed as a game-ready 3D prop for a contemporary airport operations simulator. Compact low rectangular chassis with rounded safety-orange fiberglass housing, matte white upper access lid, black rubber fenders, two road wheels, front tow bar and small jockey wheel. Include a visible lowered measuring wheel centered beneath the chassis, slim water-spray nozzle, recessed control panel with unlabeled buttons, steel latches, ventilation slots, red rear reflectors, coiled black utility cable and realistic bolts. Clean industrial design with modest operational wear, faint tire grime and edge scuffs. PBR materials: painted fiberglass, galvanized steel, rubber and clear indicator lenses. Accurate proportions, complete underside, clean silhouette, no logos, no lettering, no environment or separate objects.',
  settings: {
    faceCount: 500000,
    generateType: 'Normal',
    pbr: 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-pro",
            "positivePrompt": "Single complete towable runway friction-testing trailer, designed as a game-ready 3D prop for a contemporary airport operations simulator. Compact low rectangular chassis with rounded safety-orange fiberglass housing, matte white upper access lid, black rubber fenders, two road wheels, front tow bar and small jockey wheel. Include a visible lowered measuring wheel centered beneath the chassis, slim water-spray nozzle, recessed control panel with unlabeled buttons, steel latches, ventilation slots, red rear reflectors, coiled black utility cable and realistic bolts. Clean industrial design with modest operational wear, faint tire grime and edge scuffs. PBR materials: painted fiberglass, galvanized steel, rubber and clear indicator lenses. Accurate proportions, complete underside, clean silhouette, no logos, no lettering, no environment or separate objects.",
            "settings": {
                "faceCount": 500000,
                "generateType": "Normal",
                "pbr": 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": "979602a5-bb85-43b0-8dd8-89232e074a33",
      "model": "tencent:hunyuan-3d@3.1-pro",
      "positivePrompt": "Single complete towable runway friction-testing trailer, designed as a game-ready 3D prop for a contemporary airport operations simulator. Compact low rectangular chassis with rounded safety-orange fiberglass housing, matte white upper access lid, black rubber fenders, two road wheels, front tow bar and small jockey wheel. Include a visible lowered measuring wheel centered beneath the chassis, slim water-spray nozzle, recessed control panel with unlabeled buttons, steel latches, ventilation slots, red rear reflectors, coiled black utility cable and realistic bolts. Clean industrial design with modest operational wear, faint tire grime and edge scuffs. PBR materials: painted fiberglass, galvanized steel, rubber and clear indicator lenses. Accurate proportions, complete underside, clean silhouette, no logos, no lettering, no environment or separate objects.",
      "settings": {
        "faceCount": 500000,
        "generateType": "Normal",
        "pbr": false
      }
    }
  ]'
runware run tencent:hunyuan-3d@3.1-pro \
  positivePrompt="Single complete towable runway friction-testing trailer, designed as a game-ready 3D prop for a contemporary airport operations simulator. Compact low rectangular chassis with rounded safety-orange fiberglass housing, matte white upper access lid, black rubber fenders, two road wheels, front tow bar and small jockey wheel. Include a visible lowered measuring wheel centered beneath the chassis, slim water-spray nozzle, recessed control panel with unlabeled buttons, steel latches, ventilation slots, red rear reflectors, coiled black utility cable and realistic bolts. Clean industrial design with modest operational wear, faint tire grime and edge scuffs. PBR materials: painted fiberglass, galvanized steel, rubber and clear indicator lenses. Accurate proportions, complete underside, clean silhouette, no logos, no lettering, no environment or separate objects." \
  settings.faceCount=500000 \
  settings.generateType=Normal \
  settings.pbr=false
{
  "taskType": "3dInference",
  "taskUUID": "979602a5-bb85-43b0-8dd8-89232e074a33",
  "model": "tencent:hunyuan-3d@3.1-pro",
  "positivePrompt": "Single complete towable runway friction-testing trailer, designed as a game-ready 3D prop for a contemporary airport operations simulator. Compact low rectangular chassis with rounded safety-orange fiberglass housing, matte white upper access lid, black rubber fenders, two road wheels, front tow bar and small jockey wheel. Include a visible lowered measuring wheel centered beneath the chassis, slim water-spray nozzle, recessed control panel with unlabeled buttons, steel latches, ventilation slots, red rear reflectors, coiled black utility cable and realistic bolts. Clean industrial design with modest operational wear, faint tire grime and edge scuffs. PBR materials: painted fiberglass, galvanized steel, rubber and clear indicator lenses. Accurate proportions, complete underside, clean silhouette, no logos, no lettering, no environment or separate objects.",
  "settings": {
    "faceCount": 500000,
    "generateType": "Normal",
    "pbr": false
  }
}
Response
{
  "taskType": "3dInference",
  "taskUUID": "979602a5-bb85-43b0-8dd8-89232e074a33",
  "seed": 2025475628,
  "cost": 0.525,
  "outputs": {
    "files": [
      {
        "uuid": "e50e0b60-bada-4942-bedb-19eeb7dd6906",
        "url": "https://im.runware.ai/image/os/a09dlim3/ws/5/ii/e50e0b60-bada-4942-bedb-19eeb7dd6906.glb"
      }
    ]
  }
}

image-to-3d

Electric Tufting Gun Ecommerce Model$0.525~2m 8s
Try in Playground
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: false
  },
  inputs: {
    images: [
      'https://assets.runware.ai/assets/inputs/239bb5e1-4eae-458d-8c7b-3ab5668f9a07.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": False
            },
            "inputs": {
                "images": [
                    "https://assets.runware.ai/assets/inputs/239bb5e1-4eae-458d-8c7b-3ab5668f9a07.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": "91f66d00-1f2a-4d6f-8906-72b8babab39a",
      "model": "tencent:hunyuan-3d@3.1-pro",
      "settings": {
        "faceCount": 500000,
        "generateType": "Normal",
        "pbr": false
      },
      "inputs": {
        "images": [
          "https://assets.runware.ai/assets/inputs/239bb5e1-4eae-458d-8c7b-3ab5668f9a07.jpg"
        ]
      }
    }
  ]'
runware run tencent:hunyuan-3d@3.1-pro \
  settings.faceCount=500000 \
  settings.generateType=Normal \
  settings.pbr=false \
  inputs.images.0=https://assets.runware.ai/assets/inputs/239bb5e1-4eae-458d-8c7b-3ab5668f9a07.jpg
{
  "taskType": "3dInference",
  "taskUUID": "91f66d00-1f2a-4d6f-8906-72b8babab39a",
  "model": "tencent:hunyuan-3d@3.1-pro",
  "settings": {
    "faceCount": 500000,
    "generateType": "Normal",
    "pbr": false
  },
  "inputs": {
    "images": [
      "https://assets.runware.ai/assets/inputs/239bb5e1-4eae-458d-8c7b-3ab5668f9a07.jpg"
    ]
  }
}
Response
{
  "taskType": "3dInference",
  "taskUUID": "91f66d00-1f2a-4d6f-8906-72b8babab39a",
  "seed": 268787640,
  "cost": 0.525,
  "outputs": {
    "files": [
      {
        "uuid": "49026456-0581-44c6-ba00-144742a89093",
        "url": "https://im.runware.ai/image/os/a10dlim3/ws/5/ii/49026456-0581-44c6-ba00-144742a89093.glb"
      }
    ]
  }
}

image-to-3d-geometry-only

Polar Telegraph Cabin Environment$0.375~2m 17s
Try in Playground
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: 350000,
    generateType: 'Geometry'
  },
  inputs: {
    images: [
      'https://assets.runware.ai/assets/inputs/df75c798-ba6c-4455-8e87-da2ff65e2cde.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": 350000,
                "generateType": "Geometry"
            },
            "inputs": {
                "images": [
                    "https://assets.runware.ai/assets/inputs/df75c798-ba6c-4455-8e87-da2ff65e2cde.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": "b5f25d55-23a2-42e5-ab9f-7b394ea3cb21",
      "model": "tencent:hunyuan-3d@3.1-pro",
      "settings": {
        "faceCount": 350000,
        "generateType": "Geometry"
      },
      "inputs": {
        "images": [
          "https://assets.runware.ai/assets/inputs/df75c798-ba6c-4455-8e87-da2ff65e2cde.jpg"
        ]
      }
    }
  ]'
runware run tencent:hunyuan-3d@3.1-pro \
  settings.faceCount=350000 \
  settings.generateType=Geometry \
  inputs.images.0=https://assets.runware.ai/assets/inputs/df75c798-ba6c-4455-8e87-da2ff65e2cde.jpg
{
  "taskType": "3dInference",
  "taskUUID": "b5f25d55-23a2-42e5-ab9f-7b394ea3cb21",
  "model": "tencent:hunyuan-3d@3.1-pro",
  "settings": {
    "faceCount": 350000,
    "generateType": "Geometry"
  },
  "inputs": {
    "images": [
      "https://assets.runware.ai/assets/inputs/df75c798-ba6c-4455-8e87-da2ff65e2cde.jpg"
    ]
  }
}
Response
{
  "taskType": "3dInference",
  "taskUUID": "b5f25d55-23a2-42e5-ab9f-7b394ea3cb21",
  "seed": 1554099175,
  "cost": 0.375,
  "outputs": {
    "files": [
      {
        "uuid": "a330add6-6323-41a2-a68c-4897dedbc1c4",
        "url": "https://im.runware.ai/image/os/a06dlim3/ws/5/ii/a330add6-6323-41a2-a68c-4897dedbc1c4.glb"
      }
    ]
  }
}

text-to-3d-geometry-only

Pediatric Radiology Axolotl Mascot$0.375~1m 22s
Try in Playground
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: 'Single full-body axolotl mascot designed for a pediatric radiology program, standing upright in a relaxed animation-ready pose with arms held slightly away from the torso. Reassuring, curious personality expressed through a broad wedge-shaped head, gentle smile, raised brow forms, rounded cheeks, compact body, sturdy webbed feet, and a long counterbalancing tail with a pronounced fin ridge. Six large external gill branches create a memorable radial silhouette; sculpt each branch as a tapered organic form with bold ribbed fronds. Use clear interlocking body masses, softly defined joints, simplified digits, and subtle anatomical folds that read through geometry alone. Friendly stop-motion maquette art direction, appealing from every angle. One watertight character object, no clothing, accessories, pedestal, lettering, color-dependent details, or surface patterns.',
  settings: {
    faceCount: 300000,
    generateType: 'Geometry'
  }
})
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": "Single full-body axolotl mascot designed for a pediatric radiology program, standing upright in a relaxed animation-ready pose with arms held slightly away from the torso. Reassuring, curious personality expressed through a broad wedge-shaped head, gentle smile, raised brow forms, rounded cheeks, compact body, sturdy webbed feet, and a long counterbalancing tail with a pronounced fin ridge. Six large external gill branches create a memorable radial silhouette; sculpt each branch as a tapered organic form with bold ribbed fronds. Use clear interlocking body masses, softly defined joints, simplified digits, and subtle anatomical folds that read through geometry alone. Friendly stop-motion maquette art direction, appealing from every angle. One watertight character object, no clothing, accessories, pedestal, lettering, color-dependent details, or surface patterns.",
            "settings": {
                "faceCount": 300000,
                "generateType": "Geometry"
            }
        })


asyncio.run(main())
curl https://api.runware.ai/v1 \
  -H "Authorization: Bearer $RUNWARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '[
    {
      "taskType": "3dInference",
      "taskUUID": "e3b77003-3841-4c70-825d-470b7faa48a6",
      "model": "tencent:hunyuan-3d@3.1-pro",
      "positivePrompt": "Single full-body axolotl mascot designed for a pediatric radiology program, standing upright in a relaxed animation-ready pose with arms held slightly away from the torso. Reassuring, curious personality expressed through a broad wedge-shaped head, gentle smile, raised brow forms, rounded cheeks, compact body, sturdy webbed feet, and a long counterbalancing tail with a pronounced fin ridge. Six large external gill branches create a memorable radial silhouette; sculpt each branch as a tapered organic form with bold ribbed fronds. Use clear interlocking body masses, softly defined joints, simplified digits, and subtle anatomical folds that read through geometry alone. Friendly stop-motion maquette art direction, appealing from every angle. One watertight character object, no clothing, accessories, pedestal, lettering, color-dependent details, or surface patterns.",
      "settings": {
        "faceCount": 300000,
        "generateType": "Geometry"
      }
    }
  ]'
runware run tencent:hunyuan-3d@3.1-pro \
  positivePrompt="Single full-body axolotl mascot designed for a pediatric radiology program, standing upright in a relaxed animation-ready pose with arms held slightly away from the torso. Reassuring, curious personality expressed through a broad wedge-shaped head, gentle smile, raised brow forms, rounded cheeks, compact body, sturdy webbed feet, and a long counterbalancing tail with a pronounced fin ridge. Six large external gill branches create a memorable radial silhouette; sculpt each branch as a tapered organic form with bold ribbed fronds. Use clear interlocking body masses, softly defined joints, simplified digits, and subtle anatomical folds that read through geometry alone. Friendly stop-motion maquette art direction, appealing from every angle. One watertight character object, no clothing, accessories, pedestal, lettering, color-dependent details, or surface patterns." \
  settings.faceCount=300000 \
  settings.generateType=Geometry
{
  "taskType": "3dInference",
  "taskUUID": "e3b77003-3841-4c70-825d-470b7faa48a6",
  "model": "tencent:hunyuan-3d@3.1-pro",
  "positivePrompt": "Single full-body axolotl mascot designed for a pediatric radiology program, standing upright in a relaxed animation-ready pose with arms held slightly away from the torso. Reassuring, curious personality expressed through a broad wedge-shaped head, gentle smile, raised brow forms, rounded cheeks, compact body, sturdy webbed feet, and a long counterbalancing tail with a pronounced fin ridge. Six large external gill branches create a memorable radial silhouette; sculpt each branch as a tapered organic form with bold ribbed fronds. Use clear interlocking body masses, softly defined joints, simplified digits, and subtle anatomical folds that read through geometry alone. Friendly stop-motion maquette art direction, appealing from every angle. One watertight character object, no clothing, accessories, pedestal, lettering, color-dependent details, or surface patterns.",
  "settings": {
    "faceCount": 300000,
    "generateType": "Geometry"
  }
}
Response
{
  "taskType": "3dInference",
  "taskUUID": "e3b77003-3841-4c70-825d-470b7faa48a6",
  "seed": 480703741,
  "cost": 0.375,
  "outputs": {
    "files": [
      {
        "uuid": "1de95a6f-871a-485c-b0e8-fc7d01530513",
        "url": "https://im.runware.ai/image/os/a07dlim3/ws/5/ii/1de95a6f-871a-485c-b0e8-fc7d01530513.glb"
      }
    ]
  }
}

image-to-3d-pbr

Wetland Ranger Muskrat Character Model$0.825~3m 34s
Try in Playground
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: 1000000,
    generateType: 'Normal',
    pbr: true
  },
  inputs: {
    images: [
      'https://assets.runware.ai/assets/inputs/de50a309-63d3-4ffe-b9c0-7aa382c960cc.jpg',
      'https://assets.runware.ai/assets/inputs/9900e311-d5b8-4226-b010-23567f65d0e6.jpg',
      'https://assets.runware.ai/assets/inputs/f4b266d1-495b-43bc-b82e-80d805e38332.jpg',
      'https://assets.runware.ai/assets/inputs/a973e88d-5d07-4f71-901b-c4fd8e10cfc3.jpg',
      'https://assets.runware.ai/assets/inputs/fd3127cc-d087-4c66-8caa-fa02d6505e9e.jpg',
      'https://assets.runware.ai/assets/inputs/5ea84a2e-52c9-4f2a-8515-30ff458f6863.jpg',
      'https://assets.runware.ai/assets/inputs/7f52f067-796a-4bfc-8d0e-27fc51f25b1c.jpg',
      'https://assets.runware.ai/assets/inputs/88830cbe-8175-49d0-ad99-521f8ea52c6b.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": 1000000,
                "generateType": "Normal",
                "pbr": True
            },
            "inputs": {
                "images": [
                    "https://assets.runware.ai/assets/inputs/de50a309-63d3-4ffe-b9c0-7aa382c960cc.jpg",
                    "https://assets.runware.ai/assets/inputs/9900e311-d5b8-4226-b010-23567f65d0e6.jpg",
                    "https://assets.runware.ai/assets/inputs/f4b266d1-495b-43bc-b82e-80d805e38332.jpg",
                    "https://assets.runware.ai/assets/inputs/a973e88d-5d07-4f71-901b-c4fd8e10cfc3.jpg",
                    "https://assets.runware.ai/assets/inputs/fd3127cc-d087-4c66-8caa-fa02d6505e9e.jpg",
                    "https://assets.runware.ai/assets/inputs/5ea84a2e-52c9-4f2a-8515-30ff458f6863.jpg",
                    "https://assets.runware.ai/assets/inputs/7f52f067-796a-4bfc-8d0e-27fc51f25b1c.jpg",
                    "https://assets.runware.ai/assets/inputs/88830cbe-8175-49d0-ad99-521f8ea52c6b.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": "41b37dd5-5261-470b-a07c-9f10015809cc",
      "model": "tencent:hunyuan-3d@3.1-pro",
      "settings": {
        "faceCount": 1000000,
        "generateType": "Normal",
        "pbr": true
      },
      "inputs": {
        "images": [
          "https://assets.runware.ai/assets/inputs/de50a309-63d3-4ffe-b9c0-7aa382c960cc.jpg",
          "https://assets.runware.ai/assets/inputs/9900e311-d5b8-4226-b010-23567f65d0e6.jpg",
          "https://assets.runware.ai/assets/inputs/f4b266d1-495b-43bc-b82e-80d805e38332.jpg",
          "https://assets.runware.ai/assets/inputs/a973e88d-5d07-4f71-901b-c4fd8e10cfc3.jpg",
          "https://assets.runware.ai/assets/inputs/fd3127cc-d087-4c66-8caa-fa02d6505e9e.jpg",
          "https://assets.runware.ai/assets/inputs/5ea84a2e-52c9-4f2a-8515-30ff458f6863.jpg",
          "https://assets.runware.ai/assets/inputs/7f52f067-796a-4bfc-8d0e-27fc51f25b1c.jpg",
          "https://assets.runware.ai/assets/inputs/88830cbe-8175-49d0-ad99-521f8ea52c6b.jpg"
        ]
      }
    }
  ]'
runware run tencent:hunyuan-3d@3.1-pro \
  settings.faceCount=1000000 \
  settings.generateType=Normal \
  settings.pbr=true \
  inputs.images.0=https://assets.runware.ai/assets/inputs/de50a309-63d3-4ffe-b9c0-7aa382c960cc.jpg \
  inputs.images.1=https://assets.runware.ai/assets/inputs/9900e311-d5b8-4226-b010-23567f65d0e6.jpg \
  inputs.images.2=https://assets.runware.ai/assets/inputs/f4b266d1-495b-43bc-b82e-80d805e38332.jpg \
  inputs.images.3=https://assets.runware.ai/assets/inputs/a973e88d-5d07-4f71-901b-c4fd8e10cfc3.jpg \
  inputs.images.4=https://assets.runware.ai/assets/inputs/fd3127cc-d087-4c66-8caa-fa02d6505e9e.jpg \
  inputs.images.5=https://assets.runware.ai/assets/inputs/5ea84a2e-52c9-4f2a-8515-30ff458f6863.jpg \
  inputs.images.6=https://assets.runware.ai/assets/inputs/7f52f067-796a-4bfc-8d0e-27fc51f25b1c.jpg \
  inputs.images.7=https://assets.runware.ai/assets/inputs/88830cbe-8175-49d0-ad99-521f8ea52c6b.jpg
{
  "taskType": "3dInference",
  "taskUUID": "41b37dd5-5261-470b-a07c-9f10015809cc",
  "model": "tencent:hunyuan-3d@3.1-pro",
  "settings": {
    "faceCount": 1000000,
    "generateType": "Normal",
    "pbr": true
  },
  "inputs": {
    "images": [
      "https://assets.runware.ai/assets/inputs/de50a309-63d3-4ffe-b9c0-7aa382c960cc.jpg",
      "https://assets.runware.ai/assets/inputs/9900e311-d5b8-4226-b010-23567f65d0e6.jpg",
      "https://assets.runware.ai/assets/inputs/f4b266d1-495b-43bc-b82e-80d805e38332.jpg",
      "https://assets.runware.ai/assets/inputs/a973e88d-5d07-4f71-901b-c4fd8e10cfc3.jpg",
      "https://assets.runware.ai/assets/inputs/fd3127cc-d087-4c66-8caa-fa02d6505e9e.jpg",
      "https://assets.runware.ai/assets/inputs/5ea84a2e-52c9-4f2a-8515-30ff458f6863.jpg",
      "https://assets.runware.ai/assets/inputs/7f52f067-796a-4bfc-8d0e-27fc51f25b1c.jpg",
      "https://assets.runware.ai/assets/inputs/88830cbe-8175-49d0-ad99-521f8ea52c6b.jpg"
    ]
  }
}
Response
{
  "taskType": "3dInference",
  "taskUUID": "41b37dd5-5261-470b-a07c-9f10015809cc",
  "seed": 459653716,
  "cost": 0.825,
  "outputs": {
    "files": [
      {
        "uuid": "8f11ec03-61a0-43e4-8c7a-adbe2065d431",
        "url": "https://im.runware.ai/image/os/a03d21/ws/5/ii/8f11ec03-61a0-43e4-8c7a-adbe2065d431.glb"
      }
    ]
  }
}

text-to-3d-pbr

Modern Beekeeping Smoker Product Model$0.675~3m 1s
Try in Playground
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: 'Create a production-ready 3D model of one contemporary handheld beekeeping smoker, fully assembled and mechanically plausible. Feature a cylindrical brushed stainless-steel fire chamber, a hinged conical spout lid, and a perforated butter-yellow powder-coated aluminum heat guard. Attach compact bellows at the rear with pale maple outer boards, a honey-brown vegetable-tanned leather gusset, small brass hinges and fasteners, and a matte black silicone air nozzle. Include realistic seams, folded edges, perforations, hardware, clearances, and subtle manufacturing details. Clean modern agricultural-tool design with softly rounded geometry. Distinct PBR materials with accurate metal roughness, painted finish, wood grain, leather texture, and silicone response. Centered upright product pose, complete geometry on every side, watertight clean topology. No branding, text, smoke, bees, stand, loose parts, or background props.',
  settings: {
    faceCount: 800000,
    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": "Create a production-ready 3D model of one contemporary handheld beekeeping smoker, fully assembled and mechanically plausible. Feature a cylindrical brushed stainless-steel fire chamber, a hinged conical spout lid, and a perforated butter-yellow powder-coated aluminum heat guard. Attach compact bellows at the rear with pale maple outer boards, a honey-brown vegetable-tanned leather gusset, small brass hinges and fasteners, and a matte black silicone air nozzle. Include realistic seams, folded edges, perforations, hardware, clearances, and subtle manufacturing details. Clean modern agricultural-tool design with softly rounded geometry. Distinct PBR materials with accurate metal roughness, painted finish, wood grain, leather texture, and silicone response. Centered upright product pose, complete geometry on every side, watertight clean topology. No branding, text, smoke, bees, stand, loose parts, or background props.",
            "settings": {
                "faceCount": 800000,
                "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": "77429f53-42c5-4136-8026-e579a80d4027",
      "model": "tencent:hunyuan-3d@3.1-pro",
      "positivePrompt": "Create a production-ready 3D model of one contemporary handheld beekeeping smoker, fully assembled and mechanically plausible. Feature a cylindrical brushed stainless-steel fire chamber, a hinged conical spout lid, and a perforated butter-yellow powder-coated aluminum heat guard. Attach compact bellows at the rear with pale maple outer boards, a honey-brown vegetable-tanned leather gusset, small brass hinges and fasteners, and a matte black silicone air nozzle. Include realistic seams, folded edges, perforations, hardware, clearances, and subtle manufacturing details. Clean modern agricultural-tool design with softly rounded geometry. Distinct PBR materials with accurate metal roughness, painted finish, wood grain, leather texture, and silicone response. Centered upright product pose, complete geometry on every side, watertight clean topology. No branding, text, smoke, bees, stand, loose parts, or background props.",
      "settings": {
        "faceCount": 800000,
        "generateType": "Normal",
        "pbr": true
      }
    }
  ]'
runware run tencent:hunyuan-3d@3.1-pro \
  positivePrompt="Create a production-ready 3D model of one contemporary handheld beekeeping smoker, fully assembled and mechanically plausible. Feature a cylindrical brushed stainless-steel fire chamber, a hinged conical spout lid, and a perforated butter-yellow powder-coated aluminum heat guard. Attach compact bellows at the rear with pale maple outer boards, a honey-brown vegetable-tanned leather gusset, small brass hinges and fasteners, and a matte black silicone air nozzle. Include realistic seams, folded edges, perforations, hardware, clearances, and subtle manufacturing details. Clean modern agricultural-tool design with softly rounded geometry. Distinct PBR materials with accurate metal roughness, painted finish, wood grain, leather texture, and silicone response. Centered upright product pose, complete geometry on every side, watertight clean topology. No branding, text, smoke, bees, stand, loose parts, or background props." \
  settings.faceCount=800000 \
  settings.generateType=Normal \
  settings.pbr=true
{
  "taskType": "3dInference",
  "taskUUID": "77429f53-42c5-4136-8026-e579a80d4027",
  "model": "tencent:hunyuan-3d@3.1-pro",
  "positivePrompt": "Create a production-ready 3D model of one contemporary handheld beekeeping smoker, fully assembled and mechanically plausible. Feature a cylindrical brushed stainless-steel fire chamber, a hinged conical spout lid, and a perforated butter-yellow powder-coated aluminum heat guard. Attach compact bellows at the rear with pale maple outer boards, a honey-brown vegetable-tanned leather gusset, small brass hinges and fasteners, and a matte black silicone air nozzle. Include realistic seams, folded edges, perforations, hardware, clearances, and subtle manufacturing details. Clean modern agricultural-tool design with softly rounded geometry. Distinct PBR materials with accurate metal roughness, painted finish, wood grain, leather texture, and silicone response. Centered upright product pose, complete geometry on every side, watertight clean topology. No branding, text, smoke, bees, stand, loose parts, or background props.",
  "settings": {
    "faceCount": 800000,
    "generateType": "Normal",
    "pbr": true
  }
}
Response
{
  "taskType": "3dInference",
  "taskUUID": "77429f53-42c5-4136-8026-e579a80d4027",
  "seed": 1039169582,
  "cost": 0.675,
  "outputs": {
    "files": [
      {
        "uuid": "39be8be6-7524-4dc9-8a3b-d55532c8d9cb",
        "url": "https://im.runware.ai/image/os/a09dlim3/ws/5/ii/39be8be6-7524-4dc9-8a3b-d55532c8d9cb.glb"
      }
    ]
  }
}
Ask AI
Send feedback