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

Authentication

Required (Bearer Token)

Request Parameters

Parameter	Type	Default	Description
`prompt`	String	Required	Primary text prompt. Minimum length: 3 characters.
`negative_prompt`	String	None	Optional negative prompt to steer outputs away from undesired elements.
`polygon_limit`	Integer	`1,000,000`	Polygon limit. Valid range: 1,000 to 1,500,000.
`texture_size`	Integer	`1024`	Texture resolution. Valid range: 1024 to 4096.
`turbo`	Boolean	`false`	Enables faster geometry generation by using the Turbo path; output quality may be lower.
`client_order_id`	String	None	Optional idempotency key. When provided, it must be unique per user and 1-64 characters using only letters, numbers, underscores, or hyphens.
`allow_duplicate`	Boolean	None	Set to `true` to intentionally resubmit a request that would otherwise match the short duplicate window.

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,
  "turbo": false,
  "client_order_id": "text-model-example-001"
}'

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,
      turbo: false,
    }),
  },
);
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,
        "turbo": False,
    },
)
print(response.json())

Text to Geometry (Mesh Only)

Generates a mesh-only model based on a text prompt.

Endpoint

POST /tasks/text-to-mesh