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

Tripo H3.1 Multiview to 3D

Ενσωμάτωση

id μοντέλου tripo3d/h3.1/multiview-to-3d
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.ru/v1/run/tripo3d/h3.1/multiview-to-3d?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "images": [
      "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg",
      "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.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Αρχεία όπως το παράδειγμα: 0,30 $ 300 πιστώσεις API · ≈ 32,27 ₽ τα αρχεία σας μετρώνται πριν από την εκτέλεση Εκτέλεση σε αυτήν τη σελίδα

Λήψη κλειδιού API
Tripo Εικόνα σε 3D #3d#multiview-to-3d#3d-generation#tripo

Δημιουργεί 3D μοντέλο από 2 έως 4 όψεις ενός αντικειμένου, με σειρά front, left, back, right

Tripo · 3D

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

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

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

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

•απαιτείται image_urls
Αποθέστε ένα αρχείο ή · έως 4

URL εικόνων από πολλές γωνίες για ένα αντικείμενο, συμπεριλαμβανομένης υποχρεωτικής μπροστινής όψης. Δώστε 2 έως 4 URL με σειρά [front, left, back, right].

texture_quality προεπιλογή standard

Ρύθμιση ποιότητας για τις υφές.

geometry_quality προεπιλογή standard

Ρύθμιση ποιότητας γεωμετρίας.

Για προχωρημένους texture_alignment · orientation · face_limit · model_seed · texture_seed · auto_size · enable_safety_checker
texture_alignment προεπιλογή original_image

Μέθοδος ευθυγράμμισης για τις υφές.

orientation προεπιλογή default

Προσανατολισμός του μοντέλου.

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

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

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

POST /run/tripo3d/h3.1/multiview-to-3d?wait=20 προσφορά → 0,30 $
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.ru/v1/run/tripo3d/h3.1/multiview-to-3d?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "images": [
      "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg",
      "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.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

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

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

Σχετικά με το Tripo H3.1 Multiview to 3D

Δέχεται 2 έως 4 εικόνες του ίδιου αντικειμένου στο `image_urls`, με σειρά μπροστά, αριστερά, πίσω, δεξιά, όπου η μπροστινή όψη είναι υποχρεωτική. Κοινές επιλογές με την έκδοση μίας εικόνας: `face_limit` (1,000 έως 2,000,000), `pbr`, ποιότητα υφής και γεωμετρίας, πλέγματα `quad` και `auto_size`. Επιστρέφει το μοντέλο, απόδοση προεπισκόπησης και task ID.

Παράμετροι

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

ΌνομαΤύπος ΠροεπιλογήΕπιτρεπόμενο Περιγραφή
image_urlsαπαιτείται images
Τύποςurl[] · image
≤ 4 στοιχεία≥ 2 στοιχεία
URL εικόνων από πολλές γωνίες για ένα αντικείμενο, συμπεριλαμβανομένης υποχρεωτικής μπροστινής όψης. Δώστε 2 έως 4 URL με σειρά [front, left, back, right].
face_limitπροαιρετικό
Τύποςinteger | null
1.000 – 2.000.000
Ρητός στόχος πλήθους εδρών για παραγωγή mesh, που παρακάμπτει την προσαρμοστική επιλογή πλήθους του μοντέλου όταν παρέχεται.
textureπροαιρετικό
Τύποςboolean
Προεπιλογήtrue
Καθορίζει αν το μοντέλο λαμβάνει παραγόμενες υφές.
pbrπροαιρετικό
Τύποςboolean
Προεπιλογήtrue
Ενεργοποιεί υλικά PBR (Physically Based Rendering), το οποίο ενεργοποιεί επίσης την παραγωγή υφών όταν είναι true.
model_seedπροαιρετικό
Τύποςinteger | null
Seed που χρησιμοποιείται για αναπαραγώγιμη παραγωγή γεωμετρίας.
texture_seedπροαιρετικό
Τύποςinteger | null
Seed που χρησιμοποιείται για αναπαραγώγιμη παραγωγή υφών.
texture_qualityπροαιρετικό
Τύποςenum
Προεπιλογήstandard
standarddetailed
Ρύθμιση ποιότητας για τις υφές.
geometry_qualityπροαιρετικό
Τύποςenum
Προεπιλογήstandard
standarddetailed
Ρύθμιση ποιότητας γεωμετρίας.
texture_alignmentπροαιρετικό
Τύποςenum
Προεπιλογήoriginal_image
original_imagegeometry
Μέθοδος ευθυγράμμισης για τις υφές.
auto_sizeπροαιρετικό
Τύποςboolean
Προεπιλογήfalse
Αυτόματη κλιμάκωση ώστε το μοντέλο να αποκτήσει διαστάσεις πραγματικού κόσμου μετρημένες σε μέτρα.
orientationπροαιρετικό
Τύποςenum
Προεπιλογήdefault
defaultalign_image
Προσανατολισμός του μοντέλου.
quadπροαιρετικό
Τύποςboolean
Προεπιλογήfalse
Επιλέξτε μεταξύ τριγωνικών επιφανειών και τετραπλεύρων με 4 πλευρές ενεργοποιώντας την τοπολογία quad. Για αποτελέσματα quad, επιστρέφεται αρχείο FBX όταν το Tripo παρέχει τα δεδομένα ως bytes FBX.
enable_safety_checkerπροαιρετικό
Τύποςboolean
Προεπιλογήtrue
Ο έλεγχος μπορεί να χαλαρώσει με τη ρύθμιση false, εφόσον ο καλών είναι εξουσιοδοτημένος.
απαιτείται Κανονικό όνομα, επίσης αποδεκτό

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

Έξοδος

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "tripo3d/h3.1/multiview-to-3d",
  "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": 300,
    "usd": "0.30",
    "charged": 300,
    "refunded": 0
  },
  "input": {
    "image_urls": [
      "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg",
      "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
    },
    "model_urls": {
      "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
      },
      "fbx": {
        "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
      },
      "base_model": {
        "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
      },
      "pbr_model": {
        "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
      }
    },
    "rendered_image": {
      "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
    },
    "task_id": "string"
  },
  "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.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.ru/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}Αρχείο GLB ή FBX που περιέχει το παραγόμενο 3D μοντέλο, με τη μορφή να καθορίζεται από αυτό που παράγει το Tripo.
model_urls
object {glb, fbx, base_model, pbr_model}URL που παραπέμπουν σε εναλλακτικές εκδόσεις του 3D μοντέλου.
rendered_image
object {url, content_type, file_name, file_size} | nullΑποδοσμένη προεπισκόπηση που εμφανίζει το παραγόμενο 3D μοντέλο.
task_id
string | nullΕπαναχρησιμοποιήσιμο ID εργασίας Tripo που προσδιορίζει το παραγόμενο μοντέλο για rig ή rig-check και επιτρέπει αυτές τις λειτουργίες χωρίς νέα μεταφόρτωση μοντέλου.

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

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