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

Meshy V7 Multi Image to 3D

Ενσωμάτωση

id μοντέλου meshy/v7/multi-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.ru/v1/run/meshy/v7/multi-image-to-3d?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "images": [
      "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.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

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

Λήψη κλειδιού API
Meshy Εικόνα σε 3D #stylized#transform

Δημιουργεί ένα μοντέλο 3D από 1 έως 4 όψεις του ίδιου αντικειμένου, με ελέγχους πολυγώνων και τοπολογίας

Meshy · 3D

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

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

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

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

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

Σύνολο εικόνων για δημιουργία 3D, με αποδοχή .jpg, .jpeg, .png και AVIF/HEIF με αυτόματη μετατροπή. Παρέχετε 1 έως 4 όψεις που δείχνουν ένα αντικείμενο από διαφορετικές γωνίες· οι καταχωρίσεις μετά τις πρώτες 4 δεν χρησιμοποιούνται.

geometry_resolution

Ανάλυση της γεωμετρίας· το 4k δεν είναι διαθέσιμο για παραγωγή από πολλές εικόνες.

Για προχωρημένους texture_prompt · texture_image_url · 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

Καθοδήγηση texturing ως text prompt, που απαιτεί το should_texture να είναι true.

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

Καθοδήγηση texturing ως εικόνα 2D, που απαιτεί το should_texture να είναι true.

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

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

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

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

pose_mode προεπιλογή

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

προεπιλογή 30000

Επιθυμητός αριθμός πολυγώνων για το μοντέλο εξόδου.

προεπιλογή 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/v7/multi-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.ru/v1/run/meshy/v7/multi-image-to-3d?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "images": [
      "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.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

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

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

Σχετικά με το Meshy V7 Multi Image to 3D

Ανακατασκευάζει ένα αντικείμενο από το `image_urls`, το οποίο δέχεται μία έως τέσσερις φωτογραφίες του από διαφορετικές γωνίες. Ορίστε `topology` σε quad ή triangle και `target_polycount` από 100 έως 300000 και επιλέξτε standard ή 2k `geometry_resolution`. Η δημιουργία υφών είναι προαιρετική μέσω `should_texture`, ενώ διατίθενται χάρτες PBR, λειτουργία στάσης, rigging και animation. Η έξοδος περιλαμβάνει GLB και άλλες μορφές.

Παράμετροι

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

ΌνομαΤύπος ΠροεπιλογήΕπιτρεπόμενο Περιγραφή
image_urlsαπαιτείται images
Τύποςurl[] · image
Σύνολο εικόνων για δημιουργία 3D, με αποδοχή .jpg, .jpeg, .png και AVIF/HEIF με αυτόματη μετατροπή. Παρέχετε 1 έως 4 όψεις που δείχνουν ένα αντικείμενο από διαφορετικές γωνίες· οι καταχωρίσεις μετά τις πρώτες 4 δεν χρησιμοποιούνται.
topologyπροαιρετικό
Τύποςenum
Προεπιλογήtriangle
quadtriangle
Επιλογή τοπολογίας μοντέλου μεταξύ Triangle για γεωμετρική λεπτομέρεια και Quad για ομαλότητα επιφάνειας.
target_polycountπροαιρετικό
Τύποςinteger
Προεπιλογή30000
100 – 300.000
Επιθυμητός αριθμός πολυγώνων για το μοντέλο εξόδου.
symmetry_modeπροαιρετικό
Τύποςenum
Προεπιλογήauto
offautoon
Ρύθμιση συμμετρίας που εφαρμόζεται κατά την παραγωγή του μοντέλου.
should_remeshπροαιρετικό
Τύποςboolean
Προεπιλογήtrue
Αν θα εκτελεστεί η φάση remesh. Η ρύθμιση false παράγει τριγωνικό mesh· τα topology και target_polycount αγνοούνται.
should_textureπροαιρετικό
Τύποςboolean
Προεπιλογήtrue
Ενεργοποιεί ή απενεργοποιεί την παραγωγή υφών.
enable_pbrπροαιρετικό
Τύποςboolean
Προεπιλογήfalse
Πρόσθετος διακόπτης εξόδου PBR, διαθέσιμος μόνο όταν το should_texture είναι true· προσθέτει χάρτες μεταλλικότητας, τραχύτητας και κανονικών διανυσμάτων μαζί με το βασικό χρώμα.
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 χαρακτήρες
Καθοδήγηση texturing ως text prompt, που απαιτεί το should_texture να είναι true.
texture_image_urlπροαιρετικό
Τύποςurl · image
Καθοδήγηση texturing ως εικόνα 2D, που απαιτεί το should_texture να είναι true.
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 καθιστά τον έλεγχο ασφάλειας της εισόδου προϋπόθεση για την επεξεργασία.
geometry_resolutionπροαιρετικό
Τύποςenum
standard2k
Ανάλυση της γεωμετρίας· το 4k δεν είναι διαθέσιμο για παραγωγή από πολλές εικόνες.
απαιτείται Κανονικό όνομα, επίσης αποδεκτό

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

Έξοδος

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "meshy/v7/multi-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_urls": [
      "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.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 | 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/v7/multi-image-to-3d.md. Όλα τα μοντέλα και οι οδηγοί: https://doitong.com/developers/llms.txt