Passer au contenu

Meshy V7 Text to 3D

Intégrer

Identifiant du modèle meshy/v7/text-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/text-to-3d?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  }'

# 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 Texte vers 3D #stylized#transform

Texte-3D avec Meshy 7 : mode aperçu ou complet, géométrie 2k, options PBR, squelette 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.

•requis 88 / 600

Description de l'objet à représenter sous forme de modèle 3D, limitée à 600 caractères.

mode par défaut full

Mode de génération : 'preview' produit la géométrie sans textures, tandis que 'full' produit un modèle texturé en combinant preview et refine.

geometry_resolution

Résolution de la géométrie du maillage ; les options Meshy-7 prises en charge sont standard et 2k.

Avancé texture_prompt · texture_image_url · model_type · topology · symmetry_mode · pose_mode · target_polycount · rigging_height_meters · animation_action_id · seed · should_remesh · enable_pbr · is_a_t_pose · enable_prompt_expansion · enable_safety_checker · ultra_mode
0 / 600

Guide le texturage avec un prompt textuel supplémentaire en mode 'full' ; les autres modes ne l'utilisent pas.

Déposez un fichier, ou

Image de référence 2D pour la génération de textures, appliquée uniquement en mode 'full'.

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 classique riche en détails, choisissez 'standard', ou choisissez 'smart-topology' pour utiliser Meshy-T2 lors de l'étape de géométrie (preview) et obtenir des éléments nets générés séparément dès le départ.

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 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 cible de polygones, 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 l'animation prédéfinie de la bibliothèque Meshy, avec les actions disponibles répertoriées à l'adresse 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`.

Réutilisez cette graine avec un prompt inchangé pour reproduire généralement un résultat antérieur.

POST /run/meshy/v7/text-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/text-to-3d?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  }'

# 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 V7 Text to 3D

Génère un modèle 3D à partir d’un `prompt` de 600 caractères maximum, avec `enable_prompt_expansion` facultatif. `mode` renvoie une géométrie non texturée ou un modèle texturé. Choisissez standard, lowpoly ou smart-topology via `model_type`, définissez `target_polycount` de 100 à 300000 et sélectionnez une `geometry_resolution` standard ou 2k. Des préréglages de squelette et d’animation peuvent être ajoutés aux personnages humanoïdes.

Paramètres

NomType Par défautAutorisé Description
promptrequis
Typestring
≤ 600 caractères
Description de l'objet à représenter sous forme de modèle 3D, limitée à 600 caractères.
modefacultatif
Typeenum
Par défautfull
previewfull
Mode de génération : 'preview' produit la géométrie sans textures, tandis que 'full' produit un modèle texturé en combinant preview et refine.
seedfacultatif
Typeinteger | null
Réutilisez cette graine avec un prompt inchangé pour reproduire généralement un résultat antérieur.
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 classique riche en détails, choisissez 'standard', ou choisissez 'smart-topology' pour utiliser Meshy-T2 lors de l'étape de géométrie (preview) et obtenir des éléments nets générés séparément dès le départ.
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 cible de polygones, 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.
should_remeshfacultatif
Typeboolean
Par défauttrue
Ignorez le remeshing et recevez le maillage triangulaire brut en définissant cette valeur sur false ; sinon, activez la phase de remesh.
symmetry_modefacultatif
Typeenum
Par défautauto
offautoon
Paramètre de symétrie appliqué lors de la génération du modèle.
enable_pbrfacultatif
Typeboolean
Par défautfalse
Contrôle la génération des cartes PBR métalliques, de rugosité et normales 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 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'.
enable_prompt_expansionfacultatif
Typeboolean
Par défautfalse
Autorise un grand modèle de langage à enrichir le prompt avec des détails. Cette expansion ne modifie pas le sens du prompt.
texture_promptfacultatif
Typestring | null
≤ 600 caractères
Guide le texturage avec un prompt textuel supplémentaire en mode 'full' ; les autres modes ne l'utilisent pas.
texture_image_urlfacultatif
Typeurl · image
Image de référence 2D pour la génération de textures, appliquée uniquement en mode 'full'.
enable_riggingfacultatif
Typeboolean
Par défautfalse
Rigging automatique d'un personnage humanoïde, particulièrement efficace pour les modèles humanoïdes dont les membres sont clairement distinguables. Son 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 soit true.
animation_action_idfacultatif
Typeinteger
Par défaut92
ID de l'animation prédéfinie de la bibliothèque Meshy, avec les actions disponibles répertoriées à l'adresse 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 contrôle de sécurité avant traitement : true rend le contrôle de sécurité de l'entrée préalable au traitement.
geometry_resolutionfacultatif
Typeenum
standard2k
Résolution de la géométrie du maillage ; les options Meshy-7 prises en charge sont standard et 2k.
ultra_modefacultatif
Typeboolean
Par défautfalse
Option obsolète remplacée par geometry_resolution, qui est prioritaire si les deux sont fournies ; utilisez plutôt geometry_resolution='2k'.
requis

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/text-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": {
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  },
  "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,
    "prompt": "A rustic, antique wooden treasure chest with a curved, domed lid, constructed from weathered, dark brown planks exhibiting prominent wood grain and subtle distress. It's heavily reinforced with broad, dark grey, oxidized metal bands secured by numerous circular rivets. Ornate, dark iron decorative elements featuring swirling foliate patterns and dragon motifs adorn the corners and lid. A prominent, circular, intricately carved metal lock plate with a central keyhole dominates the front, flanked by two large, dark metallic pull rings.",
    "actual_prompt": "string",
    "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 au Go-mois) ou 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, vidéos et fichiers audio. output est le propre objet de résultat du 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 différents formats.
texture_urls
array of object {base_color, metallic, normal, roughness}Fichiers de texture représentés sous forme de tableau d'objets.
seed
integer | nullValeur de la graine utilisée pendant la génération.
prompt
stringPrompt textuel fourni pour la génération.
actual_prompt
string | nullPrompt effectivement appliqué à la génération lorsque l'expansion du prompt était activée.
rigged_character_glb
object {url, content_type, file_name, file_size} | nullRésultat du rigging fourni sous forme de 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 sous forme de 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 base de marche et de course, 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 : Texte vers 3D

Pour les agents IA : cette page au format Markdown est disponible à https://doitong.com/fr/developers/models/meshy/v7/text-to-3d.md. Tous les modèles et guides : https://doitong.com/developers/llms.txt