API Multi-image en 3D

Générez un modèle 3D à partir d'une à quatre images du même objet, prises sous différents angles.

POST/openapi/v1/multi-image-to-3d

Créer une tâche Multi-image en 3D

Crée une tâche Multi-image en 3D. La tâche s'exécute en arrière-plan. Pour connaître la durée habituelle d'une tâche, consultez Délais de traitement. Pour connaître les champs d'une tâche, consultez L'objet de tâche Multi-image en 3D.

Request

POST

/openapi/v1/multi-image-to-3d

# Simple request
curl https://api.meshy.ai/openapi/v1/multi-image-to-3d \
  -X POST \
  -H "Authorization: Bearer ${YOUR_API_KEY}" \
  -H 'Content-Type: application/json' \
  -d '{
    "image_urls": [
      "<your publicly accessible image url or base64-encoded data URI>",
      "<your second publicly accessible image url or base64-encoded data URI>"
    ]
  }'

# With Ultra 2K geometry, PBR texturing, and GLB format
curl https://api.meshy.ai/openapi/v1/multi-image-to-3d \
  -X POST \
  -H "Authorization: Bearer ${YOUR_API_KEY}" \
  -H 'Content-Type: application/json' \
  -d '{
    "image_urls": [
      "<your publicly accessible image url or base64-encoded data URI>",
      "<your second publicly accessible image url or base64-encoded data URI>"
    ],
    "ai_model": "meshy-7.1",
    "geometry_resolution": "2k",
    "should_texture": true,
    "enable_pbr": true,
    "target_formats": ["glb"]
  }'

Response

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

Paramètres

Name
input_task_id
Type
string
Requis
Description
Obligatoire sauf si vous envoyez image_urls. L'ID d'une tâche Texte en image ou Image en image, y compris une tâche multi-vue. Meshy utilise ses une à quatre images comme entrée. La tâche doit être une tâche que vous avez créée avec l'API et dont le statut est SUCCEEDED.

Name
image_urls
Type
array
Requis
Description
Obligatoire sauf si vous envoyez input_task_id. Une à quatre images, chacune sous forme d'URL publique ou de Data URI, comme data:image/jpeg;base64,<vos données d'image encodées en base64>. Si vous envoyez les deux, Meshy utilise input_task_id.
Chaque image doit être un fichier .jpg, .jpeg, .png ou .webp d'au plus 20 Mo. Plus de quatre images renvoie 400.
Pour de meilleurs résultats, les images doivent montrer le même objet sous différents angles. Avec meshy-7.1 ou latest, Meshy utilise la première image comme vue de face, et l'ordre des autres n'a pas d'importance.

Name
ai_model
Type
string
défaut latest
Description
Le modèle d'IA qui génère le modèle 3D.
Valeurs disponibles :
- latest : Meshy 7.1
- meshy-7.1
- meshy-6
- meshy-6-lite
- meshy-7 : obsolète, envoyez meshy-7.1 à la place
Name
geometry_resolution
Type
string
défaut standard
Description
Le niveau de détail géométrique à générer.
Valeurs disponibles :
- standard
- 2k : exécute la passe Ultra à 2048³. Nécessite meshy-7.1, latest, ou le meshy-7 obsolète.
Name
ultra_mode
Type
boolean
⚠ obsolète
défaut false
Description
Envoyez geometry_resolution à la place. ultra_mode: true équivaut à geometry_resolution: "2k".
Name
should_texture
Type
boolean
défaut true
Description
Indique s'il faut générer des textures. true renvoie un modèle texturé, et false saute l'étape de texturation et renvoie un maillage sans textures.

S'applique uniquement quand should_texture = true

