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

Tripo3D · Image to 3D

Ενσωμάτωση

id μοντέλου tripo3d/tripo/v2.5/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/tripo/v2.5/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,19 ₽ τα αρχεία σας μετρώνται πριν από την εκτέλεση Εκτέλεση σε αυτήν τη σελίδα

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

Μετατροπή εικόνας σε 3D (v2.5) με προεπιλογές στυλ, HD υφές, έξοδο quad και επιλογές ευθυγράμμισης

Tripo · 3D

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

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

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

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

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

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

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

Ρύθμιση υφής για το μοντέλο: το 'standard' είναι η προεπιλογή, το 'no' απενεργοποιεί τις υφές και το 'HD' παράγει υφές υψηλής ευκρίνειας.

Ρύθμιση στυλ· αφήστε την απροσδιόριστη για να διατηρηθεί η αρχική εμφάνιση και το στυλ.

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

Ρύθμιση προτεραιότητας ευθυγράμμισης υφής για 3D μοντέλο, με χρήση του original_image εκτός αν παρέχεται άλλη τιμή.

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

Προσανατολισμός μοντέλου, αρχικά ορισμένος σε `default`. Επιλέξτε `align_image` για αυτόματη περιστροφή του μοντέλου ώστε να ευθυγραμμιστεί με την αρχική εικόνα.

Ανώτατο όριο αριθμού επιφανειών εξόδου, που επιλέγεται προσαρμοστικά εκτός αν παρέχετε ρητό όριο.

Ακέραιο seed που ελέγχει την παραγωγή γεωμετρίας· η επαναχρησιμοποίησή του παράγει πανομοιότυπα μοντέλα. Αν παραλειφθεί, επιλέγεται τυχαία τιμή.

Seed παραγωγής υφών, που παρέχεται ως ακέραιος ή επιλέγεται τυχαία όταν παραλείπεται. Ίδιες τιμές seed παράγουν ίδιες υφές· για αλλαγή των υφών ενός μοντέλου, μεταβάλετε το texture_seed διατηρώντας σταθερό το seed του μοντέλου.

POST /run/tripo3d/tripo/v2.5/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/tripo/v2.5/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

Σχετικά με το Tripo3D · Image to 3D

Δημιουργεί μοντέλο 3D από ένα `image_url`. Το `texture` μπορεί να είναι no, standard ή HD, με προαιρετική έξοδο PBR. Μια προεπιλογή `style`, όπως clay, steampunk, gold ή ancient bronze, αλλάζει το στυλ του αποτελέσματος. Άλλες επιλογές είναι τα `face_limit`, `quad` (επιβάλλει FBX), `auto_size`, `texture_alignment` και `orientation`, για ευθυγράμμιση του μοντέλου με την εικόνα.

Παράμετροι

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

ΌνομαΤύπος ΠροεπιλογήΕπιτρεπόμενο Περιγραφή
seedπροαιρετικό
Τύποςinteger | null
Ακέραιο seed που ελέγχει την παραγωγή γεωμετρίας· η επαναχρησιμοποίησή του παράγει πανομοιότυπα μοντέλα. Αν παραλειφθεί, επιλέγεται τυχαία τιμή.
face_limitπροαιρετικό
Τύποςinteger | null
Ανώτατο όριο αριθμού επιφανειών εξόδου, που επιλέγεται προσαρμοστικά εκτός αν παρέχετε ρητό όριο.
pbrπροαιρετικό
Τύποςboolean | null
Προεπιλογήfalse
Διακόπτης PBR: το False παράγει μοντέλο χωρίς PBR, ενώ το True παρακάμπτει τη ρύθμιση υφής και τη θεωρεί True. Το PBR είναι ενεργοποιημένο από προεπιλογή.
textureπροαιρετικό
Τύποςenum
Προεπιλογήstandard
nostandardHD
Ρύθμιση υφής για το μοντέλο: το 'standard' είναι η προεπιλογή, το 'no' απενεργοποιεί τις υφές και το 'HD' παράγει υφές υψηλής ευκρίνειας.
texture_seedπροαιρετικό
Τύποςinteger | null
Seed παραγωγής υφών, που παρέχεται ως ακέραιος ή επιλέγεται τυχαία όταν παραλείπεται. Ίδιες τιμές seed παράγουν ίδιες υφές· για αλλαγή των υφών ενός μοντέλου, μεταβάλετε το texture_seed διατηρώντας σταθερό το seed του μοντέλου.
auto_sizeπροαιρετικό
Τύποςboolean | null
Προεπιλογήfalse
Διακόπτης διαστάσεων πραγματικού κόσμου, απενεργοποιημένος από προεπιλογή (False), που προσαρμόζει αυτόματα τις διαστάσεις του μοντέλου με χρήση μέτρων.
styleπροαιρετικό
Τύποςenum
person:person2cartoonobject:clayobject:steampunkanimal:venomobject:barbieobject:christmasgoldancient_bronze
Ρύθμιση στυλ· αφήστε την απροσδιόριστη για να διατηρηθεί η αρχική εμφάνιση και το στυλ.
quadπροαιρετικό
Τύποςboolean | null
Προεπιλογήfalse
Η λειτουργία quad επιβάλλει έξοδο FBX όταν είναι ενεργοποιημένη. Με quad=True και χωρίς καθορισμένο face_limit, το face_limit έχει προεπιλεγμένη τιμή 10000.
texture_alignmentπροαιρετικό
Τύποςenum
Προεπιλογήoriginal_image
original_imagegeometry
Ρύθμιση προτεραιότητας ευθυγράμμισης υφής για 3D μοντέλο, με χρήση του original_image εκτός αν παρέχεται άλλη τιμή.
orientationπροαιρετικό
Τύποςenum
Προεπιλογήdefault
defaultalign_image
Προσανατολισμός μοντέλου, αρχικά ορισμένος σε `default`. Επιλέξτε `align_image` για αυτόματη περιστροφή του μοντέλου ώστε να ευθυγραμμιστεί με την αρχική εικόνα.
image_urlαπαιτείται image
Τύποςurl · image
URL εικόνας που χρησιμοποιείται για την παραγωγή του μοντέλου.
απαιτείται Κανονικό όνομα, επίσης αποδεκτό

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

Έξοδος

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "tripo3d/tripo/v2.5/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": {
    "task_id": "string",
    "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
    },
    "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
    }
  },
  "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 είναι το αντικείμενο αποτελέσματος του ίδιου του μοντέλου.
Πεδία εξόδου
task_id
stringΑναγνωριστικό εργασίας για την παραγωγή του 3D μοντέλου.
model_mesh
object {url, content_type, file_name, file_size} | nullΈξοδος μοντέλου.
base_model
object {url, content_type, file_name, file_size} | nullΈξοδος βασικού μοντέλου.
pbr_model
object {url, content_type, file_name, file_size} | nullΈξοδος μοντέλου PBR.
rendered_image
object {url, content_type, file_name, file_size} | nullΕικόνα που εμφανίζει προεπισκόπηση του μοντέλου.

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

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