Meshy 6 · Image to 3D

Intégrer

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

const API = "https://api.doitong.ru/v1";
const headers = {
  "Authorization": "Bearer " + process.env.DOITONG_API_KEY,
  "Content-Type": "application/json",
};

// Run the model; wait up to 20 s for the finished result in the same call
let res = await fetch(API + "/run/meshy/v6/image-to-3d?wait=20", {
  method: "POST",
  headers,
  body: JSON.stringify({
    "image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  }),
});
let request = await res.json();
if (!res.ok) throw new Error(request.error.code + ": " + request.error.message);

// Not finished yet: long-poll until it is
while (request.status === "queued" || request.status === "running") {
  res = await fetch(API + "/requests/" + request.id + "?wait=20", { headers });
  request = await res.json();
}
if (request.status !== "succeeded") throw new Error(JSON.stringify(request.error));
console.log(request.outputs.map((o) => o.url), request.cost.credits + " API credits ($" + request.cost.usd + ")");

import os
import requests

API = "https://api.doitong.ru/v1"
headers = {"Authorization": "Bearer " + os.environ["DOITONG_API_KEY"]}

payload = {
    "image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg",
}

# Run the model; wait up to 20 s for the finished result in the same call
r = requests.post(API + "/run/meshy/v6/image-to-3d", params={"wait": 20}, json=payload, headers=headers)
request = r.json()
if not r.ok:
    raise RuntimeError(request["error"]["code"] + ": " + request["error"]["message"])

# Not finished yet: long-poll until it is
while request["status"] in ("queued", "running"):
    request = requests.get(API + "/requests/" + request["id"], params={"wait": 20}, headers=headers).json()
if request["status"] != "succeeded":
    raise RuntimeError(request["error"])
print([o["url"] for o in request["outputs"]], request["cost"]["credits"], "API credits", "$" + request["cost"]["usd"])

# 1. Connect once (Claude Code; Cursor, VS Code, Claude Desktop: https://doitong.com/fr/developers/docs/mcp)
claude mcp add --transport http doitong-models https://api.doitong.ru/v1/mcp \
  --header "Authorization: Bearer $DOITONG_API_KEY"

# 2. Your agent calls the "run" tool with:
{
  "model_id": "meshy/v6/image-to-3d",
  "input": {
    "image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  }
}

Appelez le modèle Meshy 6 · Image to 3D (meshy/v6/image-to-3d) via la Doitong API. Documentation pour les agents : https://doitong.com/fr/developers/models/meshy/v6/image-to-3d.md

POST https://api.doitong.ru/v1/run/meshy/v6/image-to-3d?wait=20
Authorization: Bearer $DOITONG_API_KEY
Content-Type: application/json

{
  "image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
}

Si le statut de la réponse est "queued" ou "running", interrogez GET https://api.doitong.ru/v1/requests/REQUEST_ID?wait=20 jusqu’à ce qu’il soit "succeeded" ; les fichiers se trouvent dans outputs[].url. POST https://api.doitong.ru/v1/quote/meshy/v6/image-to-3d avec le même corps renvoie le prix exact avant l’exécution.

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 d’une image unique en maillage 3D avec option de géométrie 2k, PBR, squelette et animation facultatifs

OpenAPI Markdown

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.

image •requis 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 traite 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

texture_prompt 0 / 600

Instructions textuelles qui orientent la génération de textures.

texture_image_url

Déposez un fichier, ou

Image de référence 2D qui oriente 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 classique riche en détails, choisissez 'standard', ou choisissez 'smart-topology' pour utiliser Meshy-T2 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

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'.

target_polycount 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.

rigging_height_meters 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.

animation_action_id 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`.

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

const API = "https://api.doitong.ru/v1";
const headers = {
  "Authorization": "Bearer " + process.env.DOITONG_API_KEY,
  "Content-Type": "application/json",
};

// Run the model; wait up to 20 s for the finished result in the same call
let res = await fetch(API + "/run/meshy/v6/image-to-3d?wait=20", {
  method: "POST",
  headers,
  body: JSON.stringify({
    "image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  }),
});
let request = await res.json();
if (!res.ok) throw new Error(request.error.code + ": " + request.error.message);

// Not finished yet: long-poll until it is
while (request.status === "queued" || request.status === "running") {
  res = await fetch(API + "/requests/" + request.id + "?wait=20", { headers });
  request = await res.json();
}
if (request.status !== "succeeded") throw new Error(JSON.stringify(request.error));
console.log(request.outputs.map((o) => o.url), request.cost.credits + " API credits ($" + request.cost.usd + ")");

import os
import requests

API = "https://api.doitong.ru/v1"
headers = {"Authorization": "Bearer " + os.environ["DOITONG_API_KEY"]}

payload = {
    "image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg",
}

# Run the model; wait up to 20 s for the finished result in the same call
r = requests.post(API + "/run/meshy/v6/image-to-3d", params={"wait": 20}, json=payload, headers=headers)
request = r.json()
if not r.ok:
    raise RuntimeError(request["error"]["code"] + ": " + request["error"]["message"])

# Not finished yet: long-poll until it is
while request["status"] in ("queued", "running"):
    request = requests.get(API + "/requests/" + request["id"], params={"wait": 20}, headers=headers).json()
if request["status"] != "succeeded":
    raise RuntimeError(request["error"])
print([o["url"] for o in request["outputs"]], request["cost"]["credits"], "API credits", "$" + request["cost"]["usd"])

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "run",
    "arguments": {
      "model_id": "meshy/v6/image-to-3d",
      "input": {
        "image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
      },
      "wait_seconds": 20
    }
  }
}

Exécuter cette requête

Clé API

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. Mémoriser dans ce navigateur Obtenir une clé API

À propos de Meshy 6 · Image to 3D

Construit un modèle 3D à partir d’une image (`image_url`). `model_type` vaut standard, lowpoly ou smart-topology, la topologie est triangle ou quad, et `target_polycount` va de 100 à 300000 (15,000 maximum pour smart topology). Les options couvrent le texturage, les cartes PBR, la symétrie, la pose A ou T et le squelette humanoïde avec un préréglage d’animation. Les sorties incluent des fichiers GLB et FBX.

Paramètres

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

NomType Par défautAutorisé Description

image_urlrequis 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 traite les entrées AVIF et HEIF.

model_typefacultatif

Typeenum

Par défautstandard

standardlowpolysmart-topology

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.

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 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'.

texture_promptfacultatif

Typestring | null

≤ 600 caractères

Instructions textuelles qui orientent la génération de textures.

texture_image_urlfacultatif

Typeurl · image

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

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

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.

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/v6/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 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}Objets de fichiers de texture dans un tableau structuré conformément à la Meshy API.
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 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 : Image vers 3D

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

Votre premier résultat apparaîtra ici

Créer une requête

Exécuter cette requête

À propos de Meshy 6 · Image to 3D

Paramètres

Sortie

Autres variantes Meshy 6

Meshy 6 · Text to 3D Variantes : 2

Plus de modèles : Image vers 3D

Meshy 6 Preview · Image to 3D Variantes : 2

Meshy 7.1 Image to 3D Variantes : 3

Meshy 7.1 Multi Image to 3D Variantes : 3

Meshy V7 Image to 3D Variantes : 4