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

Meshy 6 · Image to 3D

Ενσωμάτωση

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

Αρχεία όπως το παράδειγμα: 1,20 $ 1.200 πιστώσεις API τα αρχεία σας μετρώνται πριν από την εκτέλεση Εκτέλεση σε αυτήν τη σελίδα

Λήψη κλειδιού API
Meshy Εικόνα σε 3D #image-to-3d

Meshy 6 εικόνας-σε-3D με επαναδημιουργία πλέγματος, χάρτες PBR, προαιρετικό rigging ανθρωποειδούς και animation

Meshy · 3D

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

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

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

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

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

Παρέχετε την εικόνα πηγής για δημιουργία 3D μέσω URL ή URI δεδομένων base64, χρησιμοποιώντας .jpg, .jpeg, .png, AVIF ή HEIF. Η αυτόματη μετατροπή χειρίζεται τις εισόδους AVIF και HEIF.

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

Οδηγίες κειμένου που κατευθύνουν την παραγωγή υφών.

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

Εικόνα αναφοράς 2D που κατευθύνει την παραγωγή υφών.

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

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

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

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

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

Επιλέξτε αν η παραγωγή του μοντέλου επιβάλλει συμμετρία με On, την παραλείπει με Off ή αποφασίζει αυτόματα με 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`.

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

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

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

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

Δημιουργεί ένα μοντέλο 3D από μία εικόνα (`image_url`). Το `model_type` είναι standard, lowpoly ή smart-topology, η τοπολογία είναι triangle ή quad και το `target_polycount` κυμαίνεται από 100 έως 300000 (μέγιστο 15,000 για smart topology). Οι επιλογές περιλαμβάνουν δημιουργία υφών, χάρτες PBR, συμμετρία, στάση A ή T και rigging ανθρωπόμορφου μοντέλου με προκαθορισμένη ρύθμιση animation. Η έξοδος περιλαμβάνει αρχεία GLB και FBX.

Παράμετροι

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

ΌνομαΤύπος ΠροεπιλογήΕπιτρεπόμενο Περιγραφή
image_urlαπαιτείται image
Τύποςurl · image
Παρέχετε την εικόνα πηγής για δημιουργία 3D μέσω URL ή URI δεδομένων base64, χρησιμοποιώντας .jpg, .jpeg, .png, AVIF ή HEIF. Η αυτόματη μετατροπή χειρίζεται τις εισόδους AVIF και HEIF.
model_typeπροαιρετικό
Τύποςenum
Προεπιλογήstandard
standardlowpolysmart-topology
Λειτουργία mesh 3D: επιλέξτε 'lowpoly' για αποτέλεσμα χαμηλού αριθμού πολυγώνων, βελτιστοποιημένο για καθαρότερα πολύγωνα· σε αυτή τη λειτουργία το Meshy αγνοεί τα topology, target_polycount και should_remesh. Για συμβατικό αποτέλεσμα υψηλής λεπτομέρειας επιλέξτε 'standard' ή 'smart-topology' για χρήση του Meshy-T2 και καθαρά μέρη που παράγονται χωριστά εξαρχής.
topologyπροαιρετικό
Τύποςenum
Προεπιλογήtriangle
quadtriangle
Επιλογή τοπολογίας μοντέλου μεταξύ Triangle για γεωμετρική λεπτομέρεια και Quad για ομαλότητα επιφάνειας.
target_polycountπροαιρετικό
Τύποςinteger
Προεπιλογή30000
100 – 300.000
Στόχος αριθμού πολυγώνων, με ανώτατο όριο 15,000 όταν το model_type είναι 'smart-topology'. Αν παραλειφθεί ο στόχος σε αυτή τη λειτουργία, επιλέγεται η χαμηλότερη προεπιλογή του Meshy, 4,000.
symmetry_modeπροαιρετικό
Τύποςenum
Προεπιλογήauto
offautoon
Επιλέξτε αν η παραγωγή του μοντέλου επιβάλλει συμμετρία με On, την παραλείπει με Off ή αποφασίζει αυτόματα με Auto.
should_remeshπροαιρετικό
Τύποςboolean
Προεπιλογήtrue
Ενεργοποιεί ή απενεργοποιεί το στάδιο remeshing.
should_textureπροαιρετικό
Τύποςboolean
Προεπιλογήtrue
Ενεργοποιεί ή απενεργοποιεί την παραγωγή υφών.
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'.
texture_promptπροαιρετικό
Τύποςstring | null
≤ 600 χαρακτήρες
Οδηγίες κειμένου που κατευθύνουν την παραγωγή υφών.
texture_image_urlπροαιρετικό
Τύποςurl · image
Εικόνα αναφοράς 2D που κατευθύνει την παραγωγή υφών.
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/image-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": 1200,
    "usd": "1.20",
    "charged": 1200,
    "refunded": 0
  },
  "input": {
    "image_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  },
  "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,
    "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.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 είναι το αντικείμενο αποτελέσματος του ίδιου του μοντέλου.
Πεδία εξόδου
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}Αντικείμενα αρχείων υφής σε πίνακα δομημένο σύμφωνα με το Meshy API.
seed
integer | nullSeed παραγωγής, όταν είναι διαθέσιμο.
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/image-to-3d.md. Όλα τα μοντέλα και οι οδηγοί: https://doitong.com/developers/llms.txt