Name
enable_pbr
Type
boolean
défaut false
Description
Indique s'il faut aussi générer des cartes métallique, de rugosité et normale, en plus de la couleur de base. Avec meshy-6, Meshy génère aussi une carte d'émission, sauf à texture_resolution: 8k. Les autres modèles ne génèrent pas de carte d'émission.
Name
texture_resolution
Type
string
défaut 2k
Description
La taille de la texture de couleur de base. Une taille plus grande capture plus de détails de surface.
Valeurs disponibles :
- 2k : 2048×2048
- 4k : 4096×4096
- 8k : 8192×8192
4k et 8k nécessitent meshy-6, meshy-7.1, ou latest. À 8k, Meshy ne génère pas de carte d'émission.
Name
hd_texture
Type
boolean
⚠ obsolète
défaut false
Description
Envoyez texture_resolution à la place. hd_texture: true équivaut à texture_resolution: "4k". Si vous envoyez les deux, Meshy utilise texture_resolution.
Name
texture_prompt
Type
string
Description
Texte qui guide la texture, jusqu'à 800 caractères. Un texte plus long renvoie 400.
Name
texture_image_url
Type
string
Description
Une image 2D qui guide la texture, sous forme d'URL publique ou de Data URI, comme data:image/jpeg;base64,<vos données d'image encodées en base64>. L'image doit être un fichier .jpg, .jpeg, .png ou .webp d'au plus 20 Mo.
Si vous envoyez à la fois texture_image_url et texture_prompt, Meshy utilise texture_prompt.
La texture peut ne pas donner un bon résultat lorsque la forme dans l'image diffère beaucoup du modèle 3D.
Name
texture_image_urls
Type
string[]
Description
Une à quatre images de l'objet sous différentes vues qui guident la texture. Meshy utilise la première image comme vue de face. L'ordre des autres vues (gauche, arrière, droite) n'a pas d'importance.
Chaque image suit les mêmes règles que texture_image_url. C'est une URL publique ou un Data URI, au format .jpg, .jpeg, .png ou .webp, d'au plus 20 Mo.
Ces images ne guident que la texture et ne dépendent pas de image_urls. Les deux listes peuvent contenir des images différentes et des nombres d'images différents.
texture_image_urls nécessite meshy-7.1, latest, ou le meshy-7 obsolète. Vous ne pouvez pas l'envoyer avec texture_image_url ou texture_prompt.

Name
should_remesh
Type
boolean
défaut true (meshy-6-lite), false (other models)
Description
Indique s'il faut remailler le modèle après la génération. Pour le modèle 3D de la plus haute qualité, réglez-le sur false.

S'applique uniquement quand should_remesh = true

Name
topology
Type
string
défaut triangle
Description
Le type de face du modèle remaillé.
Valeurs disponibles :
- quad : un maillage à dominance de quadrilatères
- triangle : un maillage triangulaire décimé
Name
target_polycount
Type
integer
défaut 30000
Description
Le nombre de faces visé, de 100 à 300000. Le résultat peut différer de la cible, selon la géométrie du modèle. Une valeur hors de la plage renvoie 400.
Name
decimation_mode
Type
integer
Description
Nombre de faces adaptatif, par niveau. Lorsque vous le définissez, Meshy ignore target_polycount.
Valeurs disponibles :
- 1 : ultra
- 2 : élevé
- 3 : moyen
- 4 : faible
Name
save_pre_remeshed_model
Type
boolean
défaut false
Description
Indique s'il faut aussi enregistrer le GLB d'avant le remaillage, renvoyé dans model_urls.pre_remeshed_glb.

Name
symmetry_mode
Type
string
⚠ obsolète
défaut auto
Description
Laissez-le de côté. Il n'affecte pas le résultat.
Valeurs disponibles :
- off : aucune symétrie
- auto : symétrie basée sur la géométrie d'entrée
- on : symétrie forcée
Name
pose_mode
Type
string
défaut ""
Description
La pose du modèle généré.
Valeurs disponibles :
- a-pose : une pose en A
- t-pose : une pose en T
- "" (chaîne vide) : aucune pose spécifique
Name
is_a_t_pose
Type
boolean
⚠ obsolète
défaut false
Description
Envoyez pose_mode à la place. Indique s'il faut générer le modèle en pose A ou T.
Name
image_enhancement
Type
boolean
défaut true
Description
Indique s'il faut optimiser les images d'entrée avant la génération. false conserve l'apparence exacte des images d'entrée, sans traitement stylistique. Pris en charge uniquement avec meshy-6, meshy-7.1, ou latest. L'envoyer avec meshy-6-lite renvoie 400.
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 plus propre fonctionne mieux sous votre propre éclairage. Seul meshy-6 l'utilise. meshy-7, meshy-7.1 et latest l'acceptent et l'ignorent. À texture_resolution: 8k, Meshy supprime toujours l'éclairage. L'envoyer avec meshy-6-lite renvoie 400.
Name
moderation
Type
boolean
défaut false
Description
Indique s'il faut filtrer les entrées à la recherche de contenu nuisible. Meshy filtre chaque image d'entrée, texture_image_url ou chaque image dans texture_image_urls, et le texte dans texture_prompt. Si Meshy détecte un contenu nuisible, la requête renvoie 400 et Meshy ne crée pas de tâche.
Name
target_formats
Type
string[]
Description
Les formats de fichier 3D à générer. Meshy génère et renvoie uniquement les formats que vous listez, ce qui peut raccourcir la tâche.
Valeurs disponibles :
- glb
- obj
- fbx
- stl
- usdz
- 3mf
Si vous le laissez de côté, Meshy génère tous les formats sauf 3mf. Meshy génère 3mf uniquement lorsque vous le listez.
Name
auto_size
Type
boolean
défaut false
Description
Indique s'il faut estimer la hauteur réelle de l'objet avec la vision par IA et redimensionner le modèle en conséquence. Meshy place l'origine en bas sauf si vous définissez origin_at.

