Tripo: 3D Generation
Tripo skaber et 3D-modelaktiv ud fra en skriftlig objektbeskrivelse. Producentens bredere arbejdsgange skelner mellem geometri, teksturering og senere modelbehandling; undersøg det færdige mesh fra flere synsvinkler, og bevar de faktiske filer til den tilsigtede scene eller editor.
Om modellen
Denne beskrivelse dækker modellens funktioner. Tilgængelige input, output og indstillinger i Ailoot står nedenfor for den valgte metode.
Tripo skaber 3D-modelaktiver ud fra en beskrivelse eller visuel reference. Dens arbejdsgange adskiller generering af et objekt fra senere trin som teksturering, rigging og konvertering. Begynd med at identificere det tilsigtede aktiv og den handling, der producerer det: et statisk mesh til en scene, et tekstureret objekt til rendering eller en model, der skal forberedes yderligere i en 3D-editor.
Beskriv objektets form og vigtige dele ved en tekst-til-model-opgave. En lille lanterne kan specificeres gennem sin krop, sit håndtag, åbninger og proportioner; et væsen gennem silhuet, lemmer og positur. Angiv materialet eller den visuelle behandling, når det er vigtigt for resultatet. Hold beskrivelsen fokuseret på selve objektet, så den genererede geometri kan vurderes mod et klart design.
Forbered billeder, der viser motivets omrids og særlige kendetegn, til en referencebaseret producentarbejdsgang. Flere visninger skal beskrive det samme objekt med ensartede proportioner og tilbehør. Gennemgå de dele, der er skjult i referencen, efter generering, fordi en overbevisende frontvisning ikke fastslår, at bagsiden, undersiden eller forbindelserne mellem komponenter matcher det tilsigtede design.
Gem den valgte modelversion sammen med anmodningen. Tripos genereringsgrænseflade identificerer handlingen adskilt fra modelversionsindstillingen, og det dokumenterede tekst-til-model-eksempel vælger en eksplicit version. Bevar den præcise version og indstillingerne, når aktiver sammenlignes, så en ændring i objektbeskrivelsen ikke forveksles med en ændring i genereringskonfigurationen.
Geometri og overfladeudseende er særskilte produktionsbeslutninger. Producentens basisarbejdsgang skelner mellem en model uden teksturer og et output med teksturer og materialer til fysisk baseret rendering. Vælg den aktivform, der kræves til det næste trin, og undersøg derefter både meshet og eventuelle tilhørende materialefiler. Et forhåndsvisningsbillede er nyttigt til orientering, mens den faktiske model er det aktiv, der kræves til scenesammensætning og videre redigering.
Undersøg det færdige objekt fra flere vinkler. Se på silhuetten, adskillelsen af dele, tynde detaljer, åbninger og overflader, hvor komponenter mødes. Sammenlign proportionerne med designbeskrivelsen ved en stiliseret rekvisit. Kontrollér ved et produktlignende objekt, hvilke detaljer der repræsenteres af geometri, og hvilke der kun fremgår af overfladebehandlingen. Identificér den egenskab, der kræver revision, før du ændrer prompten eller referencen.
Genereringen kører som en asynkron opgave. Bevar den oprindelige opgaveidentitet gennem statuskontrol, og hold den færdige model, forhåndsvisningen og eventuelle andre returnerede filer samlet. Det dokumenterede resultat omfatter modelrelaterede outputfelter og renderede billeder. Gem selve filerne til det næste produktionstrin frem for at stole på et midlertidigt resultatlink eller behandle forhåndsvisningen som det komplette 3D-resultat.
Importér modellen i den tilsigtede editor eller det tilsigtede visningsmiljø, og undersøg dens orientering, skala, materialer og geometri dér. En scenerekvisit, en nærbilledrendering og en animationsklar figur har forskellige behov for færdiggørelse. Bevar en arbejdskopi til redigeringer, og gem det genererede kildeaktiv sammen med dets opgavebeskrivelse og referencer. Vælg en anden handling bevidst, når den kræves, f.eks. teksturarbejde eller rigging, og gennemgå det resulterende aktiv som et særskilt trin.
Ailoot Ultra · 3D POST /v1/3d/generations tripo3d
tripo3dStart
Tripo skaber et 3D-modelaktiv ud fra en skriftlig objektbeskrivelse. Producentens bredere arbejdsgange skelner mellem geometri, teksturering og senere modelbehandling; undersøg det færdige mesh fra flere synsvinkler, og bevar de faktiske filer til den tilsigtede scene eller editor.
- Accepterede input
- Tekst
- Resultater
- model_3d · Billeder
Tilgængelig i Ailoot · input og metoder
Ailoot Ultra · 3D POST /v1/3d/generations
- Inputtyper
text- Outputtyper
model_3d,image
| Felt | Type | Krav | Værdier og grænser | Standard |
|---|---|---|---|---|
Feltmodel | Typestring | KravPåkrævet | Værdier og grænser tripo3d Betingelser: Brug Ailoot-modelvælgeren. | Standard— |
Felttype | Typestring | KravPåkrævet | Værdier og grænser text_to_model, image_to_model, multiview_to_model, texture_model, animate_prerigcheck, animate_rig, animate_retarget, stylize_model, convert_model Betingelser: Det komplette eksempel bruger text_to_model; andre opgavetyper kræver deres dokumenterede opgavespecifikke input. | Standard— |
Feltmodel_version | Typestring | KravPåkrævet | Værdier og grænser v2.0-20240919, v1.4-20240625, v2.5-20250123, v3.0-20250812, Turbo-v1.0-20250506 Betingelser: Vælg en udtrykkeligt dokumenteret version; dette eksempel bruger v3.0-20250812. | Standard— |
Feltprompt | Typestring | KravPåkrævet | Værdier og grænser Betingelser: Beskriv objektet, der skal oprettes. | Standard— |
Metodeparametre og livscyklus
| Parameter | Kontrakt |
|---|---|
Parametercontent_type | Kontraktapplication/json |
Parameterrequired | Kontraktmodel, type, model_version, prompt |
Parameteroptional | Kontrakt |
Parametermaterial_types | Kontrakttext |
Parameterconditions | KontraktBrug Ailoot-modelvælgeren., Det komplette eksempel bruger text_to_model; andre opgavetyper kræver deres dokumenterede opgavespecifikke input., Vælg en udtrykkeligt dokumenteret version; dette eksempel bruger v3.0-20250812., Beskriv objektet, der skal oprettes. |
Livscyklus: submit_once_poll_original
GET /v1/3d/generations/{request_id}
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Priser
Sådan beregnes det endelige beløb
De viste satser bruges til at anslå omkostningen før genereringen. Det endelige beløb beregnes ud fra den registrerede omkostning for den oprindelige generering. Den målte varighed af outputtet og de anslåede mængder er ikke den endelige fakturerbare mængde.
Tarifoplysninger tilføjer ikke anmodningsmuligheder. Understøttede parametre står ved den valgte metode.
- Hurtig tilstand
- Ikke angivet Når hurtig tilstand er valgt
- flex-tilstand
- Ikke angivet Når flex-tilstanden er valgt
- Maksimal ræsonneringsindsats
- Ikke angivet Når default-justeringen anvendes ved maksimal ræsonneringsindsats
Estimerede takster til sammenligning
Priser efter konfiguration
Knyt hver omkostning til de viste betingelser. Brug én takst for hver gruppe af alternative konfigurationer.
| Konfiguration | Takstplan | Forventet mængde | Beløb |
|---|---|---|---|
| KonfigurationGrundpriser for tokens | TakstplanGrundtakst | Forventet mængde— | Beløb Input · Inputtokens · Estimat kun til sammenligning — / 1K tokens Output · Outputtokens · Estimat kun til sammenligning — / 1K tokens Input · Cachelæsning · Estimat kun til sammenligning — / 1K tokens Input · Cacheskrivning · Estimat kun til sammenligning — / 1K tokens Input · Cacheskrivning, 1 time · Estimat kun til sammenligning — / 1K tokens |
| KonfigurationAnslået genereringsomkostning | Takstplan— | Forventet mængdeestimat for én generering | Beløb Output · Anslået genereringsomkostning · Estimat kun til sammenligning $1.35 estimat før generering Dette estimat er hverken et ekstra gebyr eller en fast pris for den færdige generering. |
Ailoot reserverer et estimeret beløb før en anmodning. Efter resultatet afregnes det endelige beløb ud fra det målte forbrug. Ved streaming bruges den endelige forbrugsregistrering til afregningen. Sådan fungerer reservation og afregning →
Eksempelanmodninger
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
Hent og gem resultater
Ailoot Ultra · 3D
Hent hvert returneret billede, eller gem dets Base64-indhold
GET /v1/3d/generations/{request_id}GET /v1/media/assetsGET /v1/media/assets/{asset_id}
Behold alle færdige resultater
Gem hvert fuldstændigt returneret svar, hver fil og hver indholdsdel.
Behold hele svaret og alle headere, de oprindelige identifikatorer, hvert faktisk output og alle felter til forbrug og afregning. Gem hvert entydigt aktiv, du ejer, og behold alle roller, der henviser til det.
Hvis det oprindelige svar skal kontrolleres
Behold det returnerede offentlige opgave- eller operations-id og alle headere. Læs kun den oprindelige opgave; unknown eller result_pending_check giver ikke tilladelse til en ny oprettelse.
Svarfelter
| Felt | Type |
|---|---|
Feltid | Typestring |
Feltpolling_url | Typestring |
Feltprovider_task_id | Typestring |
Feltcode | Typeinteger |
Feltdata.task_id | Typestring |
Feltdata.status | Typestring |
Feltdata.progress | Typeinteger |
Feltdata.output.* | Typestring |
Feltdata.result.*.url | Typestring |
Feltdata.result.*.type | Typestring |
Feltdata.thumbnail | Typestring |
Aliaser
Modelaliaser
Ailoot Ultra tripo3d
Aliaser for metodestier
Brug metodestierne vist ovenfor.
Relaterede kalder-ID’er
FAQ · Tripo: 3D Generation
- Hvilke input og resultater er tilgængelige?
POST /v1/3d/generations·tripo3d:text→model_3d,image- Hvilke felter bruger anmodningen?
POST /v1/3d/generations·tripo3d:model,type,model_version,prompt