Accéder au contenu

Meshy 6 Preview · Image to 3D

Intégrer

Identifiant du modèle meshy/v6-preview/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/v6-preview/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"

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

Obtenir une clé API
Meshy Image vers 3D #image-to-3d

Conversion image-3D Meshy 6 Preview avec options de topologie, nombre de polygones, PBR, rig et animation

Meshy · 3D

Votre premier résultat apparaîtra ici

Construisez 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 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 lorsque vous les modifiez.

•obligatoire image_url
Déposez un fichier ou

Fournissez l'image source pour la création 3D par URL ou URI de données base64, en utilisant .jpg, .jpeg, .png, AVIF ou HEIF. La conversion automatique prend en charge les entrées AVIF et HEIF.

Avancé 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

Instructions textuelles dirigeant la génération de textures.

Déposez un fichier ou

Image de référence 2D dirigeant la génération de textures.

model_type par défaut standard

Mode de maillage 3D : choisissez 'lowpoly' pour un résultat low-poly optimisé pour des polygones plus nets ; dans ce mode, Meshy ignore topology, target_polycount et should_remesh. Pour un résultat conventionnel très détaillé, choisissez 'standard', ou choisissez 'smart-topology' pour utiliser Meshy-T2 et obtenir des parties nettes générées séparément dès le départ.

topology par défaut triangle

Choix de topologie du modèle entre Triangle pour le détail géométrique et Quad pour la régularité de la surface.

symmetry_mode par défaut auto

Choisissez si la génération du modèle impose la symétrie avec On, l'omet avec Off ou la détermine automatiquement avec Auto.

pose_mode par défaut

Laissez la chaîne vide pour ne pas spécifier 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'.

par défaut 30000

Nombre de polygones cible, plafonné à 15,000 lorsque model_type vaut 'smart-topology'. Omettre la cible dans ce mode sélectionne la valeur par défaut inférieure de Meshy, soit 4,000.

par défaut 1.7

Fournissez une taille estimée du personnage en mètres lorsque enable_rigging vaut 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 vaut true : les valeurs hors de [0, 696] sont rejetées avec un 422, et "Idle" correspond à `0`.

POST /run/meshy/v6-preview/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/v6-preview/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"

Exécuter cette requête

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

À propos de Meshy 6 Preview · Image to 3D

Crée un modèle 3D à partir d'une seule image via `image_url`. Choisissez des maillages standard, lowpoly ou smart-topology, une topologie en triangles ou quadrangles, ainsi qu'un `target_polycount` de 100 à 300000. La texturation peut être guidée par `texture_prompt` ou `texture_image_url` ; des cartes PBR, un mode pose, le rigging humanoïde et des préréglages d'animation sont disponibles.

Paramètres

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

NomType Par défautAutorisé Description
image_urlobligatoire image
Typeurl · image
Fournissez l'image source pour la création 3D par URL ou URI de données base64, en utilisant .jpg, .jpeg, .png, AVIF ou HEIF. La conversion automatique prend en charge les entrées AVIF et HEIF.
model_typefacultatif
Typeenum
Par défautstandard
standardlowpolysmart-topology
Mode de maillage 3D : choisissez 'lowpoly' pour un résultat low-poly optimisé pour des polygones plus nets ; dans ce mode, Meshy ignore topology, target_polycount et should_remesh. Pour un résultat conventionnel très détaillé, choisissez 'standard', ou choisissez 'smart-topology' pour utiliser Meshy-T2 et obtenir des parties nettes générées séparément dès le départ.
topologyfacultatif
Typeenum
Par défauttriangle
quadtriangle
Choix de topologie du modèle entre Triangle pour le détail géométrique et Quad pour la régularité de la surface.
target_polycountfacultatif
Typeinteger
Par défaut30000
100 – 300 000
Nombre de polygones cible, plafonné à 15,000 lorsque model_type vaut 'smart-topology'. Omettre la cible dans ce mode sélectionne la valeur par défaut inférieure de Meshy, soit 4,000.
symmetry_modefacultatif
Typeenum
Par défautauto
offautoon
Choisissez si la génération du modèle impose la symétrie avec On, l'omet avec Off ou la détermine automatiquement avec Auto.
should_remeshfacultatif
Typeboolean
Par défauttrue
Active ou désactive l'étape de remeshing.
should_texturefacultatif
Typeboolean
Par défauttrue
Active ou désactive la génération de textures.
enable_pbrfacultatif
Typeboolean
Par défautfalse
Ajoute les cartes PBR metallic, roughness et normal à 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 spécifier 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
Instructions textuelles dirigeant la génération de textures.
texture_image_urlfacultatif
Typeurl · image
Image de référence 2D dirigeant la génération de textures.
enable_riggingfacultatif
Typeboolean
Par défautfalse
Rigging humanoïde automatique, particulièrement efficace pour les modèles humanoïdes dont les membres sont clairement distincts. L'activation applique le 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 vaut 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édéfinie, ce qui nécessite que enable_rigging vaille 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 vaut true : les valeurs hors de [0, 696] sont rejetées avec un 422, et "Idle" correspond à `0`.
enable_safety_checkerfacultatif
Typeboolean
Par défauttrue
Commutateur de contrôle de sécurité du prétraitement : true rend le contrôle de sécurité de l'entrée préalable au traitement.
obligatoire 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/v6-preview/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"
  }
}
Vos fichiers, votre choixChaque outputs[].url est une copie sur notre stockage : conservée indéfiniment (facturation par Go-mois) ou 7 jours gratuitement, selon le réglage de votre compte ou ?storage=.
Une structure identique pour chaque modèletype, url, content_type, width, height et duration, pour les images, les vidéos et l'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 vaut 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 vaut 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 différents formats.
texture_urls
array of object {base_color, metallic, normal, roughness}Objets de fichiers de texture dans un tableau structuré selon l'API Meshy.
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 vaut 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 vaut true.
basic_animations
object {walking_glb, walking_fbx, walking_armature_glb, running_glb, running_fbx, running_armature_glb} | nullAnimations de base de marche et de course, incluses uniquement si enable_rigging vaut true.
rig_task_id
string | nullIdentifiant de la tâche de rigging ; inclus uniquement si enable_rigging vaut true.

Plus de modèles : Image vers 3D

Pour les agents IA : cette page au format Markdown est disponible à l'adresse https://doitong.com/fr-FR/developers/models/meshy/v6-preview/image-to-3d.md. Tous les modèles et guides : https://doitong.com/developers/llms.txt