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

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

Ενσωμάτωση

id μοντέλου hyper3d/rodin/v2.5/text-to-3d/fast
# 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/hyper3d/rodin/v2.5/text-to-3d/fast?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.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

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

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

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

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
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/text-to-3d/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.ru/v1/run/hyper3d/rodin/v2.5/text-to-3d/fast?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.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

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

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

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

Μετατρέπει ένα απαιτούμενο `prompt` (έως 1024 χαρακτήρες) σε μοντέλο 3D χρησιμοποιώντας τα ελαφρύτερα επίπεδα Minimum, Extreme-Low (προεπιλογή) και Low. Οι επιλογές πλέγματος φτάνουν έως 20K όψεις και το υλικό έχει προεπιλογή Shaded. Υποστηρίζει έξοδο glb, usdz, fbx, obj και stl, έναν `seed` από 0 έως 65535 και το `TAPose` για χαρακτήρες.

Παράμετροι

ΌνομαΤύπος ΠροεπιλογήΕπιτρεπόμενο Περιγραφή
promptαπαιτείται
Τύποςstring
≤ 1.024 χαρακτήρες
Οδηγίες κειμένου που καθοδηγούν την παραγωγή μοντέλου· υποχρεωτικές στη λειτουργία Text-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).
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.
enable_safety_checkerπροαιρετικό
Τύποςboolean
Προεπιλογήtrue
Ο έλεγχος μπορεί να χαλαρώσει με τη ρύθμιση false, εφόσον ο καλών είναι εξουσιοδοτημένος.
απαιτείται

Έξοδος

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "hyper3d/rodin/v2.5/text-to-3d/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": "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.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_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/fast.md. Όλα τα μοντέλα και οι οδηγοί: https://doitong.com/developers/llms.txt