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

Meshy 6 · Text to 3D

Ενσωμάτωση

id μοντέλου meshy/v6/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.ru/v1/run/meshy/v6/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.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

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

Λήψη κλειδιού API
Meshy Κείμενο σε 3D #text-to-3d

Γεννήτρια πλέγματος κειμένου-σε-3D με λειτουργίες προεπισκόπησης ή υφής και προαιρετικά PBR, rigging και animation

Meshy · 3D

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

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

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

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

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

Περιγραφή του αντικειμένου που θα αναπαρασταθεί ως μοντέλο 3D, περιορισμένη σε 600 χαρακτήρες.

Για προχωρημένους texture_prompt · texture_image_url · mode · model_type · topology · symmetry_mode · pose_mode · target_polycount · rigging_height_meters · animation_action_id · seed · should_remesh · enable_pbr · is_a_t_pose · enable_prompt_expansion · enable_rigging · enable_animation · enable_safety_checker
0 / 600

Καθοδηγεί το texturing με πρόσθετο text prompt στη λειτουργία 'full'· οι άλλες λειτουργίες δεν το χρησιμοποιούν.

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

Εικόνα αναφοράς 2D για παραγωγή υφών, που εφαρμόζεται μόνο στη λειτουργία 'full'.

mode προεπιλογή full

Λειτουργία παραγωγής: το 'preview' εξάγει γεωμετρία χωρίς υφές, ενώ το 'full' εξάγει μοντέλο με υφές συνδυάζοντας preview και refine.

model_type προεπιλογή standard

Λειτουργία mesh 3D: επιλέξτε 'lowpoly' για αποτέλεσμα χαμηλού αριθμού πολυγώνων, βελτιστοποιημένο για καθαρότερα πολύγωνα· σε αυτή τη λειτουργία το Meshy αγνοεί τα topology, target_polycount και should_remesh. Για συμβατικό αποτέλεσμα υψηλής λεπτομέρειας επιλέξτε 'standard' ή 'smart-topology' για χρήση του Meshy-T2 στο βήμα γεωμετρίας (preview) και καθαρά μέρη που παράγονται χωριστά εξαρχής.

topology προεπιλογή triangle

Επιλογή τοπολογίας μοντέλου μεταξύ Triangle για γεωμετρική λεπτομέρεια και Quad για ομαλότητα επιφάνειας.

symmetry_mode προεπιλογή auto

Ρύθμιση συμμετρίας που εφαρμόζεται κατά την παραγωγή του μοντέλου.

pose_mode προεπιλογή

Αφήστε το string κενό για να μην καθορίσετε τη στάση του παραγόμενου μοντέλου ή ζητήστε A-pose με 'a-pose' ή T-pose με 't-pose'.

προεπιλογή 30000

Στόχος αριθμού πολυγώνων, με ανώτατο όριο 15,000 όταν το model_type είναι 'smart-topology'. Αν παραλειφθεί ο στόχος σε αυτή τη λειτουργία, επιλέγεται η χαμηλότερη προεπιλογή του Meshy, 4,000.

προεπιλογή 1.7

Παρέχετε εκτιμώμενο ύψος χαρακτήρα σε μέτρα όταν το enable_rigging είναι true· διαφορετικά, αυτή η τιμή δεν έχει επίδραση.

προεπιλογή 92

ID προεπιλεγμένης animation της βιβλιοθήκης Meshy, με τις διαθέσιμες ενέργειες στη διεύθυνση https://docs.meshy.ai/en/api/animation-library. Η επικύρωση και η χρήση εφαρμόζονται μόνο όταν το enable_animation είναι true: τιμές εκτός του [0, 696] απορρίπτονται με 422 και το "Idle" αντιστοιχεί σε `0`.

Χρησιμοποιήστε ξανά αυτό το seed μαζί με αμετάβλητο prompt για να αναπαραγάγετε συνήθως προηγούμενο αποτέλεσμα.

POST /run/meshy/v6/text-to-3d?wait=20 προσφορά → 0,80 $
# 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/meshy/v6/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.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

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

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

Σχετικά με το Meshy 6 · Text to 3D

Δημιουργεί ένα μοντέλο 3D από κείμενο `prompt` έως 600 χαρακτήρων. Το `mode` επιλέγει γεωμετρία χωρίς υφή (`preview`) ή αποτέλεσμα με υφή (`full`). Το `model_type` μπορεί να είναι standard, lowpoly ή smart-topology και το `target_polycount` κυμαίνεται από 100 έως 300000, με ανώτατο όριο 15000 για smart topology. Μπορεί επίσης να προσθέσει χάρτες PBR, στάση, rigging ανθρωπόμορφου μοντέλου και προκαθορισμένη ρύθμιση animation.

Παράμετροι

