TRIVERSE Docs
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

ParameterTypeDefaultDescription
promptStringRequiredDetailed description of the object you want to generate.
negative_promptStringNoneElements you want to exclude from the generation.
polygon_limitInteger1,000,000Maximum polygon count (Range: 1k - 10M).
texture_sizeInteger1024Texture 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

ParameterTypeDefaultDescription
promptStringRequiredDescription of the object's shape and structure.
negative_promptStringNoneShapes or features to avoid.
polygon_limitInteger1,000,000Target 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".

On this page