Tripo 3D v3.1

Tripo 3D v3.1 is a high-fidelity 3D generation model that creates production-ready 3D assets from text prompts or images. It delivers enhanced detail, stronger geometry precision, and improved texture quality compared to earlier versions, with support for PBR materials and export in GLB, FBX, OBJ, and STL formats.

API Reference
INTEGRATE
Complete technical specification for integration
RequestResponse
Examples4
CODE
Ready-to-use code snippets for common workflows
Lacquered Koi Mask 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: 'tripo:v3.1@0',
seed: 74779,
settings: {
imageAutoFix: true,
orientation: 'align_image',
geometryQuality: 'detailed',
texture: true,
textureQuality: 'detailed',
textureAlignment: 'geometry',
pbr: true,
exportUv: true,
compress: 'meshopt',
autoSize: true,
faceLimit: 12000
},
inputs: {
images: [
'https://assets.runware.ai/assets/inputs/f1d2e611-78bd-4bee-ba1c-143ec5100a22.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": "tripo:v3.1@0",
"seed": 74779,
"settings": {
"imageAutoFix": True,
"orientation": "align_image",
"geometryQuality": "detailed",
"texture": True,
"textureQuality": "detailed",
"textureAlignment": "geometry",
"pbr": True,
"exportUv": True,
"compress": "meshopt",
"autoSize": True,
"faceLimit": 12000
},
"inputs": {
"images": [
"https://assets.runware.ai/assets/inputs/f1d2e611-78bd-4bee-ba1c-143ec5100a22.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": "21f2d643-11b5-4ec3-8148-4e271571047a",
"model": "tripo:v3.1@0",
"seed": 74779,
"settings": {
"imageAutoFix": true,
"orientation": "align_image",
"geometryQuality": "detailed",
"texture": true,
"textureQuality": "detailed",
"textureAlignment": "geometry",
"pbr": true,
"exportUv": true,
"compress": "meshopt",
"autoSize": true,
"faceLimit": 12000
},
"inputs": {
"images": [
"https://assets.runware.ai/assets/inputs/f1d2e611-78bd-4bee-ba1c-143ec5100a22.jpg"
]
}
}
]'runware run tripo:v3.1@0 \
seed=74779 \
settings.imageAutoFix=true \
settings.orientation=align_image \
settings.geometryQuality=detailed \
settings.texture=true \
settings.textureQuality=detailed \
settings.textureAlignment=geometry \
settings.pbr=true \
settings.exportUv=true \
settings.compress=meshopt \
settings.autoSize=true \
settings.faceLimit=12000 \
inputs.images.0=https://assets.runware.ai/assets/inputs/f1d2e611-78bd-4bee-ba1c-143ec5100a22.jpg{
"taskType": "3dInference",
"taskUUID": "21f2d643-11b5-4ec3-8148-4e271571047a",
"model": "tripo:v3.1@0",
"seed": 74779,
"settings": {
"imageAutoFix": true,
"orientation": "align_image",
"geometryQuality": "detailed",
"texture": true,
"textureQuality": "detailed",
"textureAlignment": "geometry",
"pbr": true,
"exportUv": true,
"compress": "meshopt",
"autoSize": true,
"faceLimit": 12000
},
"inputs": {
"images": [
"https://assets.runware.ai/assets/inputs/f1d2e611-78bd-4bee-ba1c-143ec5100a22.jpg"
]
}
}{
"taskType": "3dInference",
"taskUUID": "21f2d643-11b5-4ec3-8148-4e271571047a",
"seed": 74779,
"cost": 0.6,
"outputs": {
"files": [
{
"uuid": "bddff57a-9e26-4c73-9f23-13bdf071c4df",
"url": "https://im.runware.ai/image/os/a04d20/ws/4/ii/bddff57a-9e26-4c73-9f23-13bdf071c4df.glb"
}
]
}
}Gilded Moth Duchess 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: 'tripo:v3.1@0',
seed: 38240,
settings: {
imageAutoFix: true,
orientation: 'align_image',
autoSize: true,
compress: 'meshopt',
exportUv: true,
geometryQuality: 'detailed',
pbr: true,
quad: false,
texture: true,
textureAlignment: 'geometry',
textureQuality: 'detailed',
textureSeed: 38240,
faceLimit: 20000
},
inputs: {
images: [
'https://assets.runware.ai/assets/inputs/44073159-7756-4d6c-be8a-4f7f98142b24.jpg',
'https://assets.runware.ai/assets/inputs/f0e3803d-0efe-42a2-8d5c-08a8e925009b.jpg',
'https://assets.runware.ai/assets/inputs/8f990896-5657-452f-8813-5738d313295e.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": "tripo:v3.1@0",
"seed": 38240,
"settings": {
"imageAutoFix": True,
"orientation": "align_image",
"autoSize": True,
"compress": "meshopt",
"exportUv": True,
"geometryQuality": "detailed",
"pbr": True,
"quad": False,
"texture": True,
"textureAlignment": "geometry",
"textureQuality": "detailed",
"textureSeed": 38240,
"faceLimit": 20000
},
"inputs": {
"images": [
"https://assets.runware.ai/assets/inputs/44073159-7756-4d6c-be8a-4f7f98142b24.jpg",
"https://assets.runware.ai/assets/inputs/f0e3803d-0efe-42a2-8d5c-08a8e925009b.jpg",
"https://assets.runware.ai/assets/inputs/8f990896-5657-452f-8813-5738d313295e.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": "54cb0887-7f0e-451e-9e5e-81825d318d9c",
"model": "tripo:v3.1@0",
"seed": 38240,
"settings": {
"imageAutoFix": true,
"orientation": "align_image",
"autoSize": true,
"compress": "meshopt",
"exportUv": true,
"geometryQuality": "detailed",
"pbr": true,
"quad": false,
"texture": true,
"textureAlignment": "geometry",
"textureQuality": "detailed",
"textureSeed": 38240,
"faceLimit": 20000
},
"inputs": {
"images": [
"https://assets.runware.ai/assets/inputs/44073159-7756-4d6c-be8a-4f7f98142b24.jpg",
"https://assets.runware.ai/assets/inputs/f0e3803d-0efe-42a2-8d5c-08a8e925009b.jpg",
"https://assets.runware.ai/assets/inputs/8f990896-5657-452f-8813-5738d313295e.jpg"
]
}
}
]'runware run tripo:v3.1@0 \
seed=38240 \
settings.imageAutoFix=true \
settings.orientation=align_image \
settings.autoSize=true \
settings.compress=meshopt \
settings.exportUv=true \
settings.geometryQuality=detailed \
settings.pbr=true \
settings.quad=false \
settings.texture=true \
settings.textureAlignment=geometry \
settings.textureQuality=detailed \
settings.textureSeed=38240 \
settings.faceLimit=20000 \
inputs.images.0=https://assets.runware.ai/assets/inputs/44073159-7756-4d6c-be8a-4f7f98142b24.jpg \
inputs.images.1=https://assets.runware.ai/assets/inputs/f0e3803d-0efe-42a2-8d5c-08a8e925009b.jpg \
inputs.images.2=https://assets.runware.ai/assets/inputs/8f990896-5657-452f-8813-5738d313295e.jpg{
"taskType": "3dInference",
"taskUUID": "54cb0887-7f0e-451e-9e5e-81825d318d9c",
"model": "tripo:v3.1@0",
"seed": 38240,
"settings": {
"imageAutoFix": true,
"orientation": "align_image",
"autoSize": true,
"compress": "meshopt",
"exportUv": true,
"geometryQuality": "detailed",
"pbr": true,
"quad": false,
"texture": true,
"textureAlignment": "geometry",
"textureQuality": "detailed",
"textureSeed": 38240,
"faceLimit": 20000
},
"inputs": {
"images": [
"https://assets.runware.ai/assets/inputs/44073159-7756-4d6c-be8a-4f7f98142b24.jpg",
"https://assets.runware.ai/assets/inputs/f0e3803d-0efe-42a2-8d5c-08a8e925009b.jpg",
"https://assets.runware.ai/assets/inputs/8f990896-5657-452f-8813-5738d313295e.jpg"
]
}
}{
"taskType": "3dInference",
"taskUUID": "54cb0887-7f0e-451e-9e5e-81825d318d9c",
"seed": 38240,
"cost": 0.6,
"outputs": {
"files": [
{
"uuid": "f839287d-6b9f-474c-ac1c-9c1f6dd0f9f9",
"url": "https://im.runware.ai/image/os/a03d21/ws/4/ii/f839287d-6b9f-474c-ac1c-9c1f6dd0f9f9.glb"
}
]
}
}Art Deco Rocket Radio
import { createClient } from '@runware/sdk'
const client = await createClient({ apiKey: process.env.RUNWARE_API_KEY })
await client.connect()
const [result] = await client.run({
model: 'tripo:v3.1@0',
positivePrompt: 'A collectible 1930s-inspired tabletop radio shaped like a streamlined rocket, polished walnut body with brushed brass trim, circular analog tuner dial, ridged side fins, small antenna, woven speaker grille, ivory knobs, subtle scratches and realistic wear, elegant art deco ornamentation, centered single object, studio-style neutral presentation, highly detailed hard-surface model, accurate proportions, game-ready asset',
negativePrompt: 'background clutter, multiple objects, humans, text labels, broken geometry, floating parts, asymmetry, blur, low detail',
seed: 82382,
settings: {
autoSize: true,
compress: 'meshopt',
exportUv: true,
faceLimit: 12000,
geometryQuality: 'detailed',
pbr: true,
quad: false,
texture: true,
textureQuality: 'detailed',
textureSeed: 82382
}
})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": "tripo:v3.1@0",
"positivePrompt": "A collectible 1930s-inspired tabletop radio shaped like a streamlined rocket, polished walnut body with brushed brass trim, circular analog tuner dial, ridged side fins, small antenna, woven speaker grille, ivory knobs, subtle scratches and realistic wear, elegant art deco ornamentation, centered single object, studio-style neutral presentation, highly detailed hard-surface model, accurate proportions, game-ready asset",
"negativePrompt": "background clutter, multiple objects, humans, text labels, broken geometry, floating parts, asymmetry, blur, low detail",
"seed": 82382,
"settings": {
"autoSize": True,
"compress": "meshopt",
"exportUv": True,
"faceLimit": 12000,
"geometryQuality": "detailed",
"pbr": True,
"quad": False,
"texture": True,
"textureQuality": "detailed",
"textureSeed": 82382
}
})
asyncio.run(main())curl https://api.runware.ai/v1 \
-H "Authorization: Bearer $RUNWARE_API_KEY" \
-H "Content-Type: application/json" \
-d '[
{
"taskType": "3dInference",
"taskUUID": "9fab2b1d-664e-45af-91b5-2c90ec240b8e",
"model": "tripo:v3.1@0",
"positivePrompt": "A collectible 1930s-inspired tabletop radio shaped like a streamlined rocket, polished walnut body with brushed brass trim, circular analog tuner dial, ridged side fins, small antenna, woven speaker grille, ivory knobs, subtle scratches and realistic wear, elegant art deco ornamentation, centered single object, studio-style neutral presentation, highly detailed hard-surface model, accurate proportions, game-ready asset",
"negativePrompt": "background clutter, multiple objects, humans, text labels, broken geometry, floating parts, asymmetry, blur, low detail",
"seed": 82382,
"settings": {
"autoSize": true,
"compress": "meshopt",
"exportUv": true,
"faceLimit": 12000,
"geometryQuality": "detailed",
"pbr": true,
"quad": false,
"texture": true,
"textureQuality": "detailed",
"textureSeed": 82382
}
}
]'runware run tripo:v3.1@0 \
positivePrompt="A collectible 1930s-inspired tabletop radio shaped like a streamlined rocket, polished walnut body with brushed brass trim, circular analog tuner dial, ridged side fins, small antenna, woven speaker grille, ivory knobs, subtle scratches and realistic wear, elegant art deco ornamentation, centered single object, studio-style neutral presentation, highly detailed hard-surface model, accurate proportions, game-ready asset" \
negativePrompt="background clutter, multiple objects, humans, text labels, broken geometry, floating parts, asymmetry, blur, low detail" \
seed=82382 \
settings.autoSize=true \
settings.compress=meshopt \
settings.exportUv=true \
settings.faceLimit=12000 \
settings.geometryQuality=detailed \
settings.pbr=true \
settings.quad=false \
settings.texture=true \
settings.textureQuality=detailed \
settings.textureSeed=82382{
"taskType": "3dInference",
"taskUUID": "9fab2b1d-664e-45af-91b5-2c90ec240b8e",
"model": "tripo:v3.1@0",
"positivePrompt": "A collectible 1930s-inspired tabletop radio shaped like a streamlined rocket, polished walnut body with brushed brass trim, circular analog tuner dial, ridged side fins, small antenna, woven speaker grille, ivory knobs, subtle scratches and realistic wear, elegant art deco ornamentation, centered single object, studio-style neutral presentation, highly detailed hard-surface model, accurate proportions, game-ready asset",
"negativePrompt": "background clutter, multiple objects, humans, text labels, broken geometry, floating parts, asymmetry, blur, low detail",
"seed": 82382,
"settings": {
"autoSize": true,
"compress": "meshopt",
"exportUv": true,
"faceLimit": 12000,
"geometryQuality": "detailed",
"pbr": true,
"quad": false,
"texture": true,
"textureQuality": "detailed",
"textureSeed": 82382
}
}{
"taskType": "3dInference",
"taskUUID": "9fab2b1d-664e-45af-91b5-2c90ec240b8e",
"seed": 82382,
"cost": 0.5,
"outputs": {
"files": [
{
"uuid": "470013e9-f226-49b6-ac19-c317eccdf8c3",
"url": "https://im.runware.ai/image/os/a08dlim3/ws/4/ii/470013e9-f226-49b6-ac19-c317eccdf8c3.glb"
}
]
}
}Baroque Coral Diving Helmet
import { createClient } from '@runware/sdk'
const client = await createClient({ apiKey: process.env.RUNWARE_API_KEY })
await client.connect()
const [result] = await client.run({
model: 'tripo:v3.1@0',
positivePrompt: 'An ornate antique deep-sea diving helmet reimagined as a baroque relic, bulbous brass dome with engraved coral and seashell motifs, ribbed metal collar, heavy glass viewports, turquoise oxidation, tiny barnacle clusters, worn leather gasket seams, embossed filigree, believable screws and hinges, museum-quality hero object, isolated clean background, centered single asset, rich material contrast, highly dimensional silhouette, production-ready 3D prop',
negativePrompt: 'human figure, body, underwater scene, environment, text, watermark, blurry, low detail, broken geometry, extra objects',
seed: 84325,
settings: {
autoSize: true,
compress: 'meshopt',
exportUv: true,
geometryQuality: 'detailed',
orientation: 'default',
pbr: true,
quad: false,
texture: true,
textureQuality: 'detailed',
textureSeed: 84325,
faceLimit: 18000
}
})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": "tripo:v3.1@0",
"positivePrompt": "An ornate antique deep-sea diving helmet reimagined as a baroque relic, bulbous brass dome with engraved coral and seashell motifs, ribbed metal collar, heavy glass viewports, turquoise oxidation, tiny barnacle clusters, worn leather gasket seams, embossed filigree, believable screws and hinges, museum-quality hero object, isolated clean background, centered single asset, rich material contrast, highly dimensional silhouette, production-ready 3D prop",
"negativePrompt": "human figure, body, underwater scene, environment, text, watermark, blurry, low detail, broken geometry, extra objects",
"seed": 84325,
"settings": {
"autoSize": True,
"compress": "meshopt",
"exportUv": True,
"geometryQuality": "detailed",
"orientation": "default",
"pbr": True,
"quad": False,
"texture": True,
"textureQuality": "detailed",
"textureSeed": 84325,
"faceLimit": 18000
}
})
asyncio.run(main())curl https://api.runware.ai/v1 \
-H "Authorization: Bearer $RUNWARE_API_KEY" \
-H "Content-Type: application/json" \
-d '[
{
"taskType": "3dInference",
"taskUUID": "86c22651-3fc7-44d0-b3e0-a09407ec586c",
"model": "tripo:v3.1@0",
"positivePrompt": "An ornate antique deep-sea diving helmet reimagined as a baroque relic, bulbous brass dome with engraved coral and seashell motifs, ribbed metal collar, heavy glass viewports, turquoise oxidation, tiny barnacle clusters, worn leather gasket seams, embossed filigree, believable screws and hinges, museum-quality hero object, isolated clean background, centered single asset, rich material contrast, highly dimensional silhouette, production-ready 3D prop",
"negativePrompt": "human figure, body, underwater scene, environment, text, watermark, blurry, low detail, broken geometry, extra objects",
"seed": 84325,
"settings": {
"autoSize": true,
"compress": "meshopt",
"exportUv": true,
"geometryQuality": "detailed",
"orientation": "default",
"pbr": true,
"quad": false,
"texture": true,
"textureQuality": "detailed",
"textureSeed": 84325,
"faceLimit": 18000
}
}
]'runware run tripo:v3.1@0 \
positivePrompt="An ornate antique deep-sea diving helmet reimagined as a baroque relic, bulbous brass dome with engraved coral and seashell motifs, ribbed metal collar, heavy glass viewports, turquoise oxidation, tiny barnacle clusters, worn leather gasket seams, embossed filigree, believable screws and hinges, museum-quality hero object, isolated clean background, centered single asset, rich material contrast, highly dimensional silhouette, production-ready 3D prop" \
negativePrompt="human figure, body, underwater scene, environment, text, watermark, blurry, low detail, broken geometry, extra objects" \
seed=84325 \
settings.autoSize=true \
settings.compress=meshopt \
settings.exportUv=true \
settings.geometryQuality=detailed \
settings.orientation=default \
settings.pbr=true \
settings.quad=false \
settings.texture=true \
settings.textureQuality=detailed \
settings.textureSeed=84325 \
settings.faceLimit=18000{
"taskType": "3dInference",
"taskUUID": "86c22651-3fc7-44d0-b3e0-a09407ec586c",
"model": "tripo:v3.1@0",
"positivePrompt": "An ornate antique deep-sea diving helmet reimagined as a baroque relic, bulbous brass dome with engraved coral and seashell motifs, ribbed metal collar, heavy glass viewports, turquoise oxidation, tiny barnacle clusters, worn leather gasket seams, embossed filigree, believable screws and hinges, museum-quality hero object, isolated clean background, centered single asset, rich material contrast, highly dimensional silhouette, production-ready 3D prop",
"negativePrompt": "human figure, body, underwater scene, environment, text, watermark, blurry, low detail, broken geometry, extra objects",
"seed": 84325,
"settings": {
"autoSize": true,
"compress": "meshopt",
"exportUv": true,
"geometryQuality": "detailed",
"orientation": "default",
"pbr": true,
"quad": false,
"texture": true,
"textureQuality": "detailed",
"textureSeed": 84325,
"faceLimit": 18000
}
}{
"taskType": "3dInference",
"taskUUID": "86c22651-3fc7-44d0-b3e0-a09407ec586c",
"seed": 84325,
"cost": 0.5,
"outputs": {
"files": [
{
"uuid": "f9ec4e9d-42b9-43a3-8f8a-df52423c006b",
"url": "https://im.runware.ai/image/os/a01d21/ws/4/ii/f9ec4e9d-42b9-43a3-8f8a-df52423c006b.glb"
}
]
}
}