ΌνομαΤύπος ΠροεπιλογήΕπιτρεπόμενο Περιγραφή
promptαπαιτείται
Τύποςstring
≤ 600 χαρακτήρες
Περιγραφή του αντικειμένου που θα αναπαρασταθεί ως μοντέλο 3D, περιορισμένη σε 600 χαρακτήρες.
modeπροαιρετικό
Τύποςenum
Προεπιλογήfull
previewfull
Λειτουργία παραγωγής: το 'preview' εξάγει γεωμετρία χωρίς υφές, ενώ το 'full' εξάγει μοντέλο με υφές συνδυάζοντας preview και refine.
seedπροαιρετικό
Τύποςinteger | null
Χρησιμοποιήστε ξανά αυτό το seed μαζί με αμετάβλητο prompt για να αναπαραγάγετε συνήθως προηγούμενο αποτέλεσμα.
model_typeπροαιρετικό
Τύποςenum
Προεπιλογήstandard
standardlowpolysmart-topology
Λειτουργία mesh 3D: επιλέξτε 'lowpoly' για αποτέλεσμα χαμηλού αριθμού πολυγώνων, βελτιστοποιημένο για καθαρότερα πολύγωνα· σε αυτή τη λειτουργία το Meshy αγνοεί τα topology, target_polycount και should_remesh. Για συμβατικό αποτέλεσμα υψηλής λεπτομέρειας επιλέξτε 'standard' ή 'smart-topology' για χρήση του Meshy-T2 στο βήμα γεωμετρίας (preview) και καθαρά μέρη που παράγονται χωριστά εξαρχής.
topologyπροαιρετικό
Τύποςenum
Προεπιλογήtriangle
quadtriangle
Επιλογή τοπολογίας μοντέλου μεταξύ Triangle για γεωμετρική λεπτομέρεια και Quad για ομαλότητα επιφάνειας.
target_polycountπροαιρετικό
Τύποςinteger
Προεπιλογή30000
100 – 300.000
Στόχος αριθμού πολυγώνων, με ανώτατο όριο 15,000 όταν το model_type είναι 'smart-topology'. Αν παραλειφθεί ο στόχος σε αυτή τη λειτουργία, επιλέγεται η χαμηλότερη προεπιλογή του Meshy, 4,000.
should_remeshπροαιρετικό
Τύποςboolean
Προεπιλογήtrue
Παραλείψτε το remeshing και λάβετε το ακατέργαστο τριγωνικό mesh ορίζοντας false· διαφορετικά, ενεργοποιείται η φάση remesh.
symmetry_modeπροαιρετικό
Τύποςenum
Προεπιλογήauto
offautoon
Ρύθμιση συμμετρίας που εφαρμόζεται κατά την παραγωγή του μοντέλου.
enable_pbrπροαιρετικό
Τύποςboolean
Προεπιλογήfalse
Ελέγχει την παραγωγή χαρτών PBR μεταλλικότητας, τραχύτητας και κανονικών διανυσμάτων μαζί με το βασικό χρώμα.
is_a_t_poseπροαιρετικό
Τύποςboolean
Προεπιλογήfalse
Διακόπτης παραγωγής T-pose που ενεργοποιείται με true· έχει καταργηθεί υπέρ του pose_mode.
pose_modeπροαιρετικό
Τύποςenum
Προεπιλογή
a-poset-pose
Αφήστε το string κενό για να μην καθορίσετε τη στάση του παραγόμενου μοντέλου ή ζητήστε A-pose με 'a-pose' ή T-pose με 't-pose'.
enable_prompt_expansionπροαιρετικό
Τύποςboolean
Προεπιλογήfalse
Επιτρέπει σε ένα μεγάλο γλωσσικό μοντέλο να εμπλουτίσει το prompt με λεπτομέρειες. Η ενεργοποίηση αυτής της επέκτασης δεν αλλάζει το νόημα του prompt.
texture_promptπροαιρετικό
Τύποςstring | null
≤ 600 χαρακτήρες
Καθοδηγεί το texturing με πρόσθετο text prompt στη λειτουργία 'full'· οι άλλες λειτουργίες δεν το χρησιμοποιούν.
texture_image_urlπροαιρετικό
Τύποςurl · image
Εικόνα αναφοράς 2D για παραγωγή υφών, που εφαρμόζεται μόνο στη λειτουργία 'full'.
enable_riggingπροαιρετικό
Τύποςboolean
Προεπιλογήfalse
Αυτόματο humanoid rigging, πιο αποτελεσματικό για ανθρωπόμορφα μοντέλα με σαφώς διακριτά άκρα. Η ενεργοποίησή του εφαρμόζει rigging στο παραγόμενο μοντέλο και παρέχει βασικές animation βάδισης και τρεξίματος.
rigging_height_metersπροαιρετικό
Τύποςnumber
Προεπιλογή1.7
> 0
Παρέχετε εκτιμώμενο ύψος χαρακτήρα σε μέτρα όταν το enable_rigging είναι true· διαφορετικά, αυτή η τιμή δεν έχει επίδραση.
enable_animationπροαιρετικό
Τύποςboolean
Προεπιλογήfalse
Αν το μοντέλο με rigging λαμβάνει προεπιλεγμένη animation, η οποία απαιτεί το enable_rigging να είναι true.
animation_action_idπροαιρετικό
Τύποςinteger
Προεπιλογή92
ID προεπιλεγμένης animation της βιβλιοθήκης Meshy, με τις διαθέσιμες ενέργειες στη διεύθυνση https://docs.meshy.ai/en/api/animation-library. Η επικύρωση και η χρήση εφαρμόζονται μόνο όταν το enable_animation είναι true: τιμές εκτός του [0, 696] απορρίπτονται με 422 και το "Idle" αντιστοιχεί σε `0`.
enable_safety_checkerπροαιρετικό
Τύποςboolean
Προεπιλογήtrue
Διακόπτης ελέγχου ασφάλειας πριν από την επεξεργασία: το true καθιστά τον έλεγχο ασφάλειας της εισόδου προϋπόθεση για την επεξεργασία.
απαιτείται

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

