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.

API Reference
INTEGRATE
Complete technical specification for integration
RequestResponse
Examples6
CODE
Ready-to-use code snippets for common workflows
text-to-3d
Touring Opera Storm Machine Set$0.225~1m 47simport { 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: 'Single freestanding touring-opera storm machine set piece: circular copper thunder drum on charred oak rolling scaffold, spiral stairs, rain chains, footlights; complete 360° geometry, PBR.',
settings: {
geometryOnly: false,
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-rapid",
"positivePrompt": "Single freestanding touring-opera storm machine set piece: circular copper thunder drum on charred oak rolling scaffold, spiral stairs, rain chains, footlights; complete 360° geometry, PBR.",
"settings": {
"geometryOnly": False,
"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": "e82066fa-dbc7-46ac-9c5c-917435b3279c",
"model": "tencent:hunyuan-3d@3.1-rapid",
"positivePrompt": "Single freestanding touring-opera storm machine set piece: circular copper thunder drum on charred oak rolling scaffold, spiral stairs, rain chains, footlights; complete 360° geometry, PBR.",
"settings": {
"geometryOnly": false,
"pbr": false
}
}
]'runware run tencent:hunyuan-3d@3.1-rapid \
positivePrompt="Single freestanding touring-opera storm machine set piece: circular copper thunder drum on charred oak rolling scaffold, spiral stairs, rain chains, footlights; complete 360° geometry, PBR." \
settings.geometryOnly=false \
settings.pbr=false{
"taskType": "3dInference",
"taskUUID": "e82066fa-dbc7-46ac-9c5c-917435b3279c",
"model": "tencent:hunyuan-3d@3.1-rapid",
"positivePrompt": "Single freestanding touring-opera storm machine set piece: circular copper thunder drum on charred oak rolling scaffold, spiral stairs, rain chains, footlights; complete 360° geometry, PBR.",
"settings": {
"geometryOnly": false,
"pbr": false
}
}Response
{
"taskType": "3dInference",
"taskUUID": "e82066fa-dbc7-46ac-9c5c-917435b3279c",
"seed": 1045214216,
"cost": 0.225,
"outputs": {
"files": [
{
"uuid": "ffc34675-6504-4561-86e2-604a31253e0d",
"url": "https://im.runware.ai/image/os/a09dlim3/ws/5/ii/ffc34675-6504-4561-86e2-604a31253e0d.glb"
}
]
}
}image-to-3d
Abyssal Salvage Sonar Beacon$0.225~1m 2simport { 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: {
geometryOnly: false,
pbr: false
},
inputs: {
image: 'https://assets.runware.ai/assets/inputs/4d7127ad-38a0-45d7-9721-08a52f989db8.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": {
"geometryOnly": False,
"pbr": False
},
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/4d7127ad-38a0-45d7-9721-08a52f989db8.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": "5584715d-3f29-4eab-aa4b-adf80422a002",
"model": "tencent:hunyuan-3d@3.1-rapid",
"settings": {
"geometryOnly": false,
"pbr": false
},
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/4d7127ad-38a0-45d7-9721-08a52f989db8.jpg"
}
}
]'runware run tencent:hunyuan-3d@3.1-rapid \
settings.geometryOnly=false \
settings.pbr=false \
inputs.image=https://assets.runware.ai/assets/inputs/4d7127ad-38a0-45d7-9721-08a52f989db8.jpg{
"taskType": "3dInference",
"taskUUID": "5584715d-3f29-4eab-aa4b-adf80422a002",
"model": "tencent:hunyuan-3d@3.1-rapid",
"settings": {
"geometryOnly": false,
"pbr": false
},
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/4d7127ad-38a0-45d7-9721-08a52f989db8.jpg"
}
}Response
{
"taskType": "3dInference",
"taskUUID": "5584715d-3f29-4eab-aa4b-adf80422a002",
"seed": 1153104280,
"cost": 0.225,
"outputs": {
"files": [
{
"uuid": "d708de09-2cc1-4dfe-8511-d2fa25393f28",
"url": "https://im.runware.ai/image/os/a06dlim3/ws/5/ii/d708de09-2cc1-4dfe-8511-d2fa25393f28.glb"
}
]
}
}text-to-3d-pbr
1970s Pool Admissions Kiosk$0.375~1m 11simport { 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: 'Freestanding 1970s pool admissions kiosk, complete 360° geometry; cream glazed tile, teal painted concrete, brushed steel turnstile, amber glass, ribbed rubber, orange laminate counter.',
settings: {
geometryOnly: false,
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-rapid",
"positivePrompt": "Freestanding 1970s pool admissions kiosk, complete 360° geometry; cream glazed tile, teal painted concrete, brushed steel turnstile, amber glass, ribbed rubber, orange laminate counter.",
"settings": {
"geometryOnly": False,
"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": "0775a8a4-65f2-42a8-a109-fe5033689c7f",
"model": "tencent:hunyuan-3d@3.1-rapid",
"positivePrompt": "Freestanding 1970s pool admissions kiosk, complete 360° geometry; cream glazed tile, teal painted concrete, brushed steel turnstile, amber glass, ribbed rubber, orange laminate counter.",
"settings": {
"geometryOnly": false,
"pbr": true
}
}
]'runware run tencent:hunyuan-3d@3.1-rapid \
positivePrompt="Freestanding 1970s pool admissions kiosk, complete 360° geometry; cream glazed tile, teal painted concrete, brushed steel turnstile, amber glass, ribbed rubber, orange laminate counter." \
settings.geometryOnly=false \
settings.pbr=true{
"taskType": "3dInference",
"taskUUID": "0775a8a4-65f2-42a8-a109-fe5033689c7f",
"model": "tencent:hunyuan-3d@3.1-rapid",
"positivePrompt": "Freestanding 1970s pool admissions kiosk, complete 360° geometry; cream glazed tile, teal painted concrete, brushed steel turnstile, amber glass, ribbed rubber, orange laminate counter.",
"settings": {
"geometryOnly": false,
"pbr": true
}
}Response
{
"taskType": "3dInference",
"taskUUID": "0775a8a4-65f2-42a8-a109-fe5033689c7f",
"seed": 1303966927,
"cost": 0.375,
"outputs": {
"files": [
{
"uuid": "20fe897f-6adc-4b4a-a7ce-6c2fd313d9d0",
"url": "https://im.runware.ai/image/os/a04d20/ws/5/ii/20fe897f-6adc-4b4a-a7ce-6c2fd313d9d0.glb"
}
]
}
}text-to-3d-geometry-only
Soil Museum Mole Mascot$0.225~20simport { 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: 'Full-body 3D mascot for a soil ecology museum: stout mole scientist with root-layered field cape, lamp helmet, broad digging claws, whiskered snout and ribbed boots; neutral pose.',
settings: {
geometryOnly: 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-rapid",
"positivePrompt": "Full-body 3D mascot for a soil ecology museum: stout mole scientist with root-layered field cape, lamp helmet, broad digging claws, whiskered snout and ribbed boots; neutral pose.",
"settings": {
"geometryOnly": 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": "10f46aba-3428-4f9d-9e1f-5d1e9b18c8a1",
"model": "tencent:hunyuan-3d@3.1-rapid",
"positivePrompt": "Full-body 3D mascot for a soil ecology museum: stout mole scientist with root-layered field cape, lamp helmet, broad digging claws, whiskered snout and ribbed boots; neutral pose.",
"settings": {
"geometryOnly": true
}
}
]'runware run tencent:hunyuan-3d@3.1-rapid \
positivePrompt="Full-body 3D mascot for a soil ecology museum: stout mole scientist with root-layered field cape, lamp helmet, broad digging claws, whiskered snout and ribbed boots; neutral pose." \
settings.geometryOnly=true{
"taskType": "3dInference",
"taskUUID": "10f46aba-3428-4f9d-9e1f-5d1e9b18c8a1",
"model": "tencent:hunyuan-3d@3.1-rapid",
"positivePrompt": "Full-body 3D mascot for a soil ecology museum: stout mole scientist with root-layered field cape, lamp helmet, broad digging claws, whiskered snout and ribbed boots; neutral pose.",
"settings": {
"geometryOnly": true
}
}Response
{
"taskType": "3dInference",
"taskUUID": "10f46aba-3428-4f9d-9e1f-5d1e9b18c8a1",
"seed": 1399770144,
"cost": 0.225,
"outputs": {
"files": [
{
"uuid": "71f3ca70-ddca-4fb8-a21a-50cfedb16767",
"url": "https://im.runware.ai/image/os/a08dlim3/ws/4/ii/71f3ca70-ddca-4fb8-a21a-50cfedb16767.glb"
}
]
}
}image-to-3d-pbr
Antarctic Seed Vault Entry Set$0.375~1m 8simport { 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: {
geometryOnly: false,
pbr: true
},
inputs: {
image: 'https://assets.runware.ai/assets/inputs/3fcfbec1-5897-41a5-a62d-4889144a3af7.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": {
"geometryOnly": False,
"pbr": True
},
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/3fcfbec1-5897-41a5-a62d-4889144a3af7.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": "651b76c8-c1f1-4209-8e13-f4c3117126d6",
"model": "tencent:hunyuan-3d@3.1-rapid",
"settings": {
"geometryOnly": false,
"pbr": true
},
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/3fcfbec1-5897-41a5-a62d-4889144a3af7.jpg"
}
}
]'runware run tencent:hunyuan-3d@3.1-rapid \
settings.geometryOnly=false \
settings.pbr=true \
inputs.image=https://assets.runware.ai/assets/inputs/3fcfbec1-5897-41a5-a62d-4889144a3af7.jpg{
"taskType": "3dInference",
"taskUUID": "651b76c8-c1f1-4209-8e13-f4c3117126d6",
"model": "tencent:hunyuan-3d@3.1-rapid",
"settings": {
"geometryOnly": false,
"pbr": true
},
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/3fcfbec1-5897-41a5-a62d-4889144a3af7.jpg"
}
}Response
{
"taskType": "3dInference",
"taskUUID": "651b76c8-c1f1-4209-8e13-f4c3117126d6",
"seed": 188966631,
"cost": 0.375,
"outputs": {
"files": [
{
"uuid": "c018c712-5a24-4703-9c2c-b487e88a8b79",
"url": "https://im.runware.ai/image/os/a09dlim3/ws/5/ii/c018c712-5a24-4703-9c2c-b487e88a8b79.glb"
}
]
}
}image-to-3d-geometry-only
Pediatric MRI Training Cabin$0.225~22simport { 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: {
geometryOnly: true
},
inputs: {
image: 'https://assets.runware.ai/assets/inputs/19cacdd6-41a0-4d84-9a8c-2e847f32802b.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": {
"geometryOnly": True
},
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/19cacdd6-41a0-4d84-9a8c-2e847f32802b.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": "0bb8a88c-5b08-4f8d-94ba-7ce8848bd5c5",
"model": "tencent:hunyuan-3d@3.1-rapid",
"settings": {
"geometryOnly": true
},
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/19cacdd6-41a0-4d84-9a8c-2e847f32802b.jpg"
}
}
]'runware run tencent:hunyuan-3d@3.1-rapid \
settings.geometryOnly=true \
inputs.image=https://assets.runware.ai/assets/inputs/19cacdd6-41a0-4d84-9a8c-2e847f32802b.jpg{
"taskType": "3dInference",
"taskUUID": "0bb8a88c-5b08-4f8d-94ba-7ce8848bd5c5",
"model": "tencent:hunyuan-3d@3.1-rapid",
"settings": {
"geometryOnly": true
},
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/19cacdd6-41a0-4d84-9a8c-2e847f32802b.jpg"
}
}Response
{
"taskType": "3dInference",
"taskUUID": "0bb8a88c-5b08-4f8d-94ba-7ce8848bd5c5",
"seed": 1198787627,
"cost": 0.225,
"outputs": {
"files": [
{
"uuid": "4b8c9136-7879-476e-b3a9-a0d28ac4d678",
"url": "https://im.runware.ai/image/os/a07dlim3/ws/4/ii/4b8c9136-7879-476e-b3a9-a0d28ac4d678.glb"
}
]
}
}