S'applique uniquement quand auto_size = true

Name
origin_at
Type
string
défaut bottom
Description
Où placer l'origine du modèle, bottom ou center.

Name
alpha_thumbnail
Type
boolean
défaut false
Description
Indique s'il faut aussi générer un aperçu avec un arrière-plan transparent (RGBA), renvoyé dans alpha_thumbnail_url lorsque vous récupérez la tâche. thumbnail_url ne change pas.
Name
multi_view_thumbnails
Type
boolean
défaut false
Description
Indique s'il faut aussi générer des aperçus avant, droite, arrière et gauche, renvoyés dans thumbnail_urls lorsque vous récupérez la tâche. thumbnail_url ne change pas et montre toujours la vue de face. Cela ajoute environ 5 secondes à la tâche.

Retours

Le champ result de la réponse contient l'ID de la nouvelle tâche Multi-image en 3D.

Modes d'échec

Name
400 - Bad Request
Description
La requête ne peut pas s'exécuter. Le message d'erreur indique quel problème a été détecté. Par exemple :
- Paramètre manquant : Ni image_urls ni input_task_id n'ont été envoyés.
- Tâche d'entrée invalide : input_task_id n'est pas une tâche Texte en image ou Image en image avec le statut SUCCEEDED, ni une tâche multi-vue.
- Nombre d'images invalide : image_urls ou texture_image_urls ne contient pas entre 1 et 4 images.
- Format d'image invalide : Une image dans image_urls n'est pas dans un format pris en charge.
- Entrées de texture en conflit : texture_image_urls a été envoyé avec texture_image_url, avec texture_prompt, ou avec should_texture: false.
- Modèle non pris en charge pour la texture multi-vue : texture_image_urls a été envoyé avec meshy-6 ou meshy-6-lite.
- URL inaccessible : Meshy ne peut pas télécharger une image dans image_urls ou texture_image_urls.
- Image trop volumineuse : Une image dans image_urls, texture_image_url, ou texture_image_urls dépasse 20 Mo.
- Résolution non prise en charge pour une entrée multi-image : geometry_resolution est "4k", ce que ce point de terminaison ne prend pas en charge. Utilisez 2k ou standard.
- Modèle non pris en charge pour les options d'image : image_enhancement ou remove_lighting a été envoyé avec ai_model: "meshy-6-lite".
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 ne dispose pas de suffisamment 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. Améliorez votre plan dans vos paramètres d'abonnement, puis réessayez.
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/multi-image-to-3d/:id

Récupérer une tâche Multi-image en 3D

Renvoie une tâche Multi-image en 3D par son ID.

Request

GET

/openapi/v1/multi-image-to-3d/018a210d-8ba4-705c-b111-1f1776f7f578

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

Response

{
  "id": "018a210d-8ba4-705c-b111-1f1776f7f578",
  "type": "multi-image-to-3d",
  "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=***",
    "stl": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.stl?Expires=***",
    "pre_remeshed_glb": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/pre_remeshed_model.glb?Expires=***"
  },
  "thumbnail_url": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/preview.png?Expires=***",
  "thumbnail_urls": {
    "front": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/preview_front.png?Expires=***",
    "right": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/preview_right.png?Expires=***",
    "back": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/preview_back.png?Expires=***",
    "left": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/preview_left.png?Expires=***"
  },
  "texture_prompt": "",
  "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"
    }
  ],
  "preceding_tasks": 0,
  "task_error": {

    "message": ""

  },

  "consumed_credits": 30
}

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 Multi-image en 3D.

