lowpoly sera retiré le 30 oct. 2026. meshy-7 sera retiré en tant que modèle de génération 3D le 31 déc. 2026 ; il reste disponible en tant que modèle de texture. Changez de modèle avant ces dates pour éviter les erreurs de requête. Voir toutes les dépréciations

Retexture API

Générez de nouvelles textures pour un modèle 3D existant à partir d'un prompt textuel ou d'images de référence. Le modèle peut provenir d'une autre tâche Meshy ou d'un fichier de modèle.


POST/openapi/v1/retexture

Créer une tâche de Retexturisation

Crée une tâche de Retexturisation. La tâche s'exécute en arrière-plan. Pour connaître la durée habituelle d'une tâche, consultez Temps de traitement.

Request

POST
/openapi/v1/retexture
# Retexture with text prompt
curl https://api.meshy.ai/openapi/v1/retexture \
  -H "Authorization: Bearer ${YOUR_API_KEY}" \
  -H 'Content-Type: application/json' \
  -d '{
    "model_url": "https://cdn.meshy.ai/model/example_model_2.glb",
    "text_style_prompt": "red fangs, Samurai outfit that fused with japanese batik style",
    "enable_original_uv": true,
    "enable_pbr": true
  }'

# Retexture with image style and PBR
curl https://api.meshy.ai/openapi/v1/retexture \
  -H "Authorization: Bearer ${YOUR_API_KEY}" \
  -H 'Content-Type: application/json' \
  -d '{
    "model_url": "https://cdn.meshy.ai/model/example_model_2.glb",
    "image_style_url": "<your publicly accessible image url or base64-encoded data URI>",
    "ai_model": "latest",
    "enable_pbr": true,
    "enable_original_uv": true
  }'

# Retexture with Meshy N1 from front and back views
curl https://api.meshy.ai/openapi/v1/retexture \
  -H "Authorization: Bearer ${YOUR_API_KEY}" \
  -H 'Content-Type: application/json' \
  -d '{
    "model_url": "https://cdn.meshy.ai/model/example_model_2.glb",
    "ai_model": "meshy-n1",
    "multiview_image_urls": [
      "<your front view image url or data URI>",
      "<your back view image url or data URI>"
    ]
  }'

Response

{
  "result": "018a210d-8ba4-705c-b111-1f1776f7f578"
}

Paramètres

  • Name
    input_task_id
    Type
    string
    Requis
    Description

    Requis sauf si vous envoyez model_url. L'ID d'une tâche ayant produit un modèle 3D à texturer, par exemple une tâche Texte en 3D, Image en 3D, Remaillage ou Retexturisation. La tâche doit être une tâche que vous avez créée avec l'API et dont le statut est SUCCEEDED. Meshy texture le GLB de la tâche.

    Avec meshy-n1, le modèle de la tâche peut avoir au maximum 7 999 999 faces, comptées en triangles (un quadrilatère compte pour 2).

  • Name
    model_url
    Type
    string
    Requis
    Description

    Requis sauf si vous envoyez input_task_id. Le modèle à texturer, sous forme d'URL publique ou de Data URI. Si vous envoyez les deux, Meshy utilise input_task_id.

    Le modèle doit être un fichier GLB, glTF, OBJ, FBX ou STL d'au plus 400 Mo provenant d'une URL http ou https, ou de 100 Mo en tant que Data URI. Pour une Data URI, utilisez le MIME type application/octet-stream, par exemple data:application/octet-stream;base64,<vos données de modèle encodées en base64>.

    Un fichier de plus de 100 Mo doit également respecter ces règles :

    • Un fichier GLB, glTF, FBX ou OBJ peut avoir au maximum 10 000 000 de faces. Meshy compte les faces en triangles, donc un quadrilatère compte pour 2, et un maillage dessiné plusieurs fois compte une fois par copie.
    • Un fichier FBX doit être au format FBX binaire 7.1 ou plus récent.
    • Un fichier GLB ou glTF ne doit pas utiliser la compression Draco.

    Avec meshy-n1, le modèle peut avoir au maximum 7 999 999 faces, comptées en triangles (un quadrilatère compte pour 2), quelle que soit sa taille de fichier.

