Tripo: 3D Generation
Tripo erzeugt aus einer schriftlichen Objektbeschreibung ein 3D-Modell. Die umfassenderen Abläufe des Herstellers unterscheiden Geometrie, Texturierung und spätere Modellverarbeitung; prüfen Sie das fertige Polygonnetz aus mehreren Blickwinkeln und bewahren Sie die tatsächlichen Dateien für die Zielszene oder den Editor auf.
Über das Modell
Diese Beschreibung erläutert die Fähigkeiten des Modells. Die über Ailoot verfügbaren Eingaben, Ausgaben und Optionen sind unten für die ausgewählte Methode aufgeführt.
Tripo erzeugt 3D-Modelle aus einer Beschreibung oder visuellen Referenz. Seine Abläufe trennen die Erzeugung eines Objekts von späteren Schritten wie Texturierung, Rigging und Konvertierung. Bestimmen Sie zunächst das gewünschte Ergebnis und den Vorgang, der es erzeugt: ein statisches Polygonnetz für eine Szene, ein texturiertes Objekt zum Rendern oder ein Modell, das in einem 3D-Editor weiter vorbereitet wird.
Beschreiben Sie für einen Auftrag zur Modellerzeugung aus Text die Objektform und ihre wichtigen Teile. Eine kleine Laterne lässt sich über Körper, Griff, Öffnungen und Proportionen bestimmen, ein Wesen über Silhouette, Gliedmassen und Pose. Nennen Sie Material oder visuelle Gestaltung, wenn sie für das Ergebnis wichtig sind. Halten Sie die Beschreibung auf das Objekt selbst ausgerichtet, damit die erzeugte Geometrie anhand eines klaren Designs beurteilt werden kann.
Bereiten Sie für einen referenzbasierten Herstellerablauf Bilder vor, die Umriss und charakteristische Merkmale des Motivs zeigen. Mehrere Ansichten sollten dasselbe Objekt mit einheitlichen Proportionen und Zubehörteilen beschreiben. Prüfen Sie nach der Erzeugung die in der Referenz verborgenen Teile, denn eine überzeugende Vorderansicht belegt nicht, dass Rückseite, Unterseite oder Verbindungen zwischen Komponenten dem gewünschten Design entsprechen.
Bewahren Sie die gewählte Modellversion zusammen mit der Anfrage auf. Die Generierungsschnittstelle von Tripo bestimmt den Vorgang getrennt von der Modellversionseinstellung, und das dokumentierte Beispiel zur Modellerzeugung aus Text wählt ausdrücklich eine Version. Erhalten Sie beim Vergleich von Modellen die genaue Version und Steuerungen, damit eine Änderung der Objektbeschreibung nicht mit einer Änderung der Generierungskonfiguration verwechselt wird.
Geometrie und Oberflächenaussehen sind getrennte Produktionsentscheidungen. Der grundlegende Herstellerablauf unterscheidet ein untexturiertes Modell von einer Ausgabe mit Texturen und Materialien für physikalisch basiertes Rendering. Wählen Sie die für den nächsten Schritt benötigte Modellform und prüfen Sie dann sowohl das Polygonnetz als auch zugehörige Materialdateien. Ein Vorschaubild hilft bei der Orientierung, während das tatsächliche Modell das für Szenenaufbau und weitere Bearbeitung benötigte Ergebnis ist.
Untersuchen Sie das fertige Objekt aus mehreren Winkeln. Achten Sie auf Silhouette, Trennung der Teile, dünne Strukturen, Öffnungen und Oberflächen an den Verbindungen von Komponenten. Vergleichen Sie bei einem stilisierten Requisit die Proportionen mit dem Designauftrag. Prüfen Sie bei einem produktähnlichen Objekt, welche Details durch Geometrie dargestellt werden und welche nur in der Oberflächengestaltung erscheinen. Bestimmen Sie das zu überarbeitende Merkmal, bevor Sie Prompt oder Referenz ändern.
Die Erzeugung läuft als asynchrone Aufgabe. Erhalten Sie während der Statusprüfung die ursprüngliche Aufgabenkennung und bewahren Sie fertiges Modell, Vorschau und alle anderen zurückgegebenen Dateien gemeinsam auf. Das dokumentierte Ergebnis umfasst modellbezogene Ausgabefelder und gerenderte Bilder. Speichern Sie für den nächsten Produktionsschritt die Dateien selbst, statt sich auf einen vorübergehenden Ergebnislink zu verlassen oder die Vorschau als vollständiges 3D-Ergebnis zu behandeln.
Importieren Sie das Modell in den vorgesehenen Editor oder die Anzeigeumgebung und prüfen Sie dort Ausrichtung, Massstab, Materialien und Geometrie. Ein Szenenrequisit, eine Nahaufnahme beim Rendern und eine animationsbereite Figur haben unterschiedliche Anforderungen an die Fertigstellung. Bewahren Sie eine Arbeitskopie für Bearbeitungen auf und erhalten Sie das erzeugte Ausgangsmodell mit seinem Auftrag und seinen Referenzen. Wählen Sie bei einem weiteren benötigten Vorgang wie Texturarbeit oder Rigging diesen Vorgang bewusst und prüfen Sie das entstandene Modell als separate Stufe.
Ailoot Ultra · 3D POST /v1/3d/generations tripo3d
tripo3dEinstieg
Tripo erzeugt aus einer schriftlichen Objektbeschreibung ein 3D-Modell. Die umfassenderen Abläufe des Herstellers unterscheiden Geometrie, Texturierung und spätere Modellverarbeitung; prüfen Sie das fertige Polygonnetz aus mehreren Blickwinkeln und bewahren Sie die tatsächlichen Dateien für die Zielszene oder den Editor auf.
- Zulässige Eingaben
- Text
- Ergebnisse
- model_3d · Bilder
In Ailoot verfügbar · Eingaben und Methoden
Ailoot Ultra · 3D POST /v1/3d/generations
- Eingabe
text- Ausgabe
model_3d,image
| Feld | Typ | Anforderung | Werte und Limits | Standard |
|---|---|---|---|---|
Feldmodel | Typstring | AnforderungErforderlich | Werte und Limits tripo3d Bedingungen: Verwenden Sie die Modellauswahl von Ailoot. | Standard— |
Feldtype | Typstring | AnforderungErforderlich | Werte und Limits text_to_model, image_to_model, multiview_to_model, texture_model, animate_prerigcheck, animate_rig, animate_retarget, stylize_model, convert_model Bedingungen: Das vollständige Beispiel verwendet text_to_model; andere Aufgabentypen erfordern die jeweils dokumentierten aufgabenspezifischen Eingaben. | Standard— |
Feldmodel_version | Typstring | AnforderungErforderlich | Werte und Limits v2.0-20240919, v1.4-20240625, v2.5-20250123, v3.0-20250812, Turbo-v1.0-20250506 Bedingungen: Wählen Sie eine ausdrücklich dokumentierte Version; dieses Beispiel verwendet v3.0-20250812. | Standard— |
Feldprompt | Typstring | AnforderungErforderlich | Werte und Limits Bedingungen: Beschreiben Sie das zu erstellende Objekt. | Standard— |
Methodenparameter und Lebenszyklus
| Parameter | Vertrag |
|---|---|
Parametercontent_type | Vertragapplication/json |
Parameterrequired | Vertragmodel, type, model_version, prompt |
Parameteroptional | Vertrag |
Parametermaterial_types | Vertragtext |
Parameterconditions | VertragVerwenden Sie die Modellauswahl von Ailoot., Das vollständige Beispiel verwendet text_to_model; andere Aufgabentypen erfordern die jeweils dokumentierten aufgabenspezifischen Eingaben., Wählen Sie eine ausdrücklich dokumentierte Version; dieses Beispiel verwendet v3.0-20250812., Beschreiben Sie das zu erstellende Objekt. |
Lebenszyklus: submit_once_poll_original
GET /v1/3d/generations/{request_id}
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Tarife
So wird die endgültige Gebühr berechnet
Die angezeigten Tarife dienen zur Kostenschätzung vor der Generierung. Der endgültige Betrag wird aus den für die ursprüngliche Generierung erfassten Kosten berechnet. Die gemessene Ausgabedauer und prognostizierte Mengen sind nicht die endgültige abrechenbare Menge.
Tarifangaben erweitern die Anfrageoptionen nicht. Unterstützte Parameter stehen bei der ausgewählten Methode.
- Schnellmodus
- Nicht angegeben Wenn der Schnellmodus ausgewählt ist
- Flex-Modus
- Nicht angegeben Wenn der Modus flex ausgewählt ist
- Maximaler Denkaufwand
- Nicht angegeben Wenn beim maximalen Denkaufwand die Standardanpassung (default) verwendet wird
Geschätzte Tarife zum Vergleich
Preise nach Konfiguration
Ordnen Sie jede Gebühr den angezeigten Bedingungen zu. Verwenden Sie für jede Gruppe alternativer Konfigurationen einen Tarif.
| Konfiguration | Tarifstaffel | Prognostizierte Menge | Gebühr |
|---|---|---|---|
| KonfigurationToken-Basistarife | TarifstaffelGrundtarif | Prognostizierte Menge— | Gebühr Eingabe · Eingabetoken · Schätzung nur zum Vergleich — / 1K Tokens Ausgabe · Ausgabetoken · Schätzung nur zum Vergleich — / 1K Tokens Eingabe · Cache lesen · Schätzung nur zum Vergleich — / 1K Tokens Eingabe · Cache schreiben · Schätzung nur zum Vergleich — / 1K Tokens Eingabe · Cache schreiben, 1 Stunde · Schätzung nur zum Vergleich — / 1K Tokens |
| KonfigurationGeschätzte Erzeugungskosten | Tarifstaffel— | Prognostizierte MengeSchätzung für eine Generierung | Gebühr Ausgabe · Geschätzte Generierungskosten · Schätzung nur zum Vergleich $1.35 Schätzung vor der Generierung Diese Schätzung ist weder eine zusätzliche Gebühr noch ein fester Tarif für die abgeschlossene Generierung. |
Ailoot reserviert vor einer Anfrage einen geschätzten Betrag. Nach dem Ergebnis rechnet Ailoot die endgültige Gebühr anhand des gemessenen Verbrauchs ab. Bei Streaming erfolgt die Abrechnung anhand des abschliessenden Verbrauchsdatensatzes. So funktionieren Reservierung und Abrechnung →
Beispielanfragen
Ailoot Ultra · 3D
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
cat > request.json <<'JSON'
{
"model": "tripo3d",
"type": "text_to_model",
"prompt": "a cute pig",
"model_version": "v3.0-20250812"
}
JSON
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/3d/generations \
-H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
--data-binary @request.json -D response-headers.txt -o result.json
# Create once; retain id, polling_url, original task identifiers and every header.
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_STATUS'
import json,os,subprocess
from pathlib import Path
from urllib.parse import urljoin,urlsplit
r=json.loads(Path("result.json").read_text())
u=urljoin("https://api.ailoot.ai",r["polling_url"])
p=urlsplit(u)
if p.scheme!="https" or p.netloc!="api.ailoot.ai" or p.username or p.password:
raise SystemExit("Unexpected returned polling URL; preserve the response")
subprocess.run(["curl","--fail-with-body","--silent","--show-error",u,"-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"],"-D","status-headers.txt","-o","status.json"],check=True)
# Read this same original polling_url again while pending.
# Preserve unknown/result_pending_check; do not repeat creation.
PY_STATUS
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_ASSETS'
import json,os,subprocess
from pathlib import Path
from urllib.parse import urljoin,urlsplit
r=json.loads(Path("status.json").read_text())
roles={}
def visit(v,path=""):
if isinstance(v,dict):
for k,x in v.items(): visit(x,path+"/"+k)
elif isinstance(v,list):
for i,x in enumerate(v): visit(x,path+"/"+str(i))
elif isinstance(v,str):
u=urljoin("https://api.ailoot.ai",v); p=urlsplit(u)
if p.scheme=="https" and p.netloc=="api.ailoot.ai" and not p.username and not p.password and p.path.startswith("/v1/media/assets/") and p.path.endswith("/content"):
roles.setdefault(u,[]).append(path)
visit(r)
if not roles: raise SystemExit("No completed owned assets; retain the original status")
manifest=[]
for i,(u,paths) in enumerate(roles.items()):
target=Path(f"asset-{i}.bin")
subprocess.run(["curl","--fail-with-body","--silent","--show-error",u,"-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"],"-o",str(target)],check=True)
raw=target.read_bytes()
if not raw: raise SystemExit("Empty asset; retain original status and metadata")
ext="glb" if raw[:4]==b"glTF" else "png" if raw[:8]==b"\x89PNG\r\n\x1a\n" else "jpg" if raw[:3]==b"\xff\xd8\xff" else "webp" if raw[:4]==b"RIFF" and raw[8:12]==b"WEBP" else "mp4" if raw[4:8]==b"ftyp" else "bin"
name=f"asset-{i}.{ext}"
if target.name!=name: target.rename(name)
manifest.append({"file":name,"response_paths":paths,"bytes":len(raw)})
Path("asset-manifest.json").write_text(json.dumps(manifest,indent=2))
print("Saved",len(manifest),"unique owned assets; every response role retained")
PY_ASSETS
Ergebnisse abrufen und speichern
Ailoot Ultra · 3D
Laden Sie jedes zurückgegebene Bild herunter oder speichern Sie seinen Base64-Inhalt
GET /v1/3d/generations/{request_id}GET /v1/media/assetsGET /v1/media/assets/{asset_id}
Alle fertiggestellten Ergebnisse aufbewahren
Bewahren Sie jede vollständig zurückgegebene Antwort, Datei und jeden Inhaltsteil auf.
Bewahren Sie die vollständige Antwort samt Headern, ursprünglichen Kennungen, jeder tatsächlichen Ausgabe sowie sämtlichen Verbrauchs- und Abrechnungsfeldern auf. Speichern Sie jedes eindeutige, Ihnen zugeordnete Asset und bewahren Sie jede Rolle auf, die darauf verweist.
Wenn die ursprüngliche Antwort geprüft werden muss
Bewahren Sie die zurückgegebene öffentliche Aufgaben- oder Vorgangs-id und sämtliche Header auf. Lesen Sie ausschliesslich die ursprüngliche Aufgabe; unknown oder result_pending_check berechtigen nicht zu einer weiteren Erstellung.
Antwortfelder
| Feld | Typ |
|---|---|
Feldid | Typstring |
Feldpolling_url | Typstring |
Feldprovider_task_id | Typstring |
Feldcode | Typinteger |
Felddata.task_id | Typstring |
Felddata.status | Typstring |
Felddata.progress | Typinteger |
Felddata.output.* | Typstring |
Felddata.result.*.url | Typstring |
Felddata.result.*.type | Typstring |
Felddata.thumbnail | Typstring |
Aliasnamen
Modellaliasnamen
Ailoot Ultra tripo3d
Aliasnamen für Methodenpfade
Verwenden Sie die oben angezeigten Methodenpfade.
Zugehörige Aufrufer-IDs
FAQ · Tripo: 3D Generation
- Welche Eingaben und Ergebnisse sind verfügbar?
POST /v1/3d/generations·tripo3d:text→model_3d,image- Welche Felder verwendet die Anfrage?
POST /v1/3d/generations·tripo3d:model,type,model_version,prompt