DELETE/openapi/v1/multi-image-to-3d/:id

Supprimer une tâche Multi-image en 3D

Supprime définitivement une tâche Multi-image en 3D, y compris ses modèles et ses données. Vous ne pouvez pas annuler une suppression.

Request

DELETE

/openapi/v1/multi-image-to-3d/018a210d-8ba4-705c-b111-1f1776f7f578

curl --request DELETE \
  --url https://api.meshy.ai/openapi/v1/multi-image-to-3d/018a210d-8ba4-705c-b111-1f1776f7f578 \
  -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 ferait perdre à 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/multi-image-to-3d

Lister les tâches Multi-image en 3D

Renvoie une liste de vos tâches Multi-image en 3D.

Request

GET

/openapi/v1/multi-image-to-3d

curl https://api.meshy.ai/openapi/v1/multi-image-to-3d?page_size=10 \
-H "Authorization: Bearer ${YOUR_API_KEY}"

Response

[
  {
    "id": "018a210d-8ba4-705c-b111-1f1776f7f578",
    "type": "multi-image-to-3d",
    "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=***",
      "pre_remeshed_glb": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/pre_remeshed_model.glb?Expires=***"
    },
    "thumbnail_url": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/preview.png?Expires=***",
    "thumbnail_urls": {
      "front": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/preview_front.png?Expires=***",
      "right": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/preview_right.png?Expires=***",
      "back": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/preview_back.png?Expires=***",
      "left": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/preview_left.png?Expires=***"
    },
    "texture_prompt": "",
    "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"
      }
    ],
    "preceding_tasks": 0,
    "task_error": {

      "message": ""

    },

    "consumed_credits": 30
  }
]

Paramètres

Name
page_num
Type
integer
défaut 1
Description
Le numéro de page à renvoyer, à partir de 1.
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 de tâche Multi-image en 3D.

GET/openapi/v1/multi-image-to-3d/:id/stream

Diffuser les mises à jour d'une tâche Multi-image en 3D

Diffuse les mises à jour d'une tâche Multi-image en 3D sous forme d'événements envoyés par le serveur (SSE).

Request

GET

/openapi/v1/multi-image-to-3d/018a210d-8ba4-705c-b111-1f1776f7f578/stream

curl -N https://api.meshy.ai/openapi/v1/multi-image-to-3d/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",
  "type": "multi-image-to-3d",
  "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=***",
  "stl": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.stl?Expires=***",
  "pre_remeshed_glb": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/pre_remeshed_model.glb?Expires=***"
  },
  "thumbnail_url": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/preview.png?Expires=***",
  "thumbnail_urls": {
  "front": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/preview_front.png?Expires=***",
  "right": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/preview_right.png?Expires=***",
  "back": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/preview_back.png?Expires=***",
  "left": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/preview_left.png?Expires=***"
  },
  "texture_prompt": "",
  "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"
    }
  ],
  "preceding_tasks": 0,
  "task_error": {

    "message": ""

  },

  "consumed_credits": 30
}

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 Multi-image en 3D sous forme d'événements envoyés par le serveur.

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

L'objet tâche Multi-image en 3D

Un objet tâche Multi-image en 3D décrit une génération d'un modèle 3D à partir d'une à quatre images d'un objet. Il contient le statut, la progression et les fichiers du modèle lorsque la tâche réussit.

Propriétés

Example Multi-Image to 3D Task Object

{
  "id": "018a210d-8ba4-705c-b111-1f1776f7f578",
  "type": "multi-image-to-3d",
  "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=***",
    "stl": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.stl?Expires=***",
    "pre_remeshed_glb": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/pre_remeshed_model.glb?Expires=***"
  },
  "thumbnail_url": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/preview.png?Expires=***",
  "thumbnail_urls": {
    "front": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/preview_front.png?Expires=***",
    "right": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/preview_right.png?Expires=***",
    "back": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/preview_back.png?Expires=***",
    "left": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/preview_left.png?Expires=***"
  },
  "texture_prompt": "",
  "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"
    }
  ],
  "preceding_tasks": 0,
  "task_error": {

    "message": ""

  },

  "consumed_credits": 30
}

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 la tâche, toujours multi-image-to-3d.
Name
model_urls
Type
object
Description
Les URL de téléchargement du modèle 3D généré, une par format de fichier. Un format que la tâche n'a pas généré n'a pas de clé, plutôt qu'une chaîne vide.
- 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, renvoyé avec le fichier OBJ lorsque le modèle a 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
  pre_remeshed_glb
  Type
  string
  Description
  Le fichier GLB d'avant le remaillage. Présent uniquement lorsque vous avez créé la tâche avec à la fois should_remesh: true et save_pre_remeshed_model: true.
