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

Hyper3D - Rodin V2.5 - Image to 3D - Fast

Ενσωμάτωση

id μοντέλου hyper3d/rodin/v2.5/fast
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/v1/run/hyper3d/rodin/v2.5/fast?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": ""
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Αυτό το αίτημα: 0,10 $ 100 πιστώσεις API Εκτέλεση σε αυτήν τη σελίδα

Λήψη κλειδιού API
Hyper3D Εικόνα σε 3D Έξοδος 4KΓρήγορο #image-to-3d

Ταχύτερη μετατροπή εικόνας σε 3D με Rodin V2.5, περιορισμένη στα τρία χαμηλότερα επίπεδα για γρήγορη πρωτοτυποποίηση

Hyper3D · 3D

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

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

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

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

0 / 1024

Καθοδηγήστε την παραγωγή με κείμενο ή αφήστε το μοντέλο να αντλήσει αυτόματα ένα prompt από τις εικόνες, αφήνοντας το κενό στη λειτουργία Image-to-3D.

Για προχωρημένους images · geometry_file_format · material · texture_mode · tier · quality_mesh_option · seed · use_original_alpha · enable_creative_mode · hd_texture · texture_delight · is_micro · TAPose · preview_render · enable_safety_checker · bbox_condition
image_urls
Αποθέστε ένα αρχείο ή · έως 5

URL εικόνων πηγής, έως 5 εικόνες και υποχρεωτικά στη λειτουργία Image-to-3D, για την παραγωγή του μοντέλου.

geometry_file_format προεπιλογή glb

Μορφή αρχείου γεωμετρίας, επιλεγμένη από glb, usdz, fbx, obj, stl· προεπιλογή glb.

material προεπιλογή Shaded

Επιλογή εξόδου υλικού: επιλέξτε None για γεωμετρία χωρίς υφές ή All για λήψη και των δύο παραλλαγών υλικού. Για ρεαλιστικό φωτισμό με φυσικά βασισμένα υλικά, επιλέξτε PBR· για baked φωτισμό χωρίς χάρτες PBR, επιλέξτε Shaded.

texture_mode

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

προεπιλογή Gen-2.5-Extreme-Low

