Passer au contenu

Meshy 7 Retexture

Intégrer

Identifiant du modèle meshy/v7/retexture
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/v1/run/meshy/v7/retexture?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model_url": "https://example.com/your-file.glb"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Cette requête: 0,30 $ 300 crédits API L’exécuter sur cette page

Obtenir une clé API
Meshy 3D Sortie 4K #3d#3d-to-3d#textures#pbr

Version Meshy 7 du retexturage 3D : nouvelle apparence à partir d’une invite ou d’une image de style, avec sortie PBR facultative

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.

texture_resolution par défaut 2k

Les résolutions de couleur de base sont 2k (2048), 4k (4096) et 8k (8192). La sélection de 8k limite les cartes PBR à 4k et omet la carte d'émission ; 8k et 4k sont disponibles uniquement avec Meshy 6 ou 7.

•requis

Source du modèle 3D à texturer, fournie sous forme d'URL accessible publiquement ou d'URI de données base64 utilisant application/octet-stream comme type MIME. Les extensions acceptées sont .glb, .gltf, .obj, .fbx et .stl.

Avancé text_style_prompt · image_style_url · enable_original_uv · enable_pbr · enable_safety_checker
0 / 600

Texte décrivant le style de texture, requis en l'absence de image_style_url et limité à 600 caractères.

Déposez un fichier, ou

Guide de texturage 2D prioritaire sur text_style_prompt lorsqu'il est fourni comme image_style_url. Fournissez cette image si text_style_prompt est absent ; les types de fichier pris en charge sont .jpg, .jpeg et .png.

POST /run/meshy/v7/retexture?wait=20 devis → 0,30 $
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/v1/run/meshy/v7/retexture?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model_url": "https://example.com/your-file.glb"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.com/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 7 Retexture

Retexture un fichier 3D fourni (.glb, .gltf, .obj, .fbx, .stl) à partir d’une description textuelle de 600 caractères maximum ou d’une image de style 2D ; l’image est prioritaire lorsque les deux sont envoyés. La résolution de la couleur de base est 2k, 4k ou 8k ; en 8k, les cartes PBR passent à 4k sans carte d’émission. Définissez `enable_original_uv` pour conserver les UV existantes et `enable_pbr` pour obtenir les cartes métallique, rugosité et normales. Renvoie un GLB ainsi que d’autres formats et fichiers de texture.

Paramètres

NomType Par défautAutorisé Description
model_urlrequis
Typestring
Source du modèle 3D à texturer, fournie sous forme d'URL accessible publiquement ou d'URI de données base64 utilisant application/octet-stream comme type MIME. Les extensions acceptées sont .glb, .gltf, .obj, .fbx et .stl.
text_style_promptfacultatif
Typestring | null
≤ 600 caractères
Texte décrivant le style de texture, requis en l'absence de image_style_url et limité à 600 caractères.
image_style_urlfacultatif
Typeurl · image
Guide de texturage 2D prioritaire sur text_style_prompt lorsqu'il est fourni comme image_style_url. Fournissez cette image si text_style_prompt est absent ; les types de fichier pris en charge sont .jpg, .jpeg et .png.
texture_resolutionfacultatif
Typeenum
Par défaut2k
2k4k8k
Les résolutions de couleur de base sont 2k (2048), 4k (4096) et 8k (8192). La sélection de 8k limite les cartes PBR à 4k et omet la carte d'émission ; 8k et 4k sont disponibles uniquement avec Meshy 6 ou 7.
enable_original_uvfacultatif
Typeboolean
Par défauttrue
Conservez les UV au lieu de les régénérer en activant cette option. La qualité peut diminuer si elle est activée pour un modèle dépourvu de mappage UV d'origine.
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.
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

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/retexture",
  "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": 300,
    "usd": "0.30",
    "charged": 300,
    "refunded": 0
  },
  "input": {
    "model_url": "https://example.com/your-file.glb"
  },
  "output": {
    "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
        }
      }
    ],
    "text_style_prompt": "red and black chest",
    "image_style_url": "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.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.com/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
model_glb
object {url, content_type, file_name, file_size}Objet 3D au format GLB avec textures mises à jour.
thumbnail
object {url, content_type, file_name, file_size} | nullVignette affichant un aperçu du modèle après le retexturage.
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.
text_style_prompt
string | nullPrompt de texturage utilisé, lorsqu'il a été fourni.
image_style_url
string | nullURL de l'image de texturage utilisée, lorsqu'elle a été fournie.

Plus de modèles : 3D

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