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

Meshy V7 Image to 3D

Ενσωμάτωση

id μοντέλου meshy/v7/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/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.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 με επιλογή γεωμετρίας 2k, προαιρετικό PBR, rigging και animation

Meshy · 3D

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

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

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

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

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

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

geometry_resolution

Ανάλυση γεωμετρίας mesh· οι υποστηριζόμενες επιλογές Meshy-7 είναι standard και 2k.

Για προχωρημένους 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 · ultra_mode
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/v7/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/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.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

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

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

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

Δημιουργεί ένα μοντέλο 3D από μία εικόνα στο `image_url` (JPG, PNG, AVIF ή HEIF). Το `model_type` επιλέγει standard, lowpoly ή smart-topology και το `target_polycount` δέχεται 100 έως 300000. Το `geometry_resolution` προσφέρει standard ή 2k. Η δημιουργία υφών μπορεί να απενεργοποιηθεί με `should_texture` και οι χάρτες PBR, η λειτουργία στάσης, το rigging ανθρωπόμορφου μοντέλου και μια προκαθορισμένη ρύθμιση animation είναι προαιρετικά.

Παράμετροι

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

ΌνομαΤύπος ΠροεπιλογήΕπιτρεπόμενο Περιγραφή
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 καθιστά τον έλεγχο ασφάλειας της εισόδου προϋπόθεση για την επεξεργασία.
geometry_resolutionπροαιρετικό
Τύποςenum
standard2k
Ανάλυση γεωμετρίας mesh· οι υποστηριζόμενες επιλογές Meshy-7 είναι standard και 2k.
ultra_modeπροαιρετικό
Τύποςboolean
Προεπιλογήfalse
Καταργημένη επιλογή που αντικαταστάθηκε από το geometry_resolution, το οποίο υπερισχύει αν παρέχονται και τα δύο· χρησιμοποιήστε geometry_resolution='2k'.
απαιτείται Κανονικό όνομα, επίσης αποδεκτό

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

Έξοδος

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "meshy/v7/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.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}Αντικείμενα αρχείων υφής σε πίνακα δομημένο σύμφωνα με το 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/v7/image-to-3d.md. Όλα τα μοντέλα και οι οδηγοί: https://doitong.com/developers/llms.txt