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

Cycle de vie d'une tâche

Découvrez comment une tâche passe de la requête au résultat, le temps que cela prend habituellement, et combien de temps votre code doit attendre le résultat.


Déroulement d'une tâche

Une requête de création renvoie un identifiant de tâche sans attendre que la tâche s'exécute. La tâche s'exécute ensuite en arrière-plan, et vous pouvez la suivre de trois façons : interroger son point de terminaison GET, ouvrir son point de terminaison de flux, ou recevoir un webhook.

Une requête de création démarre une tâche en PENDING. Un worker la prend en charge et elle passe en IN_PROGRESS, état dans lequel elle passe la majeure partie de son temps. Elle se termine en SUCCEEDED ou FAILED, et un statut final ne change jamais.
Requête de création
PENDING
En attente dans la file
IN_PROGRESS
Génération du résultat
SUCCEEDED
Téléchargez le résultat
FAILED
Crédits remboursés

La tâche enregistre chaque étape dans ses champs created_at, started_at et finished_at.

Le tableau suivant indique ce que votre code doit faire à chaque statut.

StatutCe que votre code doit faire
PENDINGContinuez d'attendre.
IN_PROGRESSSuivez progress : le pourcentage du travail effectué, de 0 à 100.
SUCCEEDEDTéléchargez le résultat. Meshy conserve les fichiers pendant une durée limitée. Voir Conservation des ressources.
FAILEDLisez task_error, puis corrigez l'entrée ou créez une nouvelle tâche. Voir Erreurs.
CANCELEDArrêtez d'attendre. La tâche ne produira pas de résultat. Seules les tâches Creative Lab utilisent ce statut.

SUCCEEDED, FAILED et CANCELED sont des statuts finaux. Une fois qu'une tâche atteint l'un d'eux, son statut ne change plus jamais.

Vu de votre code, cela ressemble à ceci :

Créez une tâche, puis interrogez-la jusqu'à ce qu'elle se termine.
  1. Requête: POST/image-to-3d

  2. Réponse: 202{ "result": "<task_id>" }tâche créée

  3. Répétez toutes les quelques secondes
    1. Requête: GET/image-to-3d/<task_id>

    2. Réponse: 200{ "status": "IN_PROGRESS","progress": 45 }Retry-After: 5

  4. Requête: GET/image-to-3d/<task_id>

  5. Réponse: 200{ "status": "SUCCEEDED","model_urls": { "glb": "…" } }

Si votre application arrête d'attendre, la tâche continue de s'exécuter. Faites un GET plus tard avec le même identifiant de tâche.

Temps de traitement

Les tableaux suivants présentent les temps médians observés sur le trafic de production de l'API en septembre 2026.

Un temps court entre la création de la tâche et le statut final. Il correspond presque entièrement au traitement, car une tâche reste généralement en PENDING pendant seulement quelques secondes. Lorsque la file d'attente est chargée, les tâches peuvent attendre plus longtemps avant de démarrer, et les tâches des forfaits avec une priorité plus élevée démarrent généralement plus tôt.

Les durées inférieures à 2 minutes sont exprimées en secondes (s), et les durées plus longues en minutes (min). « Non pris en charge » signifie que l'API n'offre pas cette option avec ce modèle.

Génération 3D

APIConfigurationmeshy-7.1 (latest)meshy-6meshy-6-litemeshy-t2
Texte en 3D (Preview)Maillage seul75 s90 s45 s10 s
Image en 3DMaillage seul75 s90 s40 s4 s
Maillage avec textures 2K2 min3 min75 s60 s
Maillage avec textures 4K2,5 min3,5 minNon pris en charge80 s
Maillage avec textures 8K3,5 min4 minNon pris en charge2,5 min
Multi-image en 3DMaillage seul65 s2 min30 sNon pris en charge
Maillage avec textures 2K2,5 min3,5 min85 sNon pris en charge
Maillage avec textures 4K3 min4 minNon pris en chargeNon pris en charge
Maillage avec textures 8K3,5 min4,5 minNon pris en chargeNon pris en charge

