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

Pixal3d

Ενσωμάτωση

id μοντέλου pixal3d
# 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/pixal3d?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 · ≈ 31,97 ₽ Εκτέλεση σε αυτήν τη σελίδα

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

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

Open model · 3D

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

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

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

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

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

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

resolution προεπιλογή 1024

Ανάλυση της εξόδου· η αύξησή της προσθέτει λεπτομέρεια αλλά απαιτεί περισσότερο χρόνο.

Για προχωρημένους texture_size · ss_guidance_strength · ss_guidance_rescale · ss_sampling_steps · ss_rescale_t · shape_slat_guidance_strength · shape_slat_guidance_rescale · shape_slat_sampling_steps · shape_slat_rescale_t · tex_slat_guidance_strength · tex_slat_guidance_rescale · tex_slat_sampling_steps · tex_slat_rescale_t · mesh_scale · max_num_tokens · decimation_target · seed · remesh · enable_safety_checker
texture_size προεπιλογή 2048

Ανάλυση υφής πλέγματος για baking. Η λεπτομερέστερη επιφάνεια συνεπάγεται μεγαλύτερα αρχεία όταν αυξάνεται αυτή η ανάλυση.

προεπιλογή 7.5

Έλεγχος πιστότητας αρχικής 3D δομής: η αύξησή του ευνοεί μεγαλύτερη συμφωνία με την εικόνα εισόδου, με κίνδυνο πρόσθετου θορύβου.

προεπιλογή 0.7

Έλεγχος τεχνουργημάτων καθοδήγησης στο στάδιο 1, με ισχυρότερα εφέ καθοδήγησης σε χαμηλές ρυθμίσεις και σταθερότερη έξοδο σε υψηλές.

προεπιλογή 12

Πλήθος βημάτων αποθορυβοποίησης αρχικής δομής: τα πιθανά κέρδη ποιότητας από πρόσθετα βήματα συνεπάγονται πιο αργή επεξεργασία.

προεπιλογή 5

Ορίστε την ευκρίνεια μετάβασης μέσω του χρονοδιαγράμματος θορύβου παραγωγής δομής: η αύξηση αυτής της τιμής κάνει τις μεταβάσεις πιο ευκρινείς.

προεπιλογή 7.5

Έλεγχος πιστότητας λεπτομερούς γεωμετρίας: η αυξημένη προσήλωση στην εικόνα εισόδου αποδίδει περισσότερη λεπτομέρεια, με κίνδυνο πρόσθετου θορύβου.

προεπιλογή 0.5

Αυξήστε αυτήν τη ρύθμιση όταν η γεωμετρία εμφανίζει θόρυβο: μειώνει τα τεχνουργήματα που προκαλούνται από ισχυρή καθοδήγηση στο στάδιο σχήματος.

προεπιλογή 12

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

προεπιλογή 3

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

προεπιλογή 1

Έλεγχος πιστότητας χρώματος υφής: η μεγαλύτερη προσήλωση στα χρώματα της εικόνας εισόδου σε υψηλότερες ρυθμίσεις αυξάνει τη ζωντάνια, αλλά μπορεί να προκαλέσει υπερκορεσμό.

προεπιλογή 0

Αυξήστε αυτήν τη ρύθμιση για την αντιμετώπιση θορυβωδών υφών ή ζωνώσεων χρώματος: μειώνει τα τεχνουργήματα που προκαλούνται από ισχυρή καθοδήγηση στο στάδιο υφής.

προεπιλογή 12

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

προεπιλογή 3

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

προεπιλογή 1

Κλιμακώστε το συναγόμενο πλέγμα για να επηρεάσετε την εκτίμηση απόστασης κάμερας που χρησιμοποιεί το μοντέλο.

προεπιλογή 49152

Όριο token HR για τον διαδοχικό δειγματολήπτη σχήματος, εξισορροπώντας τη λεπτότερη γεωμετρία σε υψηλότερες ρυθμίσεις με την εξοικονόμηση μνήμης και χρόνου επεξεργασίας σε χαμηλότερες.

προεπιλογή 200000

