Passer au contenu

Meshy 7.1 Multi Image to 3D

Intégrer

Identifiant du modèle meshy/v7.1/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.1/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"

Fichiers comme dans l’exemple: 1,20 $ 1 200 crédits API · ≈ 128,78 ₽ vos fichiers sont mesurés avant l’exécution L’exécuter sur cette page

Obtenir une clé API
Meshy Image vers 3D #3d#multi-image#textures#pbr

Construit un modèle 3D texturé à partir de 1 à 4 vues d’un même objet, avec options de remaillage, de squelette et d’animation

Meshy · 3D

Votre premier résultat apparaîtra ici

Créez une requête ci-dessous et exécutez-la avec votre clé API. Les sorties sont copiées dans notre stockage, conservées indéfiniment ou pendant 7 jours gratuitement.

Créer une requête

Les contrôles sont générés à partir du schéma du modèle. Le code et le prix se mettent à jour au fur et à mesure de vos modifications.

•requis image_urls
Déposez un fichier ou

Ensemble d’images pour la création 3D, acceptant .jpg, .jpeg, .png ainsi que AVIF/HEIF avec conversion automatique. Fournissez de 1 à 4 vues montrant un seul objet sous différents angles; les entrées au-delà des 4 premières sont inutilisées.

Avancé texture_prompt · texture_image_url · topology · symmetry_mode · pose_mode · geometry_resolution · target_polycount · rigging_height_meters · animation_action_id · should_remesh · enable_pbr · is_a_t_pose · enable_safety_checker
0 / 600

Consignes de texturation fournies comme invite textuelle, nécessitant que should_texture soit true.

Déposez un fichier ou

Consignes de texturation fournies comme image 2D, nécessitant que should_texture soit true.

topology par défaut triangle

Choix de topologie du modèle entre Triangle pour les détails géométriques et Quad pour la douceur de la surface.

symmetry_mode par défaut auto

Paramètre de symétrie appliqué lors de la génération du modèle.

pose_mode par défaut

Laissez la chaîne vide pour ne pas préciser la pose du modèle généré, ou demandez une pose en A avec 'a-pose' ou une pose en T avec 't-pose'.

geometry_resolution

Résolution de la géométrie; 4k n’est pas disponible pour une génération à partir de plusieurs images.

par défaut 30000

Nombre de polygones souhaité pour le modèle de sortie.

par défaut 1.7

Fournissez une taille estimée du personnage en mètres lorsque enable_rigging est true; sinon, cette valeur n’a aucun effet.

par défaut 92

ID de préréglage d’animation de la bibliothèque Meshy, dont les actions disponibles sont répertoriées à https://docs.meshy.ai/en/api/animation-library. La validation et l’utilisation s’appliquent uniquement lorsque enable_animation est true : les valeurs hors de [0, 696] sont rejetées avec une erreur 422, et "Idle" correspond à `0`.

POST /run/meshy/v7.1/multi-image-to-3d?wait=20 devis → 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.1/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"

Exécuter cette requête

Votre clé reste dans ce navigateur : elle est envoyée uniquement au Doitong API et enregistrée dans localStorage uniquement si vous cochez Mémoriser. Obtenir une clé API

À propos de Meshy 7.1 Multi Image to 3D

Génère un modèle 3D à partir de `image_urls`, qui doit contenir de 1 à 4 photos du même objet prises sous différents angles. Vous pouvez contrôler `topology` (quad ou triangle), `target_polycount` (100 à 300000), `symmetry_mode` et `pose_mode`, et guider la texturation avec `texture_prompt` ou `texture_image_url`. Des cartes PBR facultatives sont disponibles; les modèles humanoïdes peuvent recevoir un squelette et un préréglage d’animation. `geometry_resolution` accepte standard ou 2k.

Paramètres

Envoyez soit le nom canonique, soit le nom natif, mais pas les deux. Noms canoniques