Pour Image en 3D et Multi-image en 3D, « Maillage seul » signifie should_texture: false. Ces options et entrées modifient le temps :

  • Les cartes PBR (enable_pbr) ajoutent 30 à 60 secondes.
  • La géométrie ultra (geometry_resolution: "2k" ou "4k") ajoute jusqu'à 1 minute.
  • Avec les mêmes paramètres, des images d'entrée plus complexes prennent plus de temps.

Texturation

APIRésolution de textureTemps typique
Texte en 3D (Refine)2K ou 4K80 s
8K3,5 min
Retexturisation2K55 s
4K90 s
8K2,5 min

Génération d'images

APInano-banananano-banana-2nano-banana-proModèles GPT Image
Texte en image20 s15 s25 s20 à 35 s
Image en image40 s20 s30 s20 à 40 s

Rigging et Animation

APIConfigurationTemps typique
Auto-RiggingRigging automatique40 s
AnimationPar requête15 s
Texte en mouvementmode prime15 s
mode swift10 s

Post-traitement

APITemps typique
Remaillage2 min
Dépliage UV35 s
Convertir7 s
Redimensionner15 s

Impression 3D

APIConfigurationTemps typique
Analyser l'imprimabilitéVérifications du maillage uniquement1 s
Vérifications du maillage et des parois fines10 s
Multi-ColorPar requête30 s
Réparer l'imprimabilitéRéparation du maillage uniquement10 s
Vérification des parois fines, parois conservées20 s
Vérification des parois fines, parois épaissies100 s
Auto SplitParties en couleurs unies70 s
Parties texturées (keep_texture: true)170 s

Sur la v2, Réparer l'imprimabilité et Analyser l'imprimabilité exécutent toujours la vérification des parois fines. Sur la v1, elles l'exécutent lorsque vous envoyez un type d'imprimante ou une taille d'impression.


Combien de temps attendre

La tâche continue de s'exécuter même si votre code arrête d'attendre. Si votre requête expire, si votre connexion se coupe, ou si votre flux se ferme, la tâche n'échoue pas et n'est pas annulée.

  • Attendez au moins 60 minutes, comptées à partir du created_at de la tâche, avant d'arrêter d'attendre. Si vous arrêtez plus tôt, vous risquez de manquer une tâche qui réussit plus tard. Cela se produit surtout pendant les périodes chargées.
  • Conservez l'identifiant de la tâche. Vous pouvez récupérer la tâche à tout moment. Si elle n'est toujours pas finale après 60 minutes, vérifiez-la à nouveau plus tard. Si elle reste dans cet état, contactez le support.
  • Seul FAILED signifie que la tâche a échoué. Meshy rembourse automatiquement les tâches échouées.

Utilisez ces valeurs dans votre code :

ParamètreValeur recommandée
Timeout de la requête de création (POST)60 secondes
Timeout de la requête de création (POST) avec un fichier model_url de plus de 100 Mo120 secondes. Meshy télécharge le fichier avant de répondre.
Timeout de la requête de statut (GET)30 secondes
Intervalle d'interrogationL'en-tête Retry-After, ou 5 secondes si elle est absente. Les interrogations comptent dans votre limite de débit.
Requête de statut échouée (timeout, 429 ou 5xx)Réessayez à la prochaine interrogation. Cela ne signifie pas que la tâche a échoué.
Attente totale par tâcheAu moins 60 minutes à partir de created_at. Ne redémarrez pas ce compteur lorsque vous reconnectez un flux.
FluxUn flux peut se fermer avant que la tâche ne se termine. S'il se ferme sans statut final, reconnectez-vous ou passez à l'interrogation.

Pour de nombreuses tâches à la fois, utilisez les webhooks plutôt que d'interroger chacune d'elles. Si l'événement final d'une tâche n'est pas arrivé après environ deux fois son temps typique, récupérez la tâche depuis son point de terminaison GET.