Μετάβαση στο περιεχόμενο

TRELLIS.2 LoRA Inference

Ενσωμάτωση

id μοντέλου trellis-2-lora
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/v1/run/trellis-2-lora?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Αυτό το αίτημα: 0,25 $ 250 πιστώσεις API Εκτέλεση σε αυτήν τη σελίδα

Λήψη κλειδιού API

Μετατροπή εικόνας σε 3D με Trellis 2 που μπορεί να εφαρμόσει προσαρμοσμένους προσαρμογείς LoRA για δομή, γεωμετρία και υφή

Microsoft · 3D

Το πρώτο σας αποτέλεσμα θα εμφανιστεί εδώ

Δημιουργήστε ένα αίτημα παρακάτω και εκτελέστε το με το κλειδί API σας. Οι έξοδοι αντιγράφονται στην αποθήκευσή μας και διατηρούνται για πάντα ή 7 ημέρες δωρεάν.

Δημιουργία αιτήματος

Τα στοιχεία ελέγχου δημιουργούνται από το σχήμα του μοντέλου. Ο κώδικας και η τιμή ενημερώνονται καθώς τα αλλάζετε.

•απαιτείται image_url
Αποθέστε ένα αρχείο ή

URL εικόνας πηγής για μετατροπή σε 3D μοντέλο.

resolution προεπιλογή 512

Ανάλυση παραγωγής, όπου η 1024 επιλέγει το cascade pipeline. Επιλέξτε την ανάλυση που χρησιμοποιήθηκε για την εκπαίδευση των παρεχόμενων adapters LoRA· απαιτείται αντιστοίχιση.

Για προχωρημένους texture_lora_url · texture_size · sparse_structure_lora_url · geometry_lora_url · ss_guidance_strength · ss_guidance_rescale · ss_guidance_interval_start · ss_guidance_interval_end · ss_sampling_steps · ss_rescale_t · shape_slat_guidance_strength · shape_slat_guidance_rescale · shape_slat_guidance_interval_start · shape_slat_guidance_interval_end · shape_slat_sampling_steps · shape_slat_rescale_t · tex_slat_guidance_strength · tex_slat_guidance_rescale · tex_slat_guidance_interval_start · tex_slat_guidance_interval_end · tex_slat_sampling_steps · tex_slat_rescale_t · decimation_target · seed · enable_safety_checker

Προαιρετικό checkpoint LoRA σε μορφή safetensors, εκπαιδευμένο ειδικά για τον αποθορυβοποιητή υφής.

texture_size προεπιλογή 2048

Ανάλυση των υφών που έχουν ενσωματωθεί στην εξαγωγή GLB.

Προαιρετικό checkpoint LoRA σε μορφή safetensors, εκπαιδευμένο ειδικά για τον αποθορυβοποιητή αραιής δομής.

Προαιρετικό checkpoint LoRA σε μορφή safetensors, εκπαιδευμένο ειδικά για τον αποθορυβοποιητή γεωμετρίας.

προεπιλογή 7.5

Ισχύς καθοδήγησης χωρίς ταξινομητή κατά την παραγωγή αραιής δομής.

προεπιλογή 0.7

Επανακλιμάκωση καθοδήγησης κατά την παραγωγή αραιής δομής. Οι μεγαλύτερες τιμές κάνουν την έξοδο πιο σταθερή.

προεπιλογή 0.6

Κλάσμα της προόδου αποθορυβοποίησης στο οποίο ξεκινά η καθοδήγηση αραιής δομής.

προεπιλογή 1

Χρησιμοποιήστε κλάσμα αποθορυβοποίησης ίσο ή μεγαλύτερο από `ss_guidance_interval_start` για να καθορίσετε πότε σταματά η καθοδήγηση αραιής δομής.

προεπιλογή 12

Πλήθος βημάτων αποθορυβοποίησης κατά την παραγωγή αραιής δομής.

προεπιλογή 5

Οξύτητα του χρονοδιαγράμματος θορύβου κατά την παραγωγή αραιής δομής.

προεπιλογή 7.5

Ισχύς καθοδήγησης χωρίς ταξινομητή κατά την παραγωγή σχήματος.

προεπιλογή 0.5

Επανακλιμάκωση που εφαρμόζεται στην καθοδήγηση κατά την παραγωγή σχήματος· αυξήστε την όταν η γεωμετρία εμφανίζεται θορυβώδης.