NomType Par défautAutorisé Description
image_urlsrequis images
Typeurl[] · image
Ensemble d’images pour la création 3D, acceptant .jpg, .jpeg, .png ainsi que AVIF/HEIF avec conversion automatique. Fournissez de 1 à 4 vues montrant un seul objet sous différents angles; les entrées au-delà des 4 premières sont inutilisées.
topologyfacultatif
Typeenum
Par défauttriangle
quadtriangle
Choix de topologie du modèle entre Triangle pour les détails géométriques et Quad pour la douceur de la surface.
target_polycountfacultatif
Typeinteger
Par défaut30000
100 – 300 000
Nombre de polygones souhaité pour le modèle de sortie.
symmetry_modefacultatif
Typeenum
Par défautauto
offautoon
Paramètre de symétrie appliqué lors de la génération du modèle.
should_remeshfacultatif
Typeboolean
Par défauttrue
Indique s’il faut exécuter la phase de remaillage. Définir cette valeur sur false produit un maillage triangulaire; topology et target_polycount sont alors ignorés.
should_texturefacultatif
Typeboolean
Par défauttrue
Active ou désactive la génération de textures.
enable_pbrfacultatif
Typeboolean
Par défautfalse
Commutateur de sortie PBR supplémentaire, disponible uniquement lorsque should_texture est true; ajoute les cartes métallique, rugosité et normale en plus de la couleur de base.
is_a_t_posefacultatif
Typeboolean
Par défautfalse
Commutateur de génération en pose en T activé par true; obsolète au profit de pose_mode.
pose_modefacultatif
Typeenum
Par défaut
a-poset-pose
Laissez la chaîne vide pour ne pas préciser la pose du modèle généré, ou demandez une pose en A avec 'a-pose' ou une pose en T avec 't-pose'.
texture_promptfacultatif
Typestring | null
≤ 600 caractères
Consignes de texturation fournies comme invite textuelle, nécessitant que should_texture soit true.
texture_image_urlfacultatif
Typeurl · image
Consignes de texturation fournies comme image 2D, nécessitant que should_texture soit true.
enable_riggingfacultatif
Typeboolean
Par défautfalse
Rigging humanoïde automatique, particulièrement efficace pour les modèles humanoïdes dont les membres sont clairement distinguables. L’activer applique un rigging au modèle généré et fournit des animations de base de marche et de course.
rigging_height_metersfacultatif
Typenumber
Par défaut1.7
> 0
Fournissez une taille estimée du personnage en mètres lorsque enable_rigging est true; sinon, cette valeur n’a aucun effet.
enable_animationfacultatif
Typeboolean
Par défautfalse
Indique si le modèle avec rigging reçoit une animation préréglée, ce qui nécessite que enable_rigging soit true.
animation_action_idfacultatif
Typeinteger
Par défaut92
ID de préréglage d’animation de la bibliothèque Meshy, dont les actions disponibles sont répertoriées à https://docs.meshy.ai/en/api/animation-library. La validation et l’utilisation s’appliquent uniquement lorsque enable_animation est true : les valeurs hors de [0, 696] sont rejetées avec une erreur 422, et "Idle" correspond à `0`.
enable_safety_checkerfacultatif
Typeboolean
Par défauttrue
Commutateur de vérification de sécurité avant traitement : true fait d’une vérification de sécurité de l’entrée une condition préalable au traitement.
geometry_resolutionfacultatif
Typeenum
standard2k
Résolution de la géométrie; 4k n’est pas disponible pour une génération à partir de plusieurs images.
requis Nom canonique, également accepté

Les paramètres de fichier acceptent une URL publique https://, un URI data: jusqu’à 10 MB ou le file_url d’un téléversement. Fichiers

Sortie

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "meshy/v7.1/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"
  }
}
Vos fichiers, votre choixChaque outputs[].url est une copie dans notre stockage : conservée indéfiniment (facturation par Go-mois) ou pendant 7 jours gratuitement, selon le réglage de votre compte ou ?storage=.
Même structure pour chaque modèletype, url, content_type, width, height et duration, pour les images, les vidéos et les fichiers audio. output est l’objet de résultat propre au modèle.
Champs de sortie
animation_glb
object {url, content_type, file_name, file_size} | nullRésultat d’animation contenant le modèle 3D au format GLB; la réponse omet ce résultat sauf si enable_animation est true.
animation_fbx
object {url, content_type, file_name, file_size} | nullRésultat d’animation contenant le modèle 3D au format FBX; la réponse omet ce résultat sauf si enable_animation est true.
model_glb
object {url, content_type, file_name, file_size}Fichier GLB contenant l’objet 3D généré.
thumbnail
object {url, content_type, file_name, file_size} | nullVignette affichant un aperçu du modèle généré.
model_urls
object {glb, fbx, obj, usdz, blend, stl}Liens vers le modèle 3D dans divers formats.
texture_urls
array of object {base_color, metallic, normal, roughness}Fichiers de texture représentés comme un tableau d’objets.
seed
integer | nullGraine de génération, lorsqu’elle est disponible.
rigged_character_glb
object {url, content_type, file_name, file_size} | nullRésultat du rigging fourni comme fichier de personnage GLB; absent de la réponse sauf si enable_rigging est true.
rigged_character_fbx
object {url, content_type, file_name, file_size} | nullRésultat du rigging fourni comme fichier de personnage FBX; absent de la réponse sauf si enable_rigging est true.
basic_animations
object {walking_glb, walking_fbx, walking_armature_glb, running_glb, running_fbx, running_armature_glb} | nullAnimations de marche et de course de base, incluses uniquement si enable_rigging est true.
rig_task_id
string | nullIdentifiant de la tâche de rigging; inclus uniquement si enable_rigging est true.

Plus de modèles : Image vers 3D

Pour les agents IA : cette page en Markdown se trouve à https://doitong.com/fr-CA/developers/models/meshy/v7.1/multi-image-to-3d.md. Tous les modèles et guides : https://doitong.com/developers/llms.txt