Text zum 3D-Modell

POST /v3/generation/text-to-model

Generieren Sie ein 3D-Modell aus einer Texteingabeaufforderung.

Anforderungsparameter

Anforderungsheader

Parameter	Typ	Erforderlich	Standard	Beschreibung
Content-Type	Zeichenfolge	Ja	-	`application/json`
Authorization	Zeichenfolge	Ja	-	`Bearer {api_key}`

Anforderungstext

Parameter	Typ	Erforderlich	Standard	Beschreibung
prompt	Zeichenfolge	Ja	-	Textaufforderung, bis zu 1024 Zeichen
model	Zeichenfolge	Nein	`tripo-v3.1`	Modellversion AI. Unterstützte Werte: `tripo-p1`, `tripo-turbo`, `tripo-v3.1`, `tripo-v3.0`, `tripo-v2.5`, `tripo-v2.0`
negative_prompt	Zeichenfolge	Nein	-	Negative Aufforderung, bis zu 255 Zeichen
model_seed	ganze Zahl	Nein	Zufällig	Zufälliger Startwert für die Geometriegenerierung
image_seed	ganze Zahl	Nein	Zufällig	Zufälliger Startwert für die Text-zu-Bild-Phase
face_limit	ganze Zahl	Nein	Adaptiv	Maximale Polyanzahl für die Ausgabe
texture	Boolescher Wert	Nein	`true`	Aktivieren Sie Texturkarten
pbr	Boolescher Wert	Nein	`true`	Aktivieren Sie PBR-Materialien. Wenn aktiviert, wird `texture` zu `true` gezwungen
texture_seed	ganze Zahl	Nein	Zufällig	Zufälliger Startwert für die Texturgenerierung
texture_quality	Zeichenfolge	Nein	`standard`	Texturqualität. Unterstützte Werte: `standard`, `detailed`, `extreme`
geometry_quality	Zeichenfolge	Nein	`standard`	Geometriequalität. `standard` (symmetrisch), `detailed` (Ultra-Modus)
auto_size	Boolescher Wert	Nein	`false`	Skalieren Sie das Modell automatisch auf reale Abmessungen in Metern
quad	Boolescher Wert	Nein	`false`	Geben Sie ein Quad-Netz aus. Wenn diese Option aktiviert ist, wird das Ausgabeformat auf FBX erzwungen
smart_low_poly	Boolescher Wert	Nein	`false`	Generieren Sie ein Low-Poly-Modell mit handgefertigtem Topologiestil
generate_parts	Boolescher Wert	Nein	`false`	Generieren Sie bearbeitbare segmentierte Teile. Gegenseitig ausschließend mit `texture=true`, `pbr=true` und `quad=true`
compress	Zeichenfolge	Nein	-	Komprimierungstyp. `geometry` (Meshopt-Komprimierung)

Die folgenden Parameter sind nur gültig, wenn model >= tripo-v3.0: texture_quality, geometry_quality, auto_size, quad, smart_low_poly, generate_parts, compress.

Fordern Sie Beispiele an

-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);

Antwort

Erfolgsantwort

JSON

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

Antwortfelder

Parameter	Typ	Beschreibung
code	ganze Zahl	Statuscode. `0` zeigt Erfolg an
data.task_id	Zeichenfolge	Eindeutiger Aufgabenbezeichner, der zum Abfragen des Generierungsfortschritts und der Ergebnisse verwendet wird

Fehlercodes

HTTP Statuscode	Fehlercode	Beschreibung	Empfehlung
429	2000	Generationslimit überschritten	Reduzieren Sie die Anforderungshäufigkeit und versuchen Sie es später noch einmal
400	2002	Nicht unterstützter Anforderungsparameter	Überprüfen Sie die Parameternamen und Wertebereiche des Anforderungshauptteils
400	2008	Die Eingabe verstößt gegen die Inhaltsrichtlinien	Überarbeiten Sie die Eingabeaufforderung und entfernen Sie Beschreibungen, die gegen die Richtlinien verstoßen
403	2010	Unzureichende Credits	Fügen Sie Credits hinzu und versuchen Sie es erneut
400	2015	Modellversion veraltet	Aktualisieren Sie `model` auf eine aktuell unterstützte Version
400	2018	Das Modell ist zu komplex für eine Neuvernetzung	Senken Sie `face_limit` oder vereinfachen Sie die Eingabeaufforderung