προεπιλογή 0.6

Κλάσμα αποθορυβοποίησης στο οποίο ξεκινά η καθοδήγηση του σταδίου σχήματος.

προεπιλογή 1

Σημείο διακοπής της καθοδήγησης του σταδίου σχήματος, εκφρασμένο ως κλάσμα αποθορυβοποίησης όχι μικρότερο από shape_slat_guidance_interval_start.

προεπιλογή 12

Πλήθος βημάτων αποθορυβοποίησης κατά την παραγωγή σχήματος.

προεπιλογή 3

Οξύτητα του χρονοδιαγράμματος θορύβου κατά την παραγωγή σχήματος.

προεπιλογή 1

Ισχύς καθοδήγησης χωρίς ταξινομητή κατά την παραγωγή υφής.

προεπιλογή 0

Επανακλιμάκωση που εφαρμόζεται στην καθοδήγηση κατά την παραγωγή υφής· αυξήστε την όταν οι υφές εμφανίζονται θορυβώδεις.

προεπιλογή 0.6

Κλάσμα αποθορυβοποίησης στο οποίο ξεκινά η καθοδήγηση του σταδίου υφής.

προεπιλογή 0.9

Σημείο διακοπής της καθοδήγησης του σταδίου υφής, εκφρασμένο ως κλάσμα αποθορυβοποίησης όχι μικρότερο από tex_slat_guidance_interval_start.

προεπιλογή 12

Πλήθος βημάτων αποθορυβοποίησης κατά την παραγωγή υφής.

προεπιλογή 3

Οξύτητα του χρονοδιαγράμματος θορύβου κατά την παραγωγή υφής.

προεπιλογή 500000

Επιθυμητός αριθμός κορυφών στην εξαγωγή GLB.

Τυχαίο seed που καθιστά την παραγωγή αναπαραγώγιμη.

POST /run/trellis-2-lora?wait=20 προσφορά → 0,25 $
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/v1/run/trellis-2-lora?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Εκτέλεση αυτού του αιτήματος

Το κλειδί σας παραμένει σε αυτό το πρόγραμμα περιήγησης: αποστέλλεται μόνο στο Doitong API και αποθηκεύεται (localStorage) μόνο αν ενεργοποιήσετε την επιλογή «Να απομνημονεύεται». Λήψη κλειδιού API

Σχετικά με το TRELLIS.2 LoRA Inference

Παράγει GLB από το `image_url`, εφαρμόζοντας προαιρετικά safetensors LoRAs μέσω των `sparse_structure_lora_url`, `geometry_lora_url` και `texture_lora_url`. Το `resolution` είναι 512 ή 1024 και πρέπει να ταιριάζει με την ανάλυση εκπαίδευσης των προσαρμογέων. Παρέχει επίσης στοιχεία ελέγχου καθοδήγησης και βημάτων ανά στάδιο, καθώς και τα `decimation_target` και `texture_size`.

Παράμετροι

Στείλτε είτε το κανονικό όνομα είτε το εγγενές όνομα, όχι και τα δύο. Κανονικά ονόματα