Name
thumbnail_url
Type
string
Description
L'URL de téléchargement d'une image d'aperçu du modèle. Elle est identique à thumbnail_urls.front lorsque ce champ est présent.
Name
alpha_thumbnail_url
Type
string
Description
L'URL de téléchargement d'une version de thumbnail_url avec un fond 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
thumbnail_urls
Type
object
Description
Les URL de téléchargement des aperçus du modèle 3D sous quatre angles. Chacune est une URL signée vers un PNG 512×512, rendu avec les mêmes matériaux et le même éclairage que thumbnail_url. Vous pouvez les utiliser pour prévisualiser le modèle sous plusieurs angles sans télécharger le GLB.
Présent uniquement lorsque vous avez créé la tâche avec multi_view_thumbnails: true et que la tâche a atteint SUCCEEDED. Une tâche créée sans multi_view_thumbnails: true n'a pas ce champ.
- Name
  front
  Type
  string
  Description
  La vue de face, à 0° autour de l'axe vertical. Elle correspond à thumbnail_url.
- Name
  right
  Type
  string
  Description
  La vue de droite, à 90°.
- Name
  back
  Type
  string
  Description
  La vue arrière, à 180°.
- Name
  left
  Type
  string
  Description
  La vue de gauche, à 270°.
Name
texture_prompt
Type
string
Description
Le prompt textuel qui a guidé la texture.
Name
texture_image_urls
Type
string[]
Description
Les URL de téléchargement des images de référence de texture avec lesquelles vous avez créé la tâche, dans l'ordre où vous les avez envoyées. Présent uniquement lorsque vous avez créé la tâche avec texture_image_urls.
Name
ultra_mode
Type
boolean
⚠ obsolète
Description
Utilisez geometry_resolution à la place.
Name
geometry_resolution
Type
string
Description
Le palier Ultra sur lequel la tâche s'est exécutée, à savoir 2k. Une tâche standard n'a pas ce champ.
Name
progress
Type
integer
Description
La part de la tâche achevée, en pourcentage. Elle est 0 jusqu'à ce que la tâche démarre et 100 lorsqu'elle réussit.
Name
started_at
Type
timestamp
Description
L'heure de démarrage de la tâche, en millisecondes Unix. Elle est 0 jusqu'à ce que la tâche démarre.
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 d'expiration des résultats de la tâche, en millisecondes Unix.
Name
finished_at
Type
timestamp
Description
L'heure de fin de la tâche, en millisecondes Unix. Elle est 0 jusqu'à ce que la tâche se termine.
Name
status
Type
string
Description
Le statut de la tâche, l'un des suivants : PENDING, IN_PROGRESS, SUCCEEDED, FAILED, ou CANCELED.
Name
texture_urls
Type
array
Description
Les URL de téléchargement des maps de texture générées par la tâche, sous forme de tableau d'objets. Il contient généralement un seul objet. Chaque objet possède les champs suivants :
- Name
  base_color
  Type
  string
  Description
  La map de couleur de base.
- Name
  metallic
  Type
  string
  Description
  La map métallique. Non incluse lorsque vous avez créé la tâche avec enable_pbr: false.
- Name
  normal
  Type
  string
  Description
  La normal map. Non incluse lorsque vous avez créé la tâche avec enable_pbr: false.
- Name
  roughness
  Type
  string
  Description
  La map de rugosité. Non incluse lorsque vous avez créé la tâche avec enable_pbr: false.
- Name
  emission
  Type
  string
  Description
  La map d'émission. Incluse uniquement lorsque vous avez créé la tâche avec ai_model: meshy-6 et enable_pbr: true, à une texture_resolution de 2k ou 4k.
Name
preceding_tasks
Type
integer
Description
Le nombre de tâches précédant celle-ci dans la file d'attente. La valeur n'est significative que tant que la tâche est PENDING.
Name
task_error
Type
object
Description
Les détails de l'erreur lorsque la tâche échoue. 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 lorsqu'une tâche échoue.