Έξοδος

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "meshy/v6/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": 800,
    "usd": "0.80",
    "charged": 800,
    "refunded": 0
  },
  "input": {
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  },
  "output": {
    "animation_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
    },
    "animation_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
    },
    "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
      },
      "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
      },
      "blend": {
        "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
      },
      "stl": {
        "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_urls": [
      {
        "base_color": {
          "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
        },
        "metallic": {
          "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
        },
        "normal": {
          "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
        },
        "roughness": {
          "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,
    "prompt": "A rustic, antique wooden treasure chest with a curved, domed lid, constructed from weathered, dark brown planks exhibiting prominent wood grain and subtle distress. It's heavily reinforced with broad, dark grey, oxidized metal bands secured by numerous circular rivets. Ornate, dark iron decorative elements featuring swirling foliate patterns and dragon motifs adorn the corners and lid. A prominent, circular, intricately carved metal lock plate with a central keyhole dominates the front, flanked by two large, dark metallic pull rings.",
    "actual_prompt": "string",
    "rigged_character_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
    },
    "rigged_character_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
    },
    "basic_animations": {
      "walking_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
      },
      "walking_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
      },
      "walking_armature_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
      },
      "running_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
      },
      "running_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
      },
      "running_armature_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
      }
    },
    "rig_task_id": "string"
  },
  "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 είναι το αντικείμενο αποτελέσματος του ίδιου του μοντέλου.
Πεδία εξόδου
animation_glb
object {url, content_type, file_name, file_size} | nullΑποτέλεσμα animation που περιέχει το μοντέλο 3D ως GLB· η απόκριση το παραλείπει εκτός αν το enable_animation είναι true.
animation_fbx
object {url, content_type, file_name, file_size} | nullΑποτέλεσμα animation που περιέχει το μοντέλο 3D ως FBX· η απόκριση το παραλείπει εκτός αν το enable_animation είναι true.
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, usdz, blend, stl}Σύνδεσμοι προς το μοντέλο 3D σε διάφορες μορφές.
texture_urls
array of object {base_color, metallic, normal, roughness}Αρχεία υφής ως πίνακας αντικειμένων.
seed
integer | nullΤιμή seed που χρησιμοποιείται κατά την παραγωγή.
prompt
stringText prompt που παρέχεται για την παραγωγή.
actual_prompt
string | nullPrompt που εφαρμόστηκε πραγματικά στην παραγωγή όταν ήταν ενεργή η επέκταση prompt.
rigged_character_glb
object {url, content_type, file_name, file_size} | nullΑποτέλεσμα rigging που παραδίδεται ως αρχείο χαρακτήρα GLB· απουσιάζει από την απόκριση εκτός αν το enable_rigging είναι true.
rigged_character_fbx
object {url, content_type, file_name, file_size} | nullΑποτέλεσμα rigging που παραδίδεται ως αρχείο χαρακτήρα FBX· απουσιάζει από την απόκριση εκτός αν το enable_rigging είναι true.
basic_animations
object {walking_glb, walking_fbx, walking_armature_glb, running_glb, running_fbx, running_armature_glb} | nullΒασικές animation βάδισης και τρεξίματος, που περιλαμβάνονται μόνο αν το enable_rigging είναι true.
rig_task_id
string | nullΑναγνωριστικό της εργασίας rigging· περιλαμβάνεται μόνο αν το enable_rigging είναι true.

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

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