Envoyez l'une de ces trois entrées de style.

  • Name
    text_style_prompt
    Type
    string
    Requis
    Description

    Requis sauf si vous envoyez image_style_url ou multiview_image_urls. Texte décrivant la texture souhaitée, jusqu'à 800 caractères. Un texte plus long renvoie 400. Avec meshy-n1, l'envoyer sans image_style_url renvoie 400.

  • Name
    image_style_url
    Type
    string
    Requis
    Description

    Requis sauf si vous envoyez text_style_prompt ou multiview_image_urls. Une image 2D dont le style sera suivi par la texture, sous forme d'URL publique ou de Data URI (data:image/jpeg;base64,<vos données d'image encodées en base64>). Si vous envoyez à la fois text_style_prompt et image_style_url, Meshy utilise image_style_url.

    L'image doit être un fichier .jpg, .jpeg, .png ou .webp d'au plus 20 Mo, et d'au moins 32 pixels de chaque côté.

    La texture peut ne pas s'ajuster correctement lorsque l'objet de l'image a une forme très différente du modèle. Avec meshy-n1, Meshy traite l'image comme la vue de face.

  • Name
    multiview_image_urls
    Type
    string[]
    Requis
    Description

    Requis sauf si vous envoyez text_style_prompt ou image_style_url. Une à quatre images du même objet sous des angles différents. La première image est la vue principale (de face). L'ordre des autres vues (gauche, arrière, droite) n'a pas d'importance. Un tableau vide, ou plus de quatre images, renvoie 400.

    Chaque image suit les mêmes règles de format et de taille que image_style_url, soit au plus 20 Mo par image. Vous ne pouvez pas combiner multiview_image_urls avec text_style_prompt ou image_style_url.

    multiview_image_urls nécessite un ai_model explicite valant meshy-7 ou meshy-n1. Tout autre ai_model, y compris la valeur par défaut latest, renvoie 400.

  • Name
    ai_model
    Type
    string
    défaut latest
    Description

    Le modèle d'IA qui génère la texture.

    Valeurs disponibles :

    • meshy-6-lite
    • meshy-6
    • meshy-7
    • meshy-n1 : une texture de couleur de base en 2K uniquement à partir d'images de référence. Pas de prompt textuel, pas de cartes PBR, pas de 4K ou 8K. Jusqu'à 7 999 999 faces.
    • latest : Meshy 7
  • Name
    enable_original_uv
    Type
    boolean
    défaut false
    Description

    Indique s'il faut conserver la disposition UV du modèle au lieu d'en générer une nouvelle.

    • Pour un modèle généré par Meshy, provenant de input_task_id ou d'un model_url pointant vers une sortie Meshy, utilisez true pour réutiliser sa disposition UV optimisée.
    • Pour un modèle que vous avez importé d'ailleurs, utilisez true pour conserver des UV déjà de bonne qualité. Laissez false pour laisser Meshy générer de nouveaux UV, ce qui convient à un modèle sans mappage UV approprié.
  • Name
    enable_pbr
    Type
    boolean
    défaut false
    Description

    Indique s'il faut aussi générer des cartes PBR (métallique, rugosité et normale) avec la couleur de base. Avec meshy-6, Meshy génère aussi une carte d'émission, sauf à une texture_resolution de 8k. meshy-6-lite, meshy-7 et latest ne génèrent pas de carte d'émission. Avec meshy-n1, true renvoie 400.

  • Name
    texture_resolution
    Type
    string
    défaut 2k
    Description

    La taille de la texture de couleur de base. Des résolutions plus élevées capturent davantage de détails de surface.

    Valeurs disponibles :

    • 2k : 2048 × 2048 pixels
    • 4k : 4096 × 4096 pixels
    • 8k : 8192 × 8192 pixels

    4k et 8k nécessitent un ai_model valant meshy-6, meshy-7 ou latest. Avec meshy-6-lite ou meshy-n1, elles renvoient 400. À 8k, Meshy ne génère pas de carte d'émission.

  • Name
    hd_texture
    Type
    boolean
    ⚠ obsolète
    défaut false
    Description

    Utilisez plutôt texture_resolution. true équivaut à texture_resolution: "4k". Si vous envoyez les deux, Meshy utilise texture_resolution.

  • Name
    remove_lighting
    Type
    boolean
    défaut true
    Description

    Indique s'il faut supprimer les reflets et les ombres de la texture de couleur de base. Le résultat fonctionne mieux sous votre propre éclairage.

    Meshy l'applique uniquement avec meshy-6, à une texture_resolution de 2k ou 4k. Avec meshy-7 ou latest, ou à 8k, Meshy accepte le paramètre et l'ignore. Avec meshy-6-lite ou meshy-n1, l'envoyer avec n'importe quelle valeur renvoie 400.

  • Name
    target_formats
    Type
    string[]
    Description

    Les formats de fichiers à générer. Meshy ne génère que les formats que vous listez, ce qui peut raccourcir la tâche. Si vous l'omettez, Meshy génère tous les formats sauf 3mf.

    Valeurs disponibles :

    • glb
    • obj
    • fbx
    • stl
    • usdz
    • 3mf
  • Name
    alpha_thumbnail
    Type
    boolean
    défaut false
    Description

    Indique s'il faut aussi générer un aperçu avec un fond transparent (RGBA), renvoyé dans alpha_thumbnail_url lorsque vous récupérez la tâche. thumbnail_url ne change pas.