Στόχος πολυπλοκότητας πλέγματος, εκφρασμένος ως πλήθος κορυφών για το τελικό αποτέλεσμα. Η μείωση του μεγέθους αρχείου μέσω χαμηλότερου στόχου θυσιάζει επίσης λεπτομέρεια.

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

POST /run/pixal3d?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/pixal3d?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

Σχετικά με το Pixal3d

Λαμβάνει μία εικόνα και επιστρέφει ένα μοντέλο GLB μαζί με τον σπόρο που χρησιμοποιήθηκε. Τα στάδια δομής, σχήματος και υφής έχουν το καθένα δικές του ρυθμίσεις καθοδήγησης, επανακλιμάκωσης, πλήθους βημάτων και προγράμματος θορύβου. Η έξοδος `resolution` είναι 1024 ή 1536, το `texture_size` είναι 1024, 2048 ή 4096 και το `decimation_target` ορίζει το πλήθος κορυφών από 5000 έως 1586021. Το `remesh` ανακατασκευάζει την τοπολογία.

Παράμετροι

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

ΌνομαΤύπος ΠροεπιλογήΕπιτρεπόμενο Περιγραφή
image_urlαπαιτείται image
Τύποςurl · image
URL που δείχνει στην εικόνα προέλευσης για μετατροπή σε 3D.
seedπροαιρετικό
Τύποςinteger | null
Seed που χρησιμοποιείται για αναπαραγώγιμη τυχαία παραγωγή.
resolutionπροαιρετικό
Τύποςenum
Προεπιλογή1024
10241536
Ανάλυση της εξόδου· η αύξησή της προσθέτει λεπτομέρεια αλλά απαιτεί περισσότερο χρόνο.
ss_guidance_strengthπροαιρετικό
Τύποςnumber
Προεπιλογή7.5
0 – 10
Έλεγχος πιστότητας αρχικής 3D δομής: η αύξησή του ευνοεί μεγαλύτερη συμφωνία με την εικόνα εισόδου, με κίνδυνο πρόσθετου θορύβου.
ss_guidance_rescaleπροαιρετικό
Τύποςnumber
Προεπιλογή0.7
0 – 1
Έλεγχος τεχνουργημάτων καθοδήγησης στο στάδιο 1, με ισχυρότερα εφέ καθοδήγησης σε χαμηλές ρυθμίσεις και σταθερότερη έξοδο σε υψηλές.
ss_sampling_stepsπροαιρετικό
Τύποςinteger
Προεπιλογή12
1 – 50
Πλήθος βημάτων αποθορυβοποίησης αρχικής δομής: τα πιθανά κέρδη ποιότητας από πρόσθετα βήματα συνεπάγονται πιο αργή επεξεργασία.
ss_rescale_tπροαιρετικό
Τύποςnumber
Προεπιλογή5
1 – 6
Ορίστε την ευκρίνεια μετάβασης μέσω του χρονοδιαγράμματος θορύβου παραγωγής δομής: η αύξηση αυτής της τιμής κάνει τις μεταβάσεις πιο ευκρινείς.
shape_slat_guidance_strengthπροαιρετικό
Τύποςnumber
Προεπιλογή7.5
0 – 10
Έλεγχος πιστότητας λεπτομερούς γεωμετρίας: η αυξημένη προσήλωση στην εικόνα εισόδου αποδίδει περισσότερη λεπτομέρεια, με κίνδυνο πρόσθετου θορύβου.
shape_slat_guidance_rescaleπροαιρετικό
Τύποςnumber
Προεπιλογή0.5
0 – 1
Αυξήστε αυτήν τη ρύθμιση όταν η γεωμετρία εμφανίζει θόρυβο: μειώνει τα τεχνουργήματα που προκαλούνται από ισχυρή καθοδήγηση στο στάδιο σχήματος.
shape_slat_sampling_stepsπροαιρετικό
Τύποςinteger
Προεπιλογή12
1 – 50
Πλήθος βημάτων αποθορυβοποίησης βελτίωσης σχήματος: η δυνητικά ομαλότερη γεωμετρία επιβαρύνει την ταχύτητα όταν χρησιμοποιούνται πρόσθετα βήματα.
shape_slat_rescale_tπροαιρετικό
Τύποςnumber
Προεπιλογή3
1 – 6
Ορίστε την ευκρίνεια γεωμετρικών λεπτομερειών μέσω του χρονοδιαγράμματος θορύβου βελτίωσης σχήματος· η αύξηση αυτής της τιμής αποδίδει πιο ευκρινείς λεπτομέρειες.
tex_slat_guidance_strengthπροαιρετικό
Τύποςnumber
Προεπιλογή1
0 – 10
Έλεγχος πιστότητας χρώματος υφής: η μεγαλύτερη προσήλωση στα χρώματα της εικόνας εισόδου σε υψηλότερες ρυθμίσεις αυξάνει τη ζωντάνια, αλλά μπορεί να προκαλέσει υπερκορεσμό.
tex_slat_guidance_rescaleπροαιρετικό
Τύποςnumber
Προεπιλογή0
0 – 1
Αυξήστε αυτήν τη ρύθμιση για την αντιμετώπιση θορυβωδών υφών ή ζωνώσεων χρώματος: μειώνει τα τεχνουργήματα που προκαλούνται από ισχυρή καθοδήγηση στο στάδιο υφής.
tex_slat_sampling_stepsπροαιρετικό
Τύποςinteger
Προεπιλογή12
1 – 50
Πλήθος βημάτων αποθορυβοποίησης που χρησιμοποιούνται για την παραγωγή υφών. Η αύξηση του πλήθους απαιτεί περισσότερο χρόνο, αλλά μπορεί να αποδώσει καθαρότερες υφές.
tex_slat_rescale_tπροαιρετικό
Τύποςnumber
Προεπιλογή3
1 – 6
Ορίστε την ευκρίνεια λεπτομερειών υφής μέσω του χρονοδιαγράμματος θορύβου παραγωγής υφής· η αύξηση αυτής της τιμής αποδίδει πιο ευκρινείς λεπτομέρειες.
mesh_scaleπροαιρετικό
Τύποςnumber
Προεπιλογή1
0,1 – 4
Κλιμακώστε το συναγόμενο πλέγμα για να επηρεάσετε την εκτίμηση απόστασης κάμερας που χρησιμοποιεί το μοντέλο.
max_num_tokensπροαιρετικό
Τύποςinteger
Προεπιλογή49152
4.096 – 131.072
Όριο token HR για τον διαδοχικό δειγματολήπτη σχήματος, εξισορροπώντας τη λεπτότερη γεωμετρία σε υψηλότερες ρυθμίσεις με την εξοικονόμηση μνήμης και χρόνου επεξεργασίας σε χαμηλότερες.
decimation_targetπροαιρετικό
Τύποςinteger
Προεπιλογή200000
5.000 – 1.586.021
Στόχος πολυπλοκότητας πλέγματος, εκφρασμένος ως πλήθος κορυφών για το τελικό αποτέλεσμα. Η μείωση του μεγέθους αρχείου μέσω χαμηλότερου στόχου θυσιάζει επίσης λεπτομέρεια.
texture_sizeπροαιρετικό
Τύποςenum
Προεπιλογή2048
102420484096
Ανάλυση υφής πλέγματος για baking. Η λεπτομερέστερη επιφάνεια συνεπάγεται μεγαλύτερα αρχεία όταν αυξάνεται αυτή η ανάλυση.
remeshπροαιρετικό
Τύποςboolean
Προεπιλογήtrue
Ανακατασκευή τοπολογίας πλέγματος, η οποία γενικά ωφελεί την επακόλουθη χρήση δημιουργώντας καθαρότερα τρίγωνα, με τίμημα μεγαλύτερο χρόνο επεξεργασίας.
enable_safety_checkerπροαιρετικό
Τύποςboolean
Προεπιλογήtrue
Ο έλεγχος μπορεί να χαλαρώσει με τη ρύθμιση false, εφόσον ο καλών είναι εξουσιοδοτημένος.
απαιτείται Κανονικό όνομα, επίσης αποδεκτό

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

Έξοδος

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "pixal3d",
  "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_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
    },
    "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}3D μοντέλο που παράγεται σε μορφή GLB.
seed
integerΤιμή seed που χρησιμοποιήθηκε πραγματικά.

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