Tripo: 3D Generation
Tripo lager en 3D-modellressurs fra en skriftlig objektbeskrivelse. Produsentens bredere arbeidsprosesser skiller mellom geometri, teksturering og senere modellbehandling; undersøk det ferdige polygonnettet fra flere synsvinkler og behold de faktiske filene for målscenen eller editoren.
Om modellen
Denne beskrivelsen dekker modellens funksjoner. Tilgjengelige inndata, utdata og alternativer i Ailoot er oppført nedenfor for den valgte metoden.
Tripo lager 3D-modellressurser fra en beskrivelse eller visuell referanse. Arbeidsprosessene skiller generering av et objekt fra senere trinn som teksturering, rigging og konvertering. Start med å identifisere den tiltenkte ressursen og operasjonen som produserer den: et statisk polygonnett for en scene, et teksturert objekt for rendering eller en modell som skal bearbeides videre i en 3D-editor.
For en tekst-til-modell-beskrivelse angis objektets form og viktige deler. En liten lykt kan beskrives gjennom kropp, håndtak, åpninger og proporsjoner; en skapning gjennom silhuett, lemmer og positur. Oppgi materiale eller visuell behandling når det er viktig for resultatet. Hold beskrivelsen rettet mot selve objektet, slik at den genererte geometrien kan vurderes mot et tydelig design.
For en referansebasert prosess hos produsenten klargjøres bilder som viser motivets omriss og særtrekk. Flere visninger bør beskrive det samme objektet med konsistente proporsjoner og tilbehør. Undersøk deler som er skjult i referansen, etter generering, fordi en overbevisende frontvisning ikke fastslår at baksiden, undersiden eller forbindelsene mellom komponentene samsvarer med det tiltenkte designet.
Behold valgt modellversjon sammen med forespørselen. Tripos genereringsgrensesnitt identifiserer operasjonen separat fra innstillingen for modellversjon, og det dokumenterte tekst-til-modell-eksemplet velger en uttrykkelig versjon. Behold nøyaktig versjon og innstillinger ved sammenligning av ressurser, slik at en endring i objektbeskrivelsen ikke forveksles med en endring i genereringskonfigurasjonen.
Geometri og overflateutseende er separate produksjonsvalg. Produsentens grunnprosess skiller en uteksturert modell fra utdata med teksturer og materialer for fysisk basert rendering. Velg ressursformen som trengs for neste trinn, og undersøk deretter både polygonnettet og eventuelle medfølgende materialfiler. Et forhåndsvisningsbilde er nyttig for orientering, mens den faktiske modellen er ressursen som trengs for å sette sammen en scene og redigere videre.
Undersøk det ferdige objektet fra flere vinkler. Se på silhuetten, skillet mellom deler, tynne detaljer, åpninger og overflater der komponenter møtes. For en stilisert rekvisitt sammenlignes proporsjonene med designbeskrivelsen. For et produktlignende objekt kontrolleres hvilke detaljer som er representert av geometri, og hvilke som bare vises i overflatebehandlingen. Identifiser detaljen som trenger revisjon, før prompten eller referansen endres.
Generering kjører som en asynkron oppgave. Behold den opprinnelige oppgaveidentiteten gjennom statuskontrollen, og hold ferdig modell, forhåndsvisning og eventuelle andre returnerte filer samlet. Det dokumenterte resultatet omfatter modellrelaterte utdatafelt og rendret bildemateriale. Lagre selve filene for neste produksjonstrinn fremfor å stole på en midlertidig resultatlenke eller behandle forhåndsvisningen som hele 3D-leveransen.
Importer modellen til den planlagte editoren eller visningsmiljøet, og undersøk orientering, skala, materialer og geometri der. En scenerekvisitt, en nærbilderendering og en animasjonsklar figur har forskjellige behov for sluttbearbeiding. Behold en arbeidskopi for redigering og den genererte kilderessursen sammen med beskrivelse og referanser. Når en annen operasjon trengs, som teksturarbeid eller rigging, velges den bevisst, og den resulterende ressursen vurderes som et separat trinn.
Ailoot Ultra · 3D POST /v1/3d/generations tripo3d
tripo3dStart
Tripo lager en 3D-modellressurs fra en skriftlig objektbeskrivelse. Produsentens bredere arbeidsprosesser skiller mellom geometri, teksturering og senere modellbehandling; undersøk det ferdige polygonnettet fra flere synsvinkler og behold de faktiske filene for målscenen eller editoren.
- Godkjente inndata
- Tekst
- Resultater
- model_3d · Bilder
Tilgjengelig i Ailoot · inndata & metoder
Ailoot Ultra · 3D POST /v1/3d/generations
- Inndatatyper
text- Utdatatyper
model_3d,image
| Felt | Type | Krav | Verdier & grenser | Standard |
|---|---|---|---|---|
Feltmodel | Typestring | KravPåkrevd | Verdier & grenser tripo3d Vilkår: Bruk modellvelgeren for Ailoot. | Standard— |
Felttype | Typestring | KravPåkrevd | Verdier & grenser text_to_model, image_to_model, multiview_to_model, texture_model, animate_prerigcheck, animate_rig, animate_retarget, stylize_model, convert_model Vilkår: Det fullstendige eksemplet bruker text_to_model; andre oppgavetyper krever de dokumenterte oppgavespesifikke inndataene. | Standard— |
Feltmodel_version | Typestring | KravPåkrevd | Verdier & grenser v2.0-20240919, v1.4-20240625, v2.5-20250123, v3.0-20250812, Turbo-v1.0-20250506 Vilkår: Velg en uttrykkelig dokumentert versjon; dette eksemplet bruker v3.0-20250812. | Standard— |
Feltprompt | Typestring | KravPåkrevd | Verdier & grenser Vilkår: Beskriv objektet som skal opprettes. | Standard— |
Metodeparametere og livssyklus
| Parameter | Avtale |
|---|---|
Parametercontent_type | Avtaleapplication/json |
Parameterrequired | Avtalemodel, type, model_version, prompt |
Parameteroptional | Avtale |
Parametermaterial_types | Avtaletext |
Parameterconditions | AvtaleBruk modellvelgeren for Ailoot., Det fullstendige eksemplet bruker text_to_model; andre oppgavetyper krever de dokumenterte oppgavespesifikke inndataene., Velg en uttrykkelig dokumentert versjon; dette eksemplet bruker v3.0-20250812., Beskriv objektet som skal opprettes. |
Livssyklus: submit_once_poll_original
GET /v1/3d/generations/{request_id}
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Priser
Slik beregnes det endelige beløpet
De viste satsene anslår kostnaden før generering. Det endelige beløpet beregnes ut fra kostnaden som er registrert for den opprinnelige genereringen. Målt varighet på utdataene og anslåtte mengder er ikke den endelige fakturerbare mengden.
Tariffopplysninger legger ikke til forespørselsvalg. Støttede parametere står ved den valgte metoden.
- Hurtigmodus
- Ikke angitt Når hurtigmodus er valgt
- Flex-modus
- Ikke angitt Når flex-modus er valgt
- Maksimal resonneringsinnsats
- Ikke angitt Når justeringen «default» brukes for maksimal resonneringsinnsats
Estimerte satser for sammenligning
Priser etter konfigurasjon
Knytt hver kostnad til de viste vilkårene. Bruk én sats for hvert sett med alternative konfigurasjoner.
| Konfigurasjon | Prisplan | Forventet mengde | Kostnad |
|---|---|---|---|
| KonfigurasjonGrunnpriser for tokener | PrisplanGrunnsats | Forventet mengde— | Kostnad Inndata · Inngående tokener · Estimat kun for sammenligning — / 1K tokener Utdata · Utgående tokener · Estimat kun for sammenligning — / 1K tokener Inndata · Lesing fra hurtigbuffer · Estimat kun for sammenligning — / 1K tokener Inndata · Skriving til hurtigbuffer · Estimat kun for sammenligning — / 1K tokener Inndata · Skriving til hurtigbuffer, 1 time · Estimat kun for sammenligning — / 1K tokener |
| KonfigurasjonAnslått genereringskostnad | Prisplan— | Forventet mengdeestimat for én generering | Kostnad Utdata · Anslått genereringskostnad · Estimat kun for sammenligning $1.35 estimat før generering Dette anslaget er verken en tilleggsavgift eller en fast sats for den fullførte genereringen. |
Ailoot reserverer et estimert beløp før en forespørsel. Etter resultatet gjøres det endelige beløpet opp basert på målt forbruk. Oppgjør for strømming bruker den endelige forbruksposten. Slik fungerer reservasjon og oppgjør →
Eksempelforespørsler
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
Motta og lagre resultater
Ailoot Ultra · 3D
Last ned hvert returnerte bilde eller lagre Base64-innholdet
GET /v1/3d/generations/{request_id}GET /v1/media/assetsGET /v1/media/assets/{asset_id}
Behold alle ferdige resultater
Behold alle fullstendige returnerte svar, filer og innholdsdeler.
Behold hele svaret og alle svarhoder, opprinnelige identifikatorer, alle faktiske utdata og alle felt for forbruk og avregning. Lagre hver unike ressurs du eier, og behold alle roller som viser til den.
Hvis det opprinnelige svaret må kontrolleres
Behold den returnerte offentlige oppgave- eller operasjons-ID-en og alle svarhoder. Les bare den opprinnelige oppgaven; unknown eller result_pending_check gir ikke tillatelse til en ny opprettelse.
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
Modellaliaser
Ailoot Ultra tripo3d
Aliaser for metodestier
Bruk metodestiene som vises ovenfor.
Tilknyttede anroper-ID-er
FAQ · Tripo: 3D Generation
- Hvilke inndata og resultater er tilgjengelige?
POST /v1/3d/generations·tripo3d:text→model_3d,image- Hvilke felt bruker forespørselen?
POST /v1/3d/generations·tripo3d:model,type,model_version,prompt