Retours

Le champ result de la réponse contient l'ID de la nouvelle tâche de Retexturisation.

Modes d'échec

  • Name
    400 - Bad Request
    Description

    La requête ne peut pas s'exécuter. Le message d'erreur indique le problème rencontré. Par exemple :

    • Paramètre manquant : Ni model_url ni input_task_id n'ont été envoyés.
    • Style manquant : Aucun de text_style_prompt, image_style_url et multiview_image_urls n'a été envoyé.
    • Entrées de style en conflit : multiview_image_urls a été envoyé avec text_style_prompt ou image_style_url.
    • Modèle non pris en charge pour la multi-vue : multiview_image_urls a été envoyé sans ai_model explicite valant meshy-7 ou meshy-n1.
    • Option non prise en charge pour Meshy N1 : meshy-n1 a été envoyé avec enable_pbr: true, remove_lighting, une texture_resolution de 4k ou 8k, hd_texture: true sans texture_resolution, ou text_style_prompt sans image_style_url.
    • Trop de triangles pour Meshy N1 : Avec meshy-n1, le modèle 3D a plus de 7 999 999 triangles. Réduisez le nombre de triangles, ou utilisez un autre ai_model.
    • Modèle trop complexe pour Meshy N1 : Avec meshy-n1, le fichier model_url est trop complexe pour que Meshy puisse compter ses triangles. Réduisez le nombre de triangles, puis renvoyez le fichier.
    • Délai de comptage des triangles dépassé : Avec meshy-n1, le comptage des triangles du fichier model_url a pris trop de temps. Réessayez, ou réduisez la taille du modèle.
    • Tâche d'entrée invalide : input_task_id n'est pas une tâche réussie d'un type pris en charge.
    • Format de modèle invalide : Le fichier model_url a une extension non prise en charge.
    • URL inaccessible : Meshy ne peut pas télécharger le fichier model_url, l'image image_style_url, ou une image multiview_image_urls.
    • Fichier de modèle trop volumineux : Le fichier model_url dépasse 400 Mo depuis une URL http ou https, ou dépasse 100 Mo en tant que Data URI.
    • Trop de faces : Le fichier model_url dépasse 100 Mo et comporte plus de 10 000 000 de faces. Réduisez le nombre de faces, puis renvoyez le fichier.
    • FBX ASCII supérieur à 100 Mo : Le fichier model_url est un fichier FBX ASCII de plus de 100 Mo. Envoyez-le en tant que FBX binaire ou GLB.
    • Fichier de modèle illisible : Le fichier model_url dépasse 100 Mo, et Meshy ne peut pas lire son en-tête. Par exemple, il s'agit d'un GLB ou glTF compressé avec Draco, ou d'un FBX binaire antérieur à 7.1.
    • En-tête de modèle trop complexe : Le fichier model_url dépasse 100 Mo, et son en-tête contient trop de maillages, de nœuds ou d'enregistrements à vérifier. Réduisez le nombre d'objets dans le fichier, puis renvoyez-le.
    • Image trop volumineuse : L'image image_style_url ou une image multiview_image_urls dépasse 20 Mo.

    Avec meshy-n1, un modèle que Meshy ne peut pas vérifier avant le démarrage de la tâche, comme un fichier STL, n'est pas refusé ici. S'il a plus de 7 999 999 triangles, la tâche échoue, et Meshy rembourse ses crédits.

    Corrigez la requête, puis renvoyez-la. Consultez Erreurs.

  • Name
    401 - Unauthorized
    Description

    La clé API est manquante ou invalide. Vérifiez l'en-tête Authorization.

  • Name
    402 - Payment Required
    Description

    Par exemple :

    • Crédits insuffisants : Le compte n'a pas assez de crédits pour cette tâche, ou le compte a atteint une limite de crédits. Vérifiez votre solde de crédits, puis réessayez.
    • Plan gratuit : La création d'une tâche nécessite un plan payant. Mettez à niveau votre plan dans vos paramètres d'abonnement, puis réessayez.
  • Name
    403 - Forbidden
    Description

    L'un des cas suivants s'applique :

    • La modération de contenu a bloqué le prompt ou une image d'entrée. Modifiez l'entrée, puis réessayez.
    • input_task_id est un modèle en bas-relief, que ce point de terminaison ne peut pas retexturer. Le message est This model type does not support this operation. Envoyez un modèle différent.
  • Name
    404 - Not Found
    Description

    input_task_id ne correspond à aucune de vos tâches. Vérifiez l'ID de la tâche, puis renvoyez la requête.

  • Name
    429 - Too Many Requests
    Description

    Vous avez dépassé votre limite de débit. Attendez, puis réessayez. Consultez Limites de débit.