ΌνομαΤύπος ΠροεπιλογήΕπιτρεπόμενο Περιγραφή
image_urlαπαιτείται image
Τύποςurl · image
URL εικόνας πηγής για μετατροπή σε 3D μοντέλο.
sparse_structure_lora_urlπροαιρετικό
Τύποςstring | null
Προαιρετικό checkpoint LoRA σε μορφή safetensors, εκπαιδευμένο ειδικά για τον αποθορυβοποιητή αραιής δομής.
geometry_lora_urlπροαιρετικό
Τύποςstring | null
Προαιρετικό checkpoint LoRA σε μορφή safetensors, εκπαιδευμένο ειδικά για τον αποθορυβοποιητή γεωμετρίας.
texture_lora_urlπροαιρετικό
Τύποςstring | null
Προαιρετικό checkpoint LoRA σε μορφή safetensors, εκπαιδευμένο ειδικά για τον αποθορυβοποιητή υφής.
seedπροαιρετικό
Τύποςinteger | null
Τυχαίο seed που καθιστά την παραγωγή αναπαραγώγιμη.
resolutionπροαιρετικό
Τύποςenum
Προεπιλογή512
5121024
Ανάλυση παραγωγής, όπου η 1024 επιλέγει το cascade pipeline. Επιλέξτε την ανάλυση που χρησιμοποιήθηκε για την εκπαίδευση των παρεχόμενων adapters LoRA· απαιτείται αντιστοίχιση.
ss_guidance_strengthπροαιρετικό
Τύποςnumber
Προεπιλογή7.5
0 – 10
Ισχύς καθοδήγησης χωρίς ταξινομητή κατά την παραγωγή αραιής δομής.
ss_guidance_rescaleπροαιρετικό
Τύποςnumber
Προεπιλογή0.7
0 – 1
Επανακλιμάκωση καθοδήγησης κατά την παραγωγή αραιής δομής. Οι μεγαλύτερες τιμές κάνουν την έξοδο πιο σταθερή.
ss_guidance_interval_startπροαιρετικό
Τύποςnumber
Προεπιλογή0.6
0 – 1
Κλάσμα της προόδου αποθορυβοποίησης στο οποίο ξεκινά η καθοδήγηση αραιής δομής.
ss_guidance_interval_endπροαιρετικό
Τύποςnumber
Προεπιλογή1
0 – 1
Χρησιμοποιήστε κλάσμα αποθορυβοποίησης ίσο ή μεγαλύτερο από `ss_guidance_interval_start` για να καθορίσετε πότε σταματά η καθοδήγηση αραιής δομής.
ss_sampling_stepsπροαιρετικό
Τύποςinteger
Προεπιλογή12
1 – 50
Πλήθος βημάτων αποθορυβοποίησης κατά την παραγωγή αραιής δομής.
ss_rescale_tπροαιρετικό
Τύποςnumber
Προεπιλογή5
1 – 6
Οξύτητα του χρονοδιαγράμματος θορύβου κατά την παραγωγή αραιής δομής.
shape_slat_guidance_strengthπροαιρετικό
Τύποςnumber
Προεπιλογή7.5
0 – 10
Ισχύς καθοδήγησης χωρίς ταξινομητή κατά την παραγωγή σχήματος.
shape_slat_guidance_rescaleπροαιρετικό
Τύποςnumber
Προεπιλογή0.5
0 – 1
Επανακλιμάκωση που εφαρμόζεται στην καθοδήγηση κατά την παραγωγή σχήματος· αυξήστε την όταν η γεωμετρία εμφανίζεται θορυβώδης.
shape_slat_guidance_interval_startπροαιρετικό
Τύποςnumber
Προεπιλογή0.6
0 – 1
Κλάσμα αποθορυβοποίησης στο οποίο ξεκινά η καθοδήγηση του σταδίου σχήματος.
shape_slat_guidance_interval_endπροαιρετικό
Τύποςnumber
Προεπιλογή1
0 – 1
Σημείο διακοπής της καθοδήγησης του σταδίου σχήματος, εκφρασμένο ως κλάσμα αποθορυβοποίησης όχι μικρότερο από shape_slat_guidance_interval_start.
shape_slat_sampling_stepsπροαιρετικό
Τύποςinteger
Προεπιλογή12
1 – 50
Πλήθος βημάτων αποθορυβοποίησης κατά την παραγωγή σχήματος.
shape_slat_rescale_tπροαιρετικό
Τύποςnumber
Προεπιλογή3
1 – 6
Οξύτητα του χρονοδιαγράμματος θορύβου κατά την παραγωγή σχήματος.
tex_slat_guidance_strengthπροαιρετικό
Τύποςnumber
Προεπιλογή1
0 – 10
Ισχύς καθοδήγησης χωρίς ταξινομητή κατά την παραγωγή υφής.
tex_slat_guidance_rescaleπροαιρετικό
Τύποςnumber
Προεπιλογή0
0 – 1
Επανακλιμάκωση που εφαρμόζεται στην καθοδήγηση κατά την παραγωγή υφής· αυξήστε την όταν οι υφές εμφανίζονται θορυβώδεις.
tex_slat_guidance_interval_startπροαιρετικό
Τύποςnumber
Προεπιλογή0.6
0 – 1
Κλάσμα αποθορυβοποίησης στο οποίο ξεκινά η καθοδήγηση του σταδίου υφής.
tex_slat_guidance_interval_endπροαιρετικό
Τύποςnumber
Προεπιλογή0.9
0 – 1
Σημείο διακοπής της καθοδήγησης του σταδίου υφής, εκφρασμένο ως κλάσμα αποθορυβοποίησης όχι μικρότερο από tex_slat_guidance_interval_start.
tex_slat_sampling_stepsπροαιρετικό
Τύποςinteger
Προεπιλογή12
1 – 50
Πλήθος βημάτων αποθορυβοποίησης κατά την παραγωγή υφής.
tex_slat_rescale_tπροαιρετικό
Τύποςnumber
Προεπιλογή3
1 – 6
Οξύτητα του χρονοδιαγράμματος θορύβου κατά την παραγωγή υφής.
decimation_targetπροαιρετικό
Τύποςinteger
Προεπιλογή500000
5.000 – 2.000.000
Επιθυμητός αριθμός κορυφών στην εξαγωγή GLB.
texture_sizeπροαιρετικό
Τύποςenum
Προεπιλογή2048
102420484096
Ανάλυση των υφών που έχουν ενσωματωθεί στην εξαγωγή GLB.
enable_safety_checkerπροαιρετικό
Τύποςboolean
Προεπιλογήtrue
Ο έλεγχος μπορεί να χαλαρώσει με τη ρύθμιση false, εφόσον ο καλών είναι εξουσιοδοτημένος.
απαιτείται Κανονικό όνομα, επίσης αποδεκτό

