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

Tripo H3.1 Image to 3D

Ενσωμάτωση

id μοντέλου tripo3d/h3.1/image-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/image-to-3d?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.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

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

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

Παραγωγή 3D από μία εικόνα με υλικά PBR, τετραγωνικά πλέγματα και έλεγχο αριθμού επιφανειών

Tripo · 3D

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

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

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

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

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

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

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

Ρύθμιση ποιότητας υφής· η επιλογή 'detailed' αυξάνει την ανάλυση της υφής.

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

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

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

Αναφορά ευθυγράμμισης υφής: χρησιμοποιήστε 'geometry' για τη γεωμετρία που παράγεται ή 'original_image' για την εικόνα εισόδου.

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

Προσανατολισμός του μοντέλου· το 'align_image' το περιστρέφει αυτόματα ώστε να ταιριάζει με την εικόνα εισόδου.

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

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

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

POST /run/tripo3d/h3.1/image-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/image-to-3d?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.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

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

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

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

Δημιουργεί μοντέλο 3D από μία εικόνα στο `image_url`. Οι επιλογές περιλαμβάνουν `face_limit` (1,000 έως 2,000,000), `texture`, `pbr`, τυπική ή λεπτομερή `texture_quality` και `geometry_quality`, τοπολογία `quad`, `auto_size` και `orientation`. Το αποτέλεσμα περιλαμβάνει απόδοση προεπισκόπησης και αναγνωριστικό εργασίας για μεταγενέστερο rigging.

Παράμετροι

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

ΌνομαΤύπος ΠροεπιλογήΕπιτρεπόμενο Περιγραφή
image_urlαπαιτείται image
Τύποςurl · image
URL εικόνας εισόδου που χρησιμοποιείται για τη δημιουργία 3D μοντέλου.
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
Ρύθμιση ποιότητας υφής· η επιλογή 'detailed' αυξάνει την ανάλυση της υφής.
geometry_qualityπροαιρετικό
Τύποςenum
Προεπιλογήstandard
standarddetailed
Ρύθμιση ποιότητας γεωμετρίας.
texture_alignmentπροαιρετικό
Τύποςenum
Προεπιλογήoriginal_image
original_imagegeometry
Αναφορά ευθυγράμμισης υφής: χρησιμοποιήστε 'geometry' για τη γεωμετρία που παράγεται ή 'original_image' για την εικόνα εισόδου.
auto_sizeπροαιρετικό
Τύποςboolean
Προεπιλογήfalse
Αυτόματη κλιμάκωση ώστε το μοντέλο να αποκτήσει διαστάσεις πραγματικού κόσμου μετρημένες σε μέτρα.
orientationπροαιρετικό
Τύποςenum
Προεπιλογήdefault
defaultalign_image
Προσανατολισμός του μοντέλου· το 'align_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/image-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_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
    },
    "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/image-to-3d.md. Όλα τα μοντέλα και οι οδηγοί: https://doitong.com/developers/llms.txt