GET/openapi/v1/retexture/:id

Récupérer une tâche de Retexturisation

Renvoie une tâche de Retexturisation à partir de son ID.

Request

GET
/openapi/v1/retexture/018a210d-8ba4-705c-b111-1f1776f7f578
curl https://api.meshy.ai/openapi/v1/retexture/018a210d-8ba4-705c-b111-1f1776f7f578 \
  -H "Authorization: Bearer ${YOUR_API_KEY}"

Response

{
  "id": "018a210d-8ba4-705c-b111-1f1776f7f578",
  "type": "retexture",
  "model_urls": {
    "glb": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.glb?Expires=***",
    "fbx": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.fbx?Expires=***",
    "obj": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.obj?Expires=***",
    "usdz": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.usdz?Expires=***",
    "mtl": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.mtl?Expires=***",
    "stl": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.stl?Expires=***"
  },
  "thumbnail_url": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/preview.png?Expires=***",
  "text_style_prompt": "red fangs, Samurai outfit that fused with japanese batik style",
  "texture_image_url": "",
  "progress": 100,
  "started_at": 1692771667037,
  "created_at": 1692771650657,
  "expires_at": 1692771679037,
  "finished_at": 1692771669037,
  "status": "SUCCEEDED",
  "texture_urls": [
    {
      "base_color": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/texture_0.png?Expires=***",
      "metallic": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/texture_0_metallic.png?Expires=XXX",
      "normal": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/texture_0_normal.png?Expires=XXX",
      "roughness": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/texture_0_roughness.png?Expires=XXX"
    }
  ],
  "task_error": null,

  "consumed_credits": 10
}

Paramètres

  • Name
    id
    Type
    path
    Description

    L'ID de la tâche provenant de la réponse de création.

Retours

L'objet tâche de Retexturisation.


DELETE/openapi/v1/retexture/:id

Supprimer une tâche de Retexturisation

Supprime définitivement une tâche de Retexturisation, y compris ses modèles et ses données. Vous ne pouvez pas annuler une suppression.

Request