Οι παράμετροι αρχείων δέχονται ένα δημόσιο URL https://, ένα URI data: έως 10 MB ή το file_url μιας μεταφόρτωσης. Αρχεία

Έξοδος

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "trellis-2-lora",
  "status": "succeeded",
  "created_at": "2026-10-20T12:00:00Z",
  "started_at": "2026-10-20T12:00:02Z",
  "completed_at": "2026-10-20T12:00:09Z",
  "queue_position": null,
  "cost": {
    "credits": 250,
    "usd": "0.25",
    "charged": 250,
    "refunded": 0
  },
  "input": {
    "image_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  },
  "output": {
    "model_glb": {
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
      "content_type": "image/jpeg",
      "file_name": "0-output.jpeg",
      "file_size": 1843200
    },
    "seed": 42,
    "resolution": 1,
    "sparse_structure_lora_url": "string",
    "geometry_lora_url": "string",
    "texture_lora_url": "string",
    "decimation_target": 1,
    "texture_size": 1
  },
  "outputs": [
    {
      "type": "file",
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
      "content_type": "image/jpeg",
      "file_size": 1843200,
      "stored": true
    }
  ],
  "error": null,
  "metrics": {
    "inference_seconds": 6.8
  },
  "urls": {
    "self": "https://api.doitong.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
Τα αρχεία σας, η επιλογή σαςΚάθε outputs[].url είναι ένα αντίγραφο στην αποθήκευσή μας: διατηρείται για πάντα (χρέωση ανά GB-μήνα) ή 7 ημέρες δωρεάν, σύμφωνα με τη ρύθμιση του λογαριασμού σας ή ?storage=.
Ίδια μορφή σε κάθε μοντέλοtype, url, content_type, width, height και duration, τόσο για εικόνες όσο και για βίντεο και ήχο. Το output είναι το αντικείμενο αποτελέσματος του ίδιου του μοντέλου.
Πεδία εξόδου
model_glb
object {url, content_type, file_name, file_size}Αρχείο GLB που περιέχει το παραγόμενο 3D μοντέλο.
seed
integerSeed που εφαρμόζεται κατά την παραγωγή.
resolution
integerΑνάλυση στην οποία πραγματοποιήθηκε η παραγωγή.
sparse_structure_lora_url
string | nullCheckpoint LoRA αραιής δομής που χρησιμοποιήθηκε κατά την παραγωγή, αν εφαρμόστηκε.
geometry_lora_url
string | nullCheckpoint LoRA γεωμετρίας που χρησιμοποιήθηκε κατά την παραγωγή, αν εφαρμόστηκε.
texture_lora_url
string | nullCheckpoint LoRA υφής που χρησιμοποιήθηκε κατά την παραγωγή, αν εφαρμόστηκε.
decimation_target
integerΣτόχος πλήθους κορυφών που εφαρμόστηκε στην εξαγωγή GLB.
texture_size
integerΑνάλυση των υφών που έχουν ενσωματωθεί στην εξαγωγή GLB.

Για πράκτορες AI: αυτή η σελίδα σε Markdown βρίσκεται στη διεύθυνση https://doitong.com/el/developers/models/trellis-2-lora.md. Όλα τα μοντέλα και οι οδηγοί: https://doitong.com/developers/llms.txt