API Endpoints
Text to 3D
Generate 3D assets directly from natural language descriptions. This powerful feature allows you to create models and textures without needing any source images.
Text to Textured Model
Creates a fully textured 3D model based on your text prompt.
Endpoint
POST /tasks/text-to-model
Request Parameters
| Parameter | Type | Default | Description |
|---|---|---|---|
prompt | String | Required | Detailed description of the object you want to generate. |
negative_prompt | String | None | Elements you want to exclude from the generation. |
polygon_limit | Integer | 1,000,000 | Maximum polygon count (Range: 1k - 10M). |
texture_size | Integer | 1024 | Texture resolution (Range: 1024 - 4096). |
Example Request
cURL
curl -X 'POST' \
'https://api.triverse.ai/api/v1/tasks/text-to-model' \
-H 'accept: application/json' \
-H 'Authorization: Bearer <YOUR_API_KEY>' \
-H 'Content-Type: application/json' \
-d '{
"prompt": "A sci-fi hover bike with neon trims",
"negative_prompt": "low quality, blurry",
"polygon_limit": 1000000,
"texture_size": 1024
}'JavaScript
const response = await fetch(
"https://api.triverse.ai/api/v1/tasks/text-to-model",
{
method: "POST",
headers: {
Accept: "application/json",
Authorization: "Bearer <YOUR_API_KEY>",
"Content-Type": "application/json",
},
body: JSON.stringify({
prompt: "A sci-fi hover bike with neon trims",
negative_prompt: "low quality, blurry",
polygon_limit: 1000000,
texture_size: 1024,
}),
}
);
const data = await response.json();
console.log(data);Python
import requests
response = requests.post(
"https://api.triverse.ai/api/v1/tasks/text-to-model",
headers={
"Accept": "application/json",
"Authorization": "Bearer <YOUR_API_KEY>",
},
json={
"prompt": "A sci-fi hover bike with neon trims",
"negative_prompt": "low quality, blurry",
"polygon_limit": 1000000,
"texture_size": 1024,
},
)
print(response.json())Text to Geometry (Mesh Only)
Generates a mesh-only model based on a text prompt.
Endpoint
POST /tasks/text-to-mesh
Request Parameters
| Parameter | Type | Default | Description |
|---|---|---|---|
prompt | String | Required | Description of the object's shape and structure. |
negative_prompt | String | None | Shapes or features to avoid. |
polygon_limit | Integer | 1,000,000 | Target polygon count. |
Example Request
cURL
curl -X 'POST' \
'https://api.triverse.ai/api/v1/tasks/text-to-mesh' \
-H 'accept: application/json' \
-H 'Authorization: Bearer <YOUR_API_KEY>' \
-H 'Content-Type: application/json' \
-d '{
"prompt": "Ancient stone statue of a warrior",
"polygon_limit": 1000000
}'JavaScript
const response = await fetch(
"https://api.triverse.ai/api/v1/tasks/text-to-mesh",
{
method: "POST",
headers: {
Accept: "application/json",
Authorization: "Bearer <YOUR_API_KEY>",
"Content-Type": "application/json",
},
body: JSON.stringify({
prompt: "Ancient stone statue of a warrior",
polygon_limit: 1000000,
}),
}
);
const data = await response.json();
console.log(data);Python
import requests
response = requests.post(
"https://api.triverse.ai/api/v1/tasks/text-to-mesh",
headers={
"Accept": "application/json",
"Authorization": "Bearer <YOUR_API_KEY>",
},
json={
"prompt": "Ancient stone statue of a warrior",
"polygon_limit": 1000000,
},
)
print(response.json())Prompting Tips
To get the best results from Text to 3D, consider the following:
- Be Specific: Instead of "a chair", try "a mid-century modern lounge chair with walnut legs and leather upholstery".
- Define Style: Mention styles like "stylized", "photorealistic", "low-poly", or "voxel art".
- Lighting & Material: Describe materials like "brushed metal", "translucent glass", or "matte plastic".
- Use Negative Prompts: Use negative prompts to remove unwanted artifacts like "blurry", "distorted", or "extra limbs".