DELETE
/openapi/v1/retexture/a43b5c6d-7e8f-901a-234b-567c890d1e2f
curl --request DELETE \
  --url https://api.meshy.ai/openapi/v1/retexture/a43b5c6d-7e8f-901a-234b-567c890d1e2f \
  -H "Authorization: Bearer ${YOUR_API_KEY}"

Response

// 200 OK on success, with an empty body.
//
// 409 Conflict when the task is IN_PROGRESS. The task keeps running:
{
  "message": "Task is IN_PROGRESS and cannot be deleted. Credits for a task the worker has already started are not refundable; wait for it to reach SUCCEEDED, FAILED or CANCELED, then delete it."
}

Paramètres de chemin

  • Name
    id
    Type
    path
    Description

    L'ID de la tâche à supprimer.

Statut de la tâche

Supprimer une tâche PENDING rembourse les crédits utilisés lors de sa création.

Une tâche IN_PROGRESS ne peut pas être supprimée. La requête renvoie 409 Conflict, et la tâche continue de s'exécuter. Meshy ne rembourse pas une tâche qui a démarré, donc la supprimer vous coûterait à la fois les crédits et le résultat. Attendez qu'elle atteigne le statut SUCCEEDED, FAILED ou CANCELED, puis supprimez-la.

Supprimer une tâche dans un statut final (SUCCEEDED, FAILED ou CANCELED) ne rembourse pas ses crédits.

Retours

200 OK lorsque la tâche est supprimée, ou 409 Conflict lorsque la tâche est IN_PROGRESS.


GET/openapi/v1/retexture

Lister les tâches de Retexturisation

Renvoie une liste de vos tâches de Retexturisation.

Request

GET
/openapi/v1/retexture
curl https://api.meshy.ai/openapi/v1/retexture?page_size=10 \
-H "Authorization: Bearer ${YOUR_API_KEY}"

Response

[
  {
    "id": "018a210d-8ba4-705c-b111-1f1776f7f578",
    "type": "retexture",
    "model_urls": {
      "glb": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.glb?Expires=***",
      "fbx": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.fbx?Expires=***",
      "usdz": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.usdz?Expires=***"
    },
    "thumbnail_url": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/preview.png?Expires=***",
    "text_style_prompt": "red fangs, Samurai outfit that fused with japanese batik style",
    "progress": 100,
    "started_at": 1692771667037,
    "created_at": 1692771650657,
    "expires_at": 1692771679037,
    "finished_at": 1692771669037,
    "status": "SUCCEEDED",
    "texture_urls": [
      {
        "base_color": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/texture_0.png?Expires=***",
        "metallic": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/texture_0_metallic.png?Expires=XXX",
        "normal": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/texture_0_normal.png?Expires=XXX",
        "roughness": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/texture_0_roughness.png?Expires=XXX"
      }
    ],
    "task_error": null,

    "consumed_credits": 10
  }
]

Paramètres

  • Name
    page_num
    Type
    integer
    défaut 1
    Description

    Le numéro de page à renvoyer, jusqu'à 255. Une valeur plus élevée renvoie 400.

  • Name
    page_size
    Type
    integer
    défaut 10
    Description

    Le nombre de tâches par page, jusqu'à 100.

  • Name
    sort_by
    Type
    string
    Description

    L'ordre de tri.

    Valeurs disponibles :

    • +created_at : du plus ancien au plus récent
    • -created_at : du plus récent au plus ancien

Retours

Une liste paginée d'objets tâche de Retexturisation.


GET/openapi/v1/retexture/:id/stream

Diffuser les mises à jour d'une tâche de Retexturisation

Diffuse les mises à jour d'une tâche de Retexturisation sous forme d'événements envoyés par le serveur (SSE).

Request

GET
/openapi/v1/retexture/018a210d-8ba4-705c-b111-1f1776f7f578/stream
curl -N https://api.meshy.ai/openapi/v1/retexture/018a210d-8ba4-705c-b111-1f1776f7f578/stream \
-H "Authorization: Bearer ${YOUR_API_KEY}"

Response Stream

// Error event example
event: error
data: {
  "status_code": 404,
  "message": "Task not found"
}

