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

Trellis

Ενσωμάτωση

id μοντέλου trellis
# 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?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,02 $ 20 πιστώσεις API Εκτέλεση σε αυτήν τη σελίδα

Λήψη κλειδιού API
Microsoft Εικόνα σε 3D #stylized

Γεννήτρια πλέγματος 3D από μία εικόνα με ρυθμίσεις μεγέθους υφής και απλοποίησης πλέγματος

Microsoft · 3D

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

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

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

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

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

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

Για προχωρημένους texture_size · ss_guidance_strength · ss_sampling_steps · slat_guidance_strength · slat_sampling_steps · mesh_simplify · seed
texture_size προεπιλογή 1024

Ανάλυση που χρησιμοποιείται για την υφή.

προεπιλογή 7.5

Ένταση καθοδήγησης που χρησιμοποιείται κατά την παραγωγή αραιής δομής.

προεπιλογή 12

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

προεπιλογή 3

Ένταση καθοδήγησης που χρησιμοποιείται κατά την παραγωγή δομημένων λανθανουσών αναπαραστάσεων.

προεπιλογή 12

Πλήθος βημάτων δειγματοληψίας που χρησιμοποιούνται για την παραγωγή δομημένων λανθανουσών αναπαραστάσεων.

προεπιλογή 0.95

Παράγοντας που ελέγχει την απλοποίηση του mesh.

Seed που χρησιμοποιείται για αναπαραγώγιμη τυχαία παραγωγή.

POST /run/trellis?wait=20 προσφορά → 0,02 $
# 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?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

Μετατρέπει μία εικόνα από `image_url` σε πλέγμα 3D με υφή. Οι ρυθμιζόμενες παράμετροι περιλαμβάνουν ένταση καθοδήγησης και βήματα δειγματοληψίας για τα στάδια δομής και latent, `mesh_simplify` (0.9 έως 0.98) και `texture_size` 512, 1024 ή 2048. Ένας `seed` κάνει τα αποτελέσματα επαναλήψιμα.

Παράμετροι

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

ΌνομαΤύπος ΠροεπιλογήΕπιτρεπόμενο Περιγραφή
image_urlαπαιτείται image
Τύποςurl · image
URL που δείχνει στην εικόνα προέλευσης για μετατροπή σε 3D.
seedπροαιρετικό
Τύποςinteger | null
Seed που χρησιμοποιείται για αναπαραγώγιμη τυχαία παραγωγή.
ss_guidance_strengthπροαιρετικό
Τύποςnumber
Προεπιλογή7.5
0 – 10
Ένταση καθοδήγησης που χρησιμοποιείται κατά την παραγωγή αραιής δομής.
ss_sampling_stepsπροαιρετικό
Τύποςinteger
Προεπιλογή12
1 – 50
Πλήθος βημάτων δειγματοληψίας που χρησιμοποιούνται για την παραγωγή αραιής δομής.
slat_guidance_strengthπροαιρετικό
Τύποςnumber
Προεπιλογή3
0 – 10
Ένταση καθοδήγησης που χρησιμοποιείται κατά την παραγωγή δομημένων λανθανουσών αναπαραστάσεων.
slat_sampling_stepsπροαιρετικό
Τύποςinteger
Προεπιλογή12
1 – 50
Πλήθος βημάτων δειγματοληψίας που χρησιμοποιούνται για την παραγωγή δομημένων λανθανουσών αναπαραστάσεων.
mesh_simplifyπροαιρετικό
Τύποςnumber
Προεπιλογή0.95
0,9 – 0,98
Παράγοντας που ελέγχει την απλοποίηση του mesh.
texture_sizeπροαιρετικό
Τύποςenum
Προεπιλογή1024
51210242048
Ανάλυση που χρησιμοποιείται για την υφή.
απαιτείται Κανονικό όνομα, επίσης αποδεκτό

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

Έξοδος

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "trellis",
  "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": 20,
    "usd": "0.02",
    "charged": 20,
    "refunded": 0
  },
  "input": {
    "image_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  },
  "output": {
    "model_mesh": {
      "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
    },
    "timings": {}
  },
  "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_mesh
object {url, content_type, file_name, file_size}Αρχείο που περιέχει το παραγόμενο 3D mesh.
timings
objectΜετρήσεις χρονισμού για την επεξεργασία.

Περισσότερα μοντέλα: Εικόνα σε 3D

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