Testo in modello 3D

POST /v3/generation/text-to-model

Genera un modello 3D da un messaggio di testo.

Richiedi parametri

Richiedi intestazioni

Parametro	Digitare	Obbligatorio	Predefinito	Descrizione
Content-Type	stringa	Sì	-	`application/json`
Authorization	stringa	Sì	-	`Bearer {api_key}`

Richiedi corpo

Parametro	Digitare	Obbligatorio	Predefinito	Descrizione
prompt	stringa	Sì	-	Richiesta di testo, fino a 1024 caratteri
model	stringa	No	`tripo-v3.1`	Versione modello AI. Valori supportati: `tripo-p1`, `tripo-turbo`, `tripo-v3.1`, `tripo-v3.0`, `tripo-v2.5`, `tripo-v2.0`
negative_prompt	stringa	No	-	Prompt negativo, fino a 255 caratteri
model_seed	intero	No	Casuale	Seme casuale per la generazione della geometria
image_seed	intero	No	Casuale	Seme casuale per la fase da testo a immagine
face_limit	intero	No	Adattivo	Numero massimo di poligoni per l’output
texture	booleano	No	`true`	Abilita mappe texture
pbr	booleano	No	`true`	Abilita materiali PBR. Quando abilitato, `texture` è forzato su `true`
texture_seed	intero	No	Casuale	Seme casuale per la generazione di texture
texture_quality	stringa	No	`standard`	Qualità della trama. Valori supportati: `standard`, `detailed`, `extreme`
geometry_quality	stringa	No	`standard`	Qualità della geometria. `standard` (bilanciato), `detailed` (modalità Ultra)
auto_size	booleano	No	`false`	Ridimensiona automaticamente il modello alle dimensioni reali in metri
quad	booleano	No	`false`	Produci una mesh quadrupla. Quando abilitato, il formato di output viene forzato su FBX
smart_low_poly	booleano	No	`false`	Genera un modello low-poly con stile topologico realizzato a mano
generate_parts	booleano	No	`false`	Genera parti segmentate modificabili. Si escludono a vicenda con `texture=true`, `pbr=true` e `quad=true`
compress	stringa	No	-	Tipo di compressione. `geometry` (compressione meshopt)

I seguenti parametri sono validi solo quando model >= tripo-v3.0: texture_quality, geometry_quality, auto_size, quad, smart_low_poly, generate_parts, compress.

Richiedi esempi

-cmd">curl -X POST https://openapi.tripo3d.ai/v3/generation/text class="hl-flag">-to-model \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer {api_key}" \
  -d '{
    "prompt": "A cat wearing a spacesuit",
    "model": "tripo-v3.1",
    "texture": true,
    "pbr": true,
    "texture_quality": "detailed"}'

import requests

url = "https://openapi.tripo3d.ai/v3/generation/text-to-model"
headers = {
    "Content-Type": "application/json",
    "Authorization": "Bearer {api_key}"
}
payload = {
    "prompt": "A cat wearing a spacesuit",
    "model": "tripo-v3.1",
    "texture": True,
    "pbr": True,
    "texture_quality": "detailed"
}

response = requests.post(url, headers=headers, json=payload)
print(response.json())

const url = "https://openapi.tripo3d.ai/v3/generation/text-to-model";

const response = await fetch(url, {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "Bearer {api_key}"
  },
  body: JSON.stringify({
    prompt: "A cat wearing a spacesuit",
    model: "tripo-v3.1",
    texture: true,
    pbr: true,
    texture_quality: "detailed"
  })
});

const data = await response.json();
console.log(data);

Risposta

Risposta di successo

JSON

{
  "code": 0,
  "data": {
    "task_id": "task_abc123"}
}

Campi di risposta

Parametro	Digitare	Descrizione
code	intero	Codice di stato. `0` indica successo
data.task_id	stringa	Identificatore univoco dell’attività utilizzato per interrogare l’avanzamento e i risultati della generazione

Codici di errore

HTTP Codice di stato	Codice errore	Descrizione	Raccomandazione
429	2000	Limite di generazione superato	Ridurre la frequenza delle richieste e riprovare più tardi
400	2002	Parametro di richiesta non supportato	Controllare i nomi dei parametri del corpo della richiesta e gli intervalli di valori
400	2008	L’input viola le norme sui contenuti	Rivedi la richiesta e rimuovi le descrizioni che violano le policy
403	2010	Crediti insufficienti	Aggiungi crediti e riprova
400	2015	Versione del modello deprecata	Aggiorna `model` a una versione attualmente supportata
400	2018	Il modello è troppo complesso per essere rimesh	Abbassa `face_limit` o semplifica la richiesta di input