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

Hunyuan 3D Pro Image to 3D

Ενσωμάτωση

id μοντέλου hunyuan-3d/v3.1/pro/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/hunyuan-3d/v3.1/pro/image-to-3d?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "input_image_url": "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,375 $ 375 πιστώσεις API · ≈ 40,24 ₽ τα αρχεία σας μετρώνται πριν από την εκτέλεση Εκτέλεση σε αυτήν τη σελίδα

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

Δημιουργεί μοντέλο 3D από μπροστινή εικόνα και προαιρετικές πρόσθετες όψεις, με έλεγχο εδρών και PBR

Tencent · 3D

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

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

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

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

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

URL εικόνας μπροστινής όψης JPG, PNG ή WEBP, με ανάλυση από 128 έως 5000px και μέγεθος έως 8 MB. Προτιμήστε απλό φόντο και ένα αντικείμενο που καλύπτει πάνω από 50% του καρέ.

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

URL εικόνας πίσω όψης, προαιρετικά· συνιστάται JPG/PNG.

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

URL εικόνας αριστερής πλευράς, προαιρετικά· συνιστάται JPG/PNG.

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

URL εικόνας δεξιάς πλευράς, προαιρετικά· συνιστάται JPG/PNG.

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

URL εικόνας άνω όψης, προαιρετικά και διαθέσιμο μόνο στο v3.1· συνιστάται JPG/PNG.

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

URL προαιρετικής εικόνας κάτω όψης, υποστηρίζεται μόνο στο v3.1. Συνιστάται JPG/PNG.

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

Προαιρετικό URL εικόνας διαθέσιμο μόνο στο v3.1, κατά προτίμηση σε μορφή JPG/PNG. Η εικόνα παρέχει όψη 45 μοιρών από την αριστερή μπροστινή πλευρά.

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

Προαιρετικό URL εικόνας διαθέσιμο μόνο στο v3.1, κατά προτίμηση σε μορφή JPG/PNG. Η εικόνα παρέχει όψη 45 μοιρών από τη δεξιά μπροστινή πλευρά.

προεπιλογή 500000

Επιθυμητός αριθμός πολυγωνικών όψεων, από 40,000 έως 1,500,000. Προεπιλογή 500,000.

Για προχωρημένους generate_type
generate_type προεπιλογή Normal

Επιλέξτε μεταξύ μοντέλου με υφές και Normal και μοντέλου χωρίς υφές, λευκού και μόνο με γεωμετρία, με Geometry. Στο v3.1 δεν μπορούν να επιλεγούν LowPoly/Sketch.

POST /run/hunyuan-3d/v3.1/pro/image-to-3d?wait=20 προσφορά → 0,375 $
# 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/hunyuan-3d/v3.1/pro/image-to-3d?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "input_image_url": "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

Σχετικά με το Hunyuan 3D Pro Image to 3D

Δημιουργεί μοντέλο 3D από την απαιτούμενη μπροστινή εικόνα `input_image_url`. Προαιρετικές πίσω, αριστερή, δεξιά, πάνω, κάτω και δύο όψεις 45 μοιρών προσθέτουν λεπτομέρεια. Το `generate_type` επιλέγει μοντέλο με υφή ή λευκό μοντέλο μόνο με γεωμετρία, το `enable_pbr` προσθέτει υλικά PBR και το `face_count` κυμαίνεται από 40,000 έως 1,500,000. Επιστρέφει GLB, URL άλλων μορφών και μικρογραφία.

Παράμετροι

ΌνομαΤύπος ΠροεπιλογήΕπιτρεπόμενο Περιγραφή
input_image_urlαπαιτείται
Τύποςurl · image
URL εικόνας μπροστινής όψης JPG, PNG ή WEBP, με ανάλυση από 128 έως 5000px και μέγεθος έως 8 MB. Προτιμήστε απλό φόντο και ένα αντικείμενο που καλύπτει πάνω από 50% του καρέ.
back_image_urlπροαιρετικό
Τύποςurl · image
URL εικόνας πίσω όψης, προαιρετικά· συνιστάται JPG/PNG.
left_image_urlπροαιρετικό
Τύποςurl · image
URL εικόνας αριστερής πλευράς, προαιρετικά· συνιστάται JPG/PNG.
right_image_urlπροαιρετικό
Τύποςurl · image
URL εικόνας δεξιάς πλευράς, προαιρετικά· συνιστάται JPG/PNG.
top_image_urlπροαιρετικό
Τύποςurl · image
URL εικόνας άνω όψης, προαιρετικά και διαθέσιμο μόνο στο v3.1· συνιστάται JPG/PNG.
bottom_image_urlπροαιρετικό
Τύποςurl · image
URL προαιρετικής εικόνας κάτω όψης, υποστηρίζεται μόνο στο v3.1. Συνιστάται JPG/PNG.
left_front_image_urlπροαιρετικό
Τύποςurl · image
Προαιρετικό URL εικόνας διαθέσιμο μόνο στο v3.1, κατά προτίμηση σε μορφή JPG/PNG. Η εικόνα παρέχει όψη 45 μοιρών από την αριστερή μπροστινή πλευρά.
right_front_image_urlπροαιρετικό
Τύποςurl · image
Προαιρετικό URL εικόνας διαθέσιμο μόνο στο v3.1, κατά προτίμηση σε μορφή JPG/PNG. Η εικόνα παρέχει όψη 45 μοιρών από τη δεξιά μπροστινή πλευρά.
generate_typeπροαιρετικό
Τύποςenum
ΠροεπιλογήNormal
NormalGeometry
Επιλέξτε μεταξύ μοντέλου με υφές και Normal και μοντέλου χωρίς υφές, λευκού και μόνο με γεωμετρία, με Geometry. Στο v3.1 δεν μπορούν να επιλεγούν LowPoly/Sketch.
enable_pbrπροαιρετικό
Τύποςboolean
Προεπιλογήfalse
Εναλλαγή παραγωγής PBR, ανενεργή όταν το generate_type είναι Geometry. Διαφορετικά, η ενεργοποίησή της προσθέτει υφές μεταλλικότητας, τραχύτητας και normal στα παραγόμενα υλικά.
face_countπροαιρετικό
Τύποςinteger
Προεπιλογή500000
40.000 – 1.500.000
Επιθυμητός αριθμός πολυγωνικών όψεων, από 40,000 έως 1,500,000. Προεπιλογή 500,000.
απαιτείται

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

Έξοδος

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "hunyuan-3d/v3.1/pro/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": 375,
    "usd": "0.375",
    "charged": 375,
    "refunded": 0
  },
  "input": {
    "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
    },
    "thumbnail": {
      "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
      },
      "obj": {
        "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
      },
      "mtl": {
        "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
      },
      "texture": {
        "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
      },
      "usdz": {
        "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
  },
  "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_glb
object {url, content_type, file_name, file_size}Αρχείο GLB που περιέχει το παραγόμενο αντικείμενο 3D.
thumbnail
object {url, content_type, file_name, file_size} | nullΜικρογραφία που εμφανίζει προεπισκόπηση του παραγόμενου μοντέλου.
model_urls
object {glb, fbx, obj, mtl, texture, usdz}Σύνδεσμοι προς το μοντέλο 3D σε διάφορες μορφές.
seed
integer | nullΤιμή seed που χρησιμοποιείται κατά την παραγωγή.

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

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