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

Hyper3D - Rodin V2.5 - Text to 3D

Ενσωμάτωση

id μοντέλου hyper3d/rodin/v2.5/text-to-3d
# 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/text-to-3d?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  }'

# 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,40 $ 400 πιστώσεις API Εκτέλεση σε αυτήν τη σελίδα

Λήψη κλειδιού API
Hyper3D Κείμενο σε 3D Έξοδος 4KΓρήγορο #text-to-3d

Μετατροπή κειμένου σε 3D με Rodin V2.5 σε έξι επίπεδα, από προτροπή έως 1024 χαρακτήρων

Hyper3D · 3D

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

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

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

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

•απαιτείται 88 / 1024

Οδηγίες κειμένου που καθοδηγούν την παραγωγή μοντέλου· υποχρεωτικές στη λειτουργία Text-to-3D.

Για προχωρημένους geometry_file_format · material · texture_mode · tier · quality_mesh_option · seed · enable_creative_mode · hd_texture · texture_delight · is_micro · TAPose · enable_safety_checker · bbox_condition · addons
geometry_file_format προεπιλογή glb

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

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

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

texture_mode

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

προεπιλογή Gen-2.5-High

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

προεπιλογή Auto

Τοπολογία και ποιότητα mesh, με διαθέσιμο πλήθος faces ανάλογα με τη βαθμίδα: οι Extreme-Low, Low και Medium επιτρέπουν έως 1M Triangle· οι High και Extreme-High υποστηρίζουν από 20K Triangle έως 2M Triangle. Η Auto εφαρμόζει τις προτεινόμενες ρυθμίσεις: 1. Gen-2.5-Minimum → 50K Triangle; 2. Gen-2.5-Extreme-Low → 50K Triangle; 3. Gen-2.5-Low → 50K Triangle; 4. Gen-2.5-Medium → 500K Triangle; 5. Gen-2.5-High → 500K Triangle; Gen-2.5-Extreme-High → 1M Triangle. Για χειροκίνητη επιλογή, το Quad ευνοεί λείες επιφάνειες και το Triangle λεπτομερή γεωμετρία· το Hyper3D API λαμβάνει την τοπολογία ως `mesh_mode` (Quad/Raw) και το πλήθος faces ως `quality_override`.

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

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

Επιπλέον επιλογές προς εφαρμογή, αν χρειάζεται.

POST /run/hyper3d/rodin/v2.5/text-to-3d?wait=20 προσφορά → 0,40 $
# 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/text-to-3d?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  }'

# 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 - Text to 3D

Παράγει μοντέλο 3D από απαιτούμενο `prompt` έως 1024 χαρακτήρες. Επιλέξτε `tier` από Gen-2.5-Minimum έως Gen-2.5-Extreme-High (προεπιλογή High), μέγεθος πλέγματος σε τετράπλευρα ή τρίγωνα και `material`, όπως PBR ή Shaded. Κάντε εξαγωγή ως glb, usdz, fbx, obj ή stl και ορίστε `seed` μεταξύ 0 και 65535.

Παράμετροι

ΌνομαΤύπος ΠροεπιλογήΕπιτρεπόμενο Περιγραφή
promptαπαιτείται
Τύποςstring
≤ 1.024 χαρακτήρες
Οδηγίες κειμένου που καθοδηγούν την παραγωγή μοντέλου· υποχρεωτικές στη λειτουργία Text-to-3D.
tierπροαιρετικό
Τύποςenum
ΠροεπιλογήGen-2.5-High
Gen-2.5-MinimumGen-2.5-Extreme-LowGen-2.5-LowGen-2.5-MediumGen-2.5-HighGen-2.5-Extreme-High
Βαθμίδα λεπτομέρειας mesh· η αύξηση της βαθμίδας προσθέτει λεπτομέρεια, αλλά το Gen-2.5-Minimum ενεργοποιεί αυτόματα τη λειτουργία minimum και επιβάλλει 50K Triangle ανεξάρτητα από το quality_mesh_option. Περισσότερες λεπτομέρειες στην [τεκμηρίωση](https://developer.hyper3d.ai/api-specification/rodin-gen2.5#use-gen-2.5-generation-with-following-gen-2.5-tiers).
seedπροαιρετικό
Τύποςinteger | null
0 – 65.535
Προαιρετικό τυχαίο seed, με εύρος 0–65535.
geometry_file_formatπροαιρετικό
Τύποςenum
Προεπιλογήglb
glbusdzfbxobjstl
Μορφή αρχείου γεωμετρίας, επιλεγμένη από glb, usdz, fbx, obj, stl· προεπιλογή glb.
materialπροαιρετικό
Τύποςenum
ΠροεπιλογήAll
PBRShadedAllNone
Επιλογή εξόδου υλικού: επιλέξτε None για γεωμετρία χωρίς υφές ή All για λήψη και των δύο παραλλαγών υλικού. Για ρεαλιστικό φωτισμό με φυσικά βασισμένα υλικά, επιλέξτε PBR· για baked φωτισμό χωρίς χάρτες PBR, επιλέξτε Shaded.
quality_mesh_optionπροαιρετικό
Τύποςenum
ΠροεπιλογήAuto
Auto4K Quad8K Quad18K Quad50K Quad100K Quad200K Quad2K Triangle20K Triangle50K Triangle150K Triangle500K Triangle1M Triangle2M Triangle
Τοπολογία και ποιότητα mesh, με διαθέσιμο πλήθος faces ανάλογα με τη βαθμίδα: οι Extreme-Low, Low και Medium επιτρέπουν έως 1M Triangle· οι High και Extreme-High υποστηρίζουν από 20K Triangle έως 2M Triangle. Η Auto εφαρμόζει τις προτεινόμενες ρυθμίσεις: 1. Gen-2.5-Minimum → 50K Triangle; 2. Gen-2.5-Extreme-Low → 50K Triangle; 3. Gen-2.5-Low → 50K Triangle; 4. Gen-2.5-Medium → 500K Triangle; 5. Gen-2.5-High → 500K Triangle; Gen-2.5-Extreme-High → 1M Triangle. Για χειροκίνητη επιλογή, το Quad ευνοεί λείες επιφάνειες και το Triangle λεπτομερή γεωμετρία· το Hyper3D API λαμβάνει την τοπολογία ως `mesh_mode` (Quad/Raw) και το πλήθος faces ως `quality_override`.
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.
addonsπροαιρετικό
Τύποςobject
Επιπλέον επιλογές προς εφαρμογή, αν χρειάζεται.
addons.high_packπροαιρετικό
Τύποςboolean
Προεπιλογήfalse
Βελτίωση HighPack: η έξοδος Quad έχει περίπου 16 φορές περισσότερα faces από όσα ζητά η παράμετρος quality και οι υφές χρησιμοποιούν ανάλυση 4K αντί για την προεπιλογή 2K.
enable_safety_checkerπροαιρετικό
Τύποςboolean
Προεπιλογήtrue
Ο έλεγχος μπορεί να χαλαρώσει με τη ρύθμιση false, εφόσον ο καλών είναι εξουσιοδοτημένος.
απαιτείται

Έξοδος

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "hyper3d/rodin/v2.5/text-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": 400,
    "usd": "0.40",
    "charged": 400,
    "refunded": 0
  },
  "input": {
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  },
  "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/text-to-3d.md. Όλα τα μοντέλα και οι οδηγοί: https://doitong.com/developers/llms.txt