// Message event examples illustrate task progress.
// These examples are shortened. Each event holds the full task object.
event: message
data: {
  "id": "018a210d-8ba4-705c-b111-1f1776f7f578",
  "progress": 0,
  "status": "PENDING"
}

event: message
data: {
  "id": "018a210d-8ba4-705c-b111-1f1776f7f578",
  "progress": 50,
  "status": "IN_PROGRESS"
}

event: message
data: {
  "id": "018a210d-8ba4-705c-b111-1f1776f7f578",
  "type": "retexture",
  "progress": 100,
  "status": "SUCCEEDED",
  "created_at": 1692771650657,
  "started_at": 1692771667037,
  "finished_at": 1692771669037,
  "model_urls": {
    "glb": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.glb?Expires=***",
    "fbx": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.fbx?Expires=***",
    "obj": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.obj?Expires=***",
    "usdz": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.usdz?Expires=***",
    "mtl": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.mtl?Expires=***",
    "stl": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.stl?Expires=***"
  },
  "texture_urls": [
    {
      "base_color": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/texture_0.png?Expires=***",
      "metallic": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/texture_0_metallic.png?Expires=XXX",
      "normal": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/texture_0_normal.png?Expires=XXX",
      "roughness": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/texture_0_roughness.png?Expires=XXX"
    }
  ],
  "task_error": null,

  "consumed_credits": 10
}

Paramètres

  • Name
    id
    Type
    path
    Description

    L'ID de la tâche provenant de la réponse de création.

Retours

Un flux d'objets de tâche de Retexturisation sous forme d'événements envoyés par le serveur (SSE).

Chaque événement contient l'objet de tâche complet, selon la même structure que celle renvoyée par le point de terminaison Get. Tant que la tâche est PENDING ou IN_PROGRESS, ses champs de résultat n'ont pas encore de valeurs.


L'objet de tâche Retexturisation

Un objet de tâche Retexturisation décrit une retexturisation d'un modèle 3D. Il contient le statut, la progression, ainsi que les fichiers de modèle et de texture lorsque la tâche réussit.

Propriétés

Example Retexture Task Model

