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
Examples5
CODE
Ready-to-use code snippets for common workflows
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
}
}{
"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"
}
]
}
}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
}
}{
"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"
}
]
}
}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"
}
}{
"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"
}
]
}
}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
}
}{
"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"
}
]
}
}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"
}
}{
"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"
}
]
}
}