Βαθμίδα παραγωγής· το Gen-2.5-Minimum επιβάλλει λειτουργία minimum και mesh 50K Triangle ανεξάρτητα από το `quality_mesh_option`. Λεπτομέρειες βαθμίδων στην [τεκμηρίωση Hyper3D](https://developer.hyper3d.ai/api-specification/rodin-gen2.5#use-gen-2.5-generation-with-following-gen-2.5-tiers).

προεπιλογή Auto

Επιλέξτε την ποιότητα μαζί με την τοπολογία mesh: το Quad ευνοεί λείες επιφάνειες, ενώ το Triangle τη γεωμετρική λεπτομέρεια. Το fast τελικό σημείο προορίζεται κυρίως για δοκιμές και prototyping, με όριο 20K· χρησιμοποιήστε το standard τελικό σημείο για mesh υψηλότερης ποιότητας, όπου τα Minimum, Extreme-Low και Low υποστηρίζουν έως 1M Triangle, με διαθέσιμο πλήθος faces ανάλογα με τη βαθμίδα. Στο Hyper3D API, το `quality_override` καθορίζει το πλήθος faces, ενώ το `mesh_mode` καθορίζει Quad/Raw. Η Auto επιλέγει τις προτεινόμενες ρυθμίσεις: 1. Gen-2.5-Minimum → 20K Triangle; 2. Gen-2.5-Extreme-Low → 20K Triangle; 3. Gen-2.5-Low → 20K Triangle.

Προαιρετικό τυχαίο seed, με εύρος 0–65535.

Περιορίστε το μέγιστο μέγεθος του παραγόμενου μοντέλου χρησιμοποιώντας ControlNet.

POST /run/hyper3d/rodin/v2.5/fast?wait=20 προσφορά → 0,10 $
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/v1/run/hyper3d/rodin/v2.5/fast?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": ""
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

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

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

Σχετικά με το Hyper3D - Rodin V2.5 - Image to 3D - Fast

Δημιουργεί μοντέλο 3D από μία έως πέντε εικόνες στο `image_urls`, με προαιρετικό `prompt`. Το `tier` περιορίζεται στα Minimum, Extreme-Low (προεπιλογή) και Low, ενώ οι επιλογές πλέγματος φτάνουν έως 20K έδρες. Το Material έχει προεπιλογή Shaded. Οι μορφές εξόδου είναι glb, usdz, fbx, obj ή stl.

Παράμετροι

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

ΌνομαΤύπος ΠροεπιλογήΕπιτρεπόμενο Περιγραφή
image_urlsπροαιρετικό images
Τύποςurl[] · image
≤ 5 στοιχεία
URL εικόνων πηγής, έως 5 εικόνες και υποχρεωτικά στη λειτουργία Image-to-3D, για την παραγωγή του μοντέλου.
tierπροαιρετικό
Τύποςenum
ΠροεπιλογήGen-2.5-Extreme-Low
Gen-2.5-MinimumGen-2.5-Extreme-LowGen-2.5-Low
Βαθμίδα παραγωγής· το Gen-2.5-Minimum επιβάλλει λειτουργία minimum και mesh 50K Triangle ανεξάρτητα από το `quality_mesh_option`. Λεπτομέρειες βαθμίδων στην [τεκμηρίωση Hyper3D](https://developer.hyper3d.ai/api-specification/rodin-gen2.5#use-gen-2.5-generation-with-following-gen-2.5-tiers).
promptπροαιρετικό
Τύποςstring
Προεπιλογή
≤ 1.024 χαρακτήρες
Καθοδηγήστε την παραγωγή με κείμενο ή αφήστε το μοντέλο να αντλήσει αυτόματα ένα prompt από τις εικόνες, αφήνοντας το κενό στη λειτουργία Image-to-3D.
use_original_alphaπροαιρετικό
Τύποςboolean
Προεπιλογήfalse
Ελέγχει τη διατήρηση των καναλιών διαφάνειας των εικόνων εισόδου κατά την παραγωγή περιεχομένου 3D.
seedπροαιρετικό
Τύποςinteger | null
0 – 65.535
Προαιρετικό τυχαίο seed, με εύρος 0–65535.
geometry_file_formatπροαιρετικό
Τύποςenum
Προεπιλογήglb
glbusdzfbxobjstl
Μορφή αρχείου γεωμετρίας, επιλεγμένη από glb, usdz, fbx, obj, stl· προεπιλογή glb.
materialπροαιρετικό
Τύποςenum
ΠροεπιλογήShaded
PBRShadedAllNone
Επιλογή εξόδου υλικού: επιλέξτε None για γεωμετρία χωρίς υφές ή All για λήψη και των δύο παραλλαγών υλικού. Για ρεαλιστικό φωτισμό με φυσικά βασισμένα υλικά, επιλέξτε PBR· για baked φωτισμό χωρίς χάρτες PBR, επιλέξτε Shaded.
quality_mesh_optionπροαιρετικό
Τύποςenum
ΠροεπιλογήAuto
Auto1K Quad4K Quad8K Quad18K Quad20K Quad2K Triangle4K Triangle8K Triangle10K Triangle20K Triangle
Επιλέξτε την ποιότητα μαζί με την τοπολογία mesh: το Quad ευνοεί λείες επιφάνειες, ενώ το Triangle τη γεωμετρική λεπτομέρεια. Το fast τελικό σημείο προορίζεται κυρίως για δοκιμές και prototyping, με όριο 20K· χρησιμοποιήστε το standard τελικό σημείο για mesh υψηλότερης ποιότητας, όπου τα Minimum, Extreme-Low και Low υποστηρίζουν έως 1M Triangle, με διαθέσιμο πλήθος faces ανάλογα με τη βαθμίδα. Στο Hyper3D API, το `quality_override` καθορίζει το πλήθος faces, ενώ το `mesh_mode` καθορίζει Quad/Raw. Η Auto επιλέγει τις προτεινόμενες ρυθμίσεις: 1. Gen-2.5-Minimum → 20K Triangle; 2. Gen-2.5-Extreme-Low → 20K Triangle; 3. Gen-2.5-Low → 20K Triangle.
texture_modeπροαιρετικό
Τύποςenum
legacyextreme-lowlowmediumhigh
Επιλέξτε ρητά την ποιότητα υφής ή αφήστε την επιλογή στο API, το οποίο χρησιμοποιεί προεπιλογή κατάλληλη για τη βαθμίδα.
enable_creative_modeπροαιρετικό
Τύποςboolean
Προεπιλογήfalse
Λειτουργία δημιουργικής παραγωγής, ισοδύναμη με `geometry_instruct_mode` με τιμή `creative` στο Hyper3D API. Η ενεργοποίησή της κάνει την παραγωγή πιο robust χωρίς να θυσιάζει τη συνέπεια της εξόδου.
hd_textureπροαιρετικό
Τύποςboolean
Προεπιλογήfalse
Ελέγχει την προχωρημένη μετεπεξεργασία υφών για βελτίωση της οπτικής πιστότητας.
texture_delightπροαιρετικό
Τύποςboolean
Προεπιλογήfalse
Αφαιρεί τον ενσωματωμένο φωτισμό και τις ανταύγειες από τις παραγόμενες υφές.
is_microπροαιρετικό
Τύποςboolean
Προεπιλογήfalse
Προσθέτει λεπτομερέστερη γεωμετρία σε μικροκλίμακα· εφαρμόζεται μόνο όταν `tier="Gen-2.5-Extreme-High"`.
TAPoseπροαιρετικό
Τύποςboolean
Προεπιλογήfalse
Ρύθμιση στάσης χαρακτήρα για ευκολότερο rigging και animation σε λογισμικό 3D: όταν ενεργοποιείται, παράγει χαρακτήρες σε στάση T ή A.
bbox_conditionπροαιρετικό
Τύποςobject
Περιορίστε το μέγιστο μέγεθος του παραγόμενου μοντέλου χρησιμοποιώντας ControlNet.
bbox_condition.widthπροαιρετικό
Τύποςinteger
Προεπιλογή0
1 – 2.048
Περιορισμός πλάτους του bounding box στον άξονα x.
bbox_condition.heightπροαιρετικό
Τύποςinteger
Προεπιλογή0
1 – 2.048
Περιορισμός ύψους του bounding box στον άξονα y.
bbox_condition.lengthπροαιρετικό
Τύποςinteger
Προεπιλογή0
1 – 2.048
Περιορισμός μήκους του bounding box στον άξονα z.
preview_renderπροαιρετικό
Τύποςboolean
Προεπιλογήfalse
Εναλλαγή preview-render που προσθέτει εικόνα του παραγόμενου μοντέλου 3D στα παραδοτέα αρχεία μοντέλου.
enable_safety_checkerπροαιρετικό
Τύποςboolean
Προεπιλογήtrue
Ο έλεγχος μπορεί να χαλαρώσει με τη ρύθμιση false, εφόσον ο καλών είναι εξουσιοδοτημένος.
απαιτείται Κανονικό όνομα, επίσης αποδεκτό

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

Έξοδος

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "hyper3d/rodin/v2.5/fast",
  "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": 100,
    "usd": "0.10",
    "charged": 100,
    "refunded": 0
  },
  "input": {
    "prompt": ""
  },
  "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_meshes": [
      {
        "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,
    "textures": [
      {
        "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,
        "width": 1024,
        "height": 768
      }
    ]
  },
  "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.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.com/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}Αρχείο που περιέχει το παραγόμενο αντικείμενο 3D.
model_meshes
array of object {url, content_type, file_name, file_size}Επιπλέον αρχεία αντικειμένων 3D που παράγονται από το Hyper3D και επιστρέφονται επιπλέον του model_mesh.
seed
integerSeed που εφαρμόζεται κατά την παραγωγή.
textures
array of object {url, content_type, file_name, file_size, width, height}Υφές που παράγονται για το αντικείμενο 3D.

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

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