{
  "id": "018a210d-8ba4-705c-b111-1f1776f7f578",
  "type": "retexture",
  "model_urls": {
    "glb": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.glb?Expires=***",
    "fbx": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.fbx?Expires=***",
    "usdz": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.usdz?Expires=***"
  },
  "text_style_prompt": "red fangs, Samurai outfit that fused with japanese batik style",
  "image_style_url": "https://assets.meshy.ai/***/image/example_image.jpg?Expires=***",
  "thumbnail_url": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/preview.png?Expires=***",
  "progress": 100,
  "started_at": 1692771667037,
  "created_at": 1692771650657,
  "expires_at": 1692771679037,
  "finished_at": 1692771669037,
  "status": "SUCCEEDED",
  "texture_urls": [
    {
      "base_color": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/texture_0.png?Expires=***",
      "metallic": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/texture_0_metallic.png?Expires=XXX",
      "normal": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/texture_0_normal.png?Expires=XXX",
      "roughness": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/texture_0_roughness.png?Expires=XXX"
    }
  ],
  "task_error": null,

  "consumed_credits": 10
}
  • Name
    id
    Type
    string
    Description

    L'ID de la tâche. Traitez-le comme une chaîne opaque et ne vous fiez pas à son format.

  • Name
    type
    Type
    string
    Description

    Le type de tâche, toujours retexture.

  • Name
    model_urls
    Type
    object
    Description

    Les URL de téléchargement pour le modèle 3D texturé, une par format de fichier.

    • Name
      glb
      Type
      string
      Description

      Le fichier GLB.

    • Name
      fbx
      Type
      string
      Description

      Le fichier FBX.

    • Name
      obj
      Type
      string
      Description

      Le fichier OBJ.

    • Name
      usdz
      Type
      string
      Description

      Le fichier USDZ.

    • Name
      mtl
      Type
      string
      Description

      Le fichier MTL. Meshy le renvoie avec le fichier OBJ lorsque le modèle possède des textures.

    • Name
      stl
      Type
      string
      Description

      Le fichier STL.

    • Name
      3mf
      Type
      string
      Description

      Le fichier 3MF. Présent uniquement lorsque target_formats inclut 3mf.

  • Name
    text_style_prompt
    Type
    string
    Description

    Le prompt textuel avec lequel vous avez créé la tâche.

  • Name
    image_style_url
    Type
    string
    Description

    L'image de style avec laquelle vous avez créé la tâche.

  • Name
    multiview_image_urls
    Type
    string[]
    Description

    Les URL de téléchargement pour les images de référence Multi-vue avec lesquelles vous avez créé la tâche. Présent uniquement lorsque vous avez créé la tâche avec multiview_image_urls.

  • Name
    thumbnail_url
    Type
    string
    Description

    L'URL de téléchargement pour une miniature du modèle.

  • Name
    alpha_thumbnail_url
    Type
    string
    Description

    L'URL de téléchargement pour une version de thumbnail_url avec un arrière-plan transparent (RGBA). Présent uniquement lorsque vous avez créé la tâche avec alpha_thumbnail: true et que Meshy a rendu l'aperçu transparent.

  • Name
    progress
    Type
    integer
    Description

    La part de la tâche déjà effectuée, en pourcentage. Elle est à 0 tant que la tâche n'a pas démarré et à 100 quand elle réussit.

  • Name
    started_at
    Type
    timestamp
    Description

    L'heure de démarrage de la tâche, en millisecondes Unix. Elle est à 0 tant que la tâche n'a pas démarré.

  • Name
    created_at
    Type
    timestamp
    Description

    L'heure de création de la tâche, en millisecondes Unix.

  • Name
    expires_at
    Type
    timestamp
    Description

    L'heure à laquelle les résultats de la tâche expirent, en millisecondes Unix.

  • Name
    finished_at
    Type
    timestamp
    Description

    L'heure de fin de la tâche, en millisecondes Unix. Elle est à 0 tant que la tâche n'est pas terminée.

  • Name
    status
    Type
    string
    Description

    Le statut de la tâche, l'un de PENDING, IN_PROGRESS, SUCCEEDED, FAILED, ou CANCELED.

  • Name
    texture_urls
    Type
    array
    Description

    Les URL de téléchargement pour les textures générées, sous forme d'un tableau d'objets. Le tableau ne contient généralement qu'un seul objet. Chaque objet comporte les champs suivants :

    • Name
      base_color
      Type
      string
      Description

      L'URL de téléchargement pour la carte de couleur de base.

    • Name
      metallic
      Type
      string
      Description

      L'URL de téléchargement pour la carte métallique. Meshy omet ce champ lorsque vous créez la tâche avec enable_pbr: false.

    • Name
      normal
      Type
      string
      Description

      L'URL de téléchargement pour la normal map. Meshy omet ce champ lorsque vous créez la tâche avec enable_pbr: false.

    • Name
      roughness
      Type
      string
      Description

      L'URL de téléchargement pour la carte de rugosité. Meshy omet ce champ lorsque vous créez la tâche avec enable_pbr: false.

    • Name
      emission
      Type
      string
      Description

      L'URL de téléchargement pour la carte d'émission. Meshy omet ce champ lorsque vous créez la tâche avec l'un des éléments suivants :

      • enable_pbr: false
      • un ai_model valant meshy-6-lite, meshy-7, ou latest
      • texture_resolution: 8k
  • Name
    preceding_tasks
    Type
    integer
    Description

    Le nombre de tâches précédant celle-ci dans la file d'attente. Présent uniquement tant que la tâche est PENDING ; ce champ est omis lorsque la valeur est 0.

  • Name
    task_error
    Type
    object
    Description

    Les détails de l'erreur en cas d'échec de la tâche. Voir Erreurs.

  • Name
    consumed_credits
    Type
    integer
    Description

    Le nombre de crédits utilisés par la tâche. Présent lorsque le statut est PENDING, IN_PROGRESS, ou SUCCEEDED. Il est à 0 pour une tâche FAILED, car Meshy rembourse les crédits en cas d'échec d'une tâche.