Tripo: 3D Generation
Το Tripo δημιουργεί ένα μοντέλο 3D από γραπτή περιγραφή ενός αντικειμένου. Οι ευρύτερες ροές εργασίας του κατασκευαστή διακρίνουν τη γεωμετρία, την εφαρμογή υφών και τη μεταγενέστερη επεξεργασία του μοντέλου· εξετάστε το ολοκληρωμένο πλέγμα από διάφορες οπτικές γωνίες και διατηρήστε τα πραγματικά αρχεία για τη σκηνή ή τον επεξεργαστή προορισμού.
Σχετικά με το μοντέλο
Αυτή η περιγραφή καλύπτει τις δυνατότητες του μοντέλου. Οι είσοδοι, έξοδοι και επιλογές που διατίθενται στο Ailoot παρατίθενται παρακάτω για την επιλεγμένη μέθοδο.
Το Tripo δημιουργεί μοντέλα 3D από περιγραφή ή οπτική αναφορά. Οι ροές εργασίας του διαχωρίζουν τη δημιουργία ενός αντικειμένου από μεταγενέστερα βήματα, όπως η εφαρμογή υφών, η δημιουργία σκελετού και η μετατροπή. Ξεκινήστε προσδιορίζοντας το επιθυμητό στοιχείο και τη λειτουργία που το παράγει: ένα στατικό πλέγμα για μια σκηνή, ένα αντικείμενο με υφές για απόδοση ή ένα μοντέλο που θα προετοιμαστεί περαιτέρω σε επεξεργαστή 3D.
Για μια περιγραφή δημιουργίας μοντέλου από κείμενο, περιγράψτε το σχήμα του αντικειμένου και τα σημαντικά μέρη του. Ένα μικρό φανάρι μπορεί να προσδιοριστεί μέσω του σώματος, της λαβής, των ανοιγμάτων και των αναλογιών του· ένα πλάσμα μέσω του περιγράμματος, των άκρων και της στάσης του. Δηλώστε το υλικό ή το οπτικό ύφος όταν επηρεάζουν το αποτέλεσμα. Κρατήστε την περιγραφή εστιασμένη στο ίδιο το αντικείμενο, ώστε η παραγόμενη γεωμετρία να μπορεί να αξιολογηθεί ως προς ένα σαφές σχέδιο.
Για μια ροή εργασίας του κατασκευαστή που βασίζεται σε αναφορές, προετοιμάστε εικόνες που δείχνουν το περίγραμμα του θέματος και τα διακριτά χαρακτηριστικά του. Οι διαφορετικές όψεις πρέπει να περιγράφουν το ίδιο αντικείμενο με συνεπείς αναλογίες και εξαρτήματα. Μετά τη δημιουργία, ελέγξτε τα μέρη που είναι κρυμμένα στην αναφορά, επειδή μια πειστική εμπρόσθια όψη δεν αποδεικνύει ότι η πίσω ή η κάτω πλευρά και οι συνδέσεις μεταξύ των μερών αντιστοιχούν στο επιθυμητό σχέδιο.
Διατηρήστε την επιλεγμένη έκδοση του μοντέλου μαζί με το αίτημα. Η διεπαφή δημιουργίας του Tripo προσδιορίζει τη λειτουργία χωριστά από τη ρύθμιση της έκδοσης του μοντέλου, και το τεκμηριωμένο παράδειγμα δημιουργίας μοντέλου από κείμενο επιλέγει συγκεκριμένη έκδοση. Διατηρήστε την ακριβή έκδοση και τις παραμέτρους ελέγχου κατά τη σύγκριση στοιχείων, ώστε μια αλλαγή στην περιγραφή του αντικειμένου να μη συγχέεται με αλλαγή στη διαμόρφωση της δημιουργίας.
Η γεωμετρία και η εμφάνιση της επιφάνειας αποτελούν ξεχωριστές αποφάσεις παραγωγής. Η βασική ροή εργασίας του κατασκευαστή διακρίνει ένα μοντέλο χωρίς υφές από ένα αποτέλεσμα με υφές και υλικά για απόδοση με βάση τη φυσική. Επιλέξτε τη μορφή του στοιχείου που χρειάζεται το επόμενο βήμα και εξετάστε τόσο το πλέγμα όσο και τυχόν συνοδευτικά αρχεία υλικών. Μια εικόνα προεπισκόπησης βοηθά στον προσανατολισμό, ενώ το πραγματικό μοντέλο είναι το στοιχείο που απαιτείται για τη συναρμολόγηση της σκηνής και την περαιτέρω επεξεργασία.
Εξετάστε το ολοκληρωμένο αντικείμενο από διάφορες γωνίες. Ελέγξτε το περίγραμμα, τον διαχωρισμό των μερών, τα λεπτά χαρακτηριστικά, τα ανοίγματα και τις επιφάνειες όπου συναντώνται τα μέρη. Για ένα στυλιζαρισμένο αντικείμενο σκηνής, συγκρίνετε τις αναλογίες με την περιγραφή του σχεδίου. Για ένα αντικείμενο που μοιάζει με προϊόν, ελέγξτε ποιες λεπτομέρειες αποδίδονται με γεωμετρία και ποιες εμφανίζονται μόνο στην επεξεργασία της επιφάνειας. Προσδιορίστε το χαρακτηριστικό που χρειάζεται αναθεώρηση πριν αλλάξετε την προτροπή ή την αναφορά.
Η δημιουργία εκτελείται ως ασύγχρονη εργασία. Διατηρήστε την ταυτότητα της αρχικής εργασίας σε όλη τη διάρκεια του ελέγχου της κατάστασής της και κρατήστε μαζί το ολοκληρωμένο μοντέλο, την προεπισκόπηση και τυχόν άλλα αρχεία που επιστρέφονται. Το τεκμηριωμένο αποτέλεσμα περιλαμβάνει πεδία εξόδου σχετικά με το μοντέλο και αποδοσμένες εικόνες. Αποθηκεύστε τα ίδια τα αρχεία για το επόμενο βήμα παραγωγής, αντί να βασίζεστε σε προσωρινό σύνδεσμο αποτελέσματος ή να αντιμετωπίζετε την προεπισκόπηση ως το ολοκληρωμένο παραδοτέο 3D.
Εισαγάγετε το μοντέλο στον προβλεπόμενο επεξεργαστή ή στο περιβάλλον προβολής και εξετάστε εκεί τον προσανατολισμό, την κλίμακα, τα υλικά και τη γεωμετρία του. Ένα αντικείμενο σκηνής, μια κοντινή απόδοση και ένας χαρακτήρας έτοιμος για κίνηση έχουν διαφορετικές ανάγκες ολοκλήρωσης. Κρατήστε ένα αντίγραφο εργασίας για τις αλλαγές και διατηρήστε το αρχικό παραγόμενο στοιχείο μαζί με την περιγραφή και τις αναφορές του. Όταν απαιτείται άλλη λειτουργία, όπως εργασία στις υφές ή δημιουργία σκελετού, επιλέξτε τη συνειδητά και ελέγξτε το στοιχείο που προκύπτει ως ξεχωριστό στάδιο.
Ailoot Ultra · 3D POST /v1/3d/generations tripo3d
tripo3dΕισαγωγή
Το Tripo δημιουργεί ένα μοντέλο 3D από γραπτή περιγραφή ενός αντικειμένου. Οι ευρύτερες ροές εργασίας του κατασκευαστή διακρίνουν τη γεωμετρία, την εφαρμογή υφών και τη μεταγενέστερη επεξεργασία του μοντέλου· εξετάστε το ολοκληρωμένο πλέγμα από διάφορες οπτικές γωνίες και διατηρήστε τα πραγματικά αρχεία για τη σκηνή ή τον επεξεργαστή προορισμού.
- Αποδεκτές είσοδοι
- Κείμενο
- Αποτελέσματα
- model_3d · Εικόνες
Διαθέσιμα στο Ailoot · είσοδοι και μέθοδοι
Ailoot Ultra · 3D POST /v1/3d/generations
- Είσοδος
text- Έξοδος
model_3d,image
| Πεδίο | Τύπος | Απαίτηση | Τιμές και όρια | Προεπιλογή |
|---|---|---|---|---|
Πεδίοmodel | Τύποςstring | ΑπαίτησηΥποχρεωτικό | Τιμές και όρια tripo3d Συνθήκες: Χρησιμοποιήστε τον επιλογέα μοντέλου Ailoot. | Προεπιλογή— |
Πεδίοtype | Τύποςstring | ΑπαίτησηΥποχρεωτικό | Τιμές και όρια text_to_model, image_to_model, multiview_to_model, texture_model, animate_prerigcheck, animate_rig, animate_retarget, stylize_model, convert_model Συνθήκες: Το πλήρες παράδειγμα χρησιμοποιεί text_to_model· οι άλλοι τύποι εργασίας απαιτούν τις τεκμηριωμένες εισόδους που αντιστοιχούν στον τύπο τους. | Προεπιλογή— |
Πεδίοmodel_version | Τύποςstring | ΑπαίτησηΥποχρεωτικό | Τιμές και όρια v2.0-20240919, v1.4-20240625, v2.5-20250123, v3.0-20250812, Turbo-v1.0-20250506 Συνθήκες: Επιλέξτε μια ρητά τεκμηριωμένη έκδοση· αυτό το παράδειγμα χρησιμοποιεί την v3.0-20250812. | Προεπιλογή— |
Πεδίοprompt | Τύποςstring | ΑπαίτησηΥποχρεωτικό | Τιμές και όρια Συνθήκες: Περιγράψτε το αντικείμενο που θα δημιουργηθεί. | Προεπιλογή— |
Παράμετροι και κύκλος ζωής μεθόδου
| Παράμετρος | Σύμβαση |
|---|---|
Παράμετροςcontent_type | Σύμβασηapplication/json |
Παράμετροςrequired | Σύμβασηmodel, type, model_version, prompt |
Παράμετροςoptional | Σύμβαση |
Παράμετροςmaterial_types | Σύμβασηtext |
Παράμετροςconditions | ΣύμβασηΧρησιμοποιήστε τον επιλογέα μοντέλου Ailoot., Το πλήρες παράδειγμα χρησιμοποιεί text_to_model· οι άλλοι τύποι εργασίας απαιτούν τις τεκμηριωμένες εισόδους που αντιστοιχούν στον τύπο τους., Επιλέξτε μια ρητά τεκμηριωμένη έκδοση· αυτό το παράδειγμα χρησιμοποιεί την v3.0-20250812., Περιγράψτε το αντικείμενο που θα δημιουργηθεί. |
Κύκλος ζωής: submit_once_poll_original
GET /v1/3d/generations/{request_id}
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Τιμολόγηση
Πώς υπολογίζεται η τελική χρέωση
Οι εμφανιζόμενες τιμές χρησιμοποιούνται για την εκτίμηση του κόστους πριν από την παραγωγή. Η τελική χρέωση υπολογίζεται από το κόστος που καταγράφηκε για την αρχική παραγωγή. Η μετρημένη διάρκεια της εξόδου και οι προβλεπόμενες ποσότητες δεν αποτελούν την τελική χρεώσιμη ποσότητα.
Οι τιμολογιακές αναφορές δεν προσθέτουν επιλογές αιτήματος. Οι υποστηριζόμενες παράμετροι αναφέρονται στην επιλεγμένη μέθοδο.
- Γρήγορη λειτουργία
- Δεν έχει οριστεί Όταν επιλέγεται η γρήγορη λειτουργία
- Λειτουργία flex
- Δεν έχει οριστεί Όταν επιλέγεται η λειτουργία flex
- Μέγιστη προσπάθεια συλλογισμού
- Δεν έχει οριστεί Όταν η μέγιστη προσπάθεια συλλογισμού χρησιμοποιεί την προσαρμογή default
Εκτιμώμενες χρεώσεις για σύγκριση
Τιμές ανά διαμόρφωση
Αντιστοιχίστε κάθε χρέωση στις συνθήκες που εμφανίζονται. Χρησιμοποιήστε μία χρέωση ανά σύνολο εναλλακτικών διαμορφώσεων.
| Διαμόρφωση | Πίνακας χρεώσεων | Προβλεπόμενη ποσότητα | Χρέωση |
|---|---|---|---|
| ΔιαμόρφωσηΒασικές χρεώσεις token | Πίνακας χρεώσεωνΒασική χρέωση | Προβλεπόμενη ποσότητα— | Χρέωση Είσοδος · Token εισόδου · Εκτίμηση μόνο για σύγκριση — / 1K token Έξοδος · Token εξόδου · Εκτίμηση μόνο για σύγκριση — / 1K token Είσοδος · Ανάγνωση από την κρυφή μνήμη · Εκτίμηση μόνο για σύγκριση — / 1K token Είσοδος · Εγγραφή στην κρυφή μνήμη · Εκτίμηση μόνο για σύγκριση — / 1K token Είσοδος · Εγγραφή στην κρυφή μνήμη, 1 ώρα · Εκτίμηση μόνο για σύγκριση — / 1K token |
| ΔιαμόρφωσηΕκτιμώμενο κόστος δημιουργίας | Πίνακας χρεώσεων— | Προβλεπόμενη ποσότηταεκτίμηση για μία δημιουργία | Χρέωση Έξοδος · Εκτιμώμενο κόστος δημιουργίας · Εκτίμηση μόνο για σύγκριση $1.35 εκτίμηση πριν από τη δημιουργία Αυτή η εκτίμηση δεν αποτελεί πρόσθετη χρέωση ούτε σταθερή τιμή για την ολοκληρωμένη παραγωγή. |
Το Ailoot δεσμεύει ένα εκτιμώμενο ποσό πριν από το αίτημα. Μετά το αποτέλεσμα, εκκαθαρίζει την τελική χρέωση βάσει της μετρημένης χρήσης. Η εκκαθάριση ροής χρησιμοποιεί την τελική καταγραφή χρήσης. Πώς λειτουργούν η δέσμευση και η εκκαθάριση →
Παραδείγματα αιτημάτων
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
Λήψη και αποθήκευση αποτελεσμάτων
Ailoot Ultra · 3D
Κατεβάστε κάθε εικόνα που επιστρέφεται ή αποθηκεύστε το περιεχόμενο Base64
GET /v1/3d/generations/{request_id}GET /v1/media/assetsGET /v1/media/assets/{asset_id}
Διατηρήστε όλα τα ολοκληρωμένα αποτελέσματα
Διατηρήστε κάθε πλήρη απάντηση, αρχείο και τμήμα περιεχομένου που επιστρέφεται.
Διατηρήστε ολόκληρη την απόκριση και τις κεφαλίδες, τα αρχικά αναγνωριστικά, κάθε πραγματική έξοδο και όλα τα πεδία χρήσης και λογιστικής καταγραφής. Αποθηκεύστε κάθε μοναδικό αρχείο πολυμέσων που σας ανήκει και διατηρήστε κάθε ρόλο που παραπέμπει σε αυτό.
Αν χρειάζεται έλεγχος της αρχικής απάντησης
Διατηρήστε το δημόσιο id εργασίας ή λειτουργίας που επιστρέφεται και όλες τις κεφαλίδες. Διαβάστε μόνο την αρχική εργασία· τα unknown ή result_pending_check δεν επιτρέπουν άλλη δημιουργία.
Πεδία απάντησης
| Πεδίο | Τύπος |
|---|---|
Πεδίοid | Τύποςstring |
Πεδίοpolling_url | Τύποςstring |
Πεδίοprovider_task_id | Τύποςstring |
Πεδίοcode | Τύποςinteger |
Πεδίοdata.task_id | Τύποςstring |
Πεδίοdata.status | Τύποςstring |
Πεδίοdata.progress | Τύποςinteger |
Πεδίοdata.output.* | Τύποςstring |
Πεδίοdata.result.*.url | Τύποςstring |
Πεδίοdata.result.*.type | Τύποςstring |
Πεδίοdata.thumbnail | Τύποςstring |
Εναλλακτικά ονόματα
Εναλλακτικά ονόματα μοντέλου
Ailoot Ultra tripo3d
Εναλλακτικές διαδρομές μεθόδων
Χρησιμοποιήστε τις διαδρομές μεθόδων που εμφανίζονται παραπάνω.
Σχετικά ID μοντέλων
FAQ · Tripo: 3D Generation
- Ποιες είσοδοι και αποτελέσματα διατίθενται;
POST /v1/3d/generations·tripo3d:text→model_3d,image- Ποια πεδία χρησιμοποιεί το αίτημα;
POST /v1/3d/generations·tripo3d:model,type,model_version,prompt