Creative Lab — API d'aimant de frigo

Transformez vos photos en aimants de frigo personnalisés — un relief colorisé en rectangle arrondi avec un dos magnétique plat, dimensionné pour le frigo — en deux étapes : prototype génère une image conceptuelle colorisée à partir de votre photo d'entrée, puis construction transforme cette image conceptuelle en un modèle 3D en relief. Les deux étapes sont liées via input_task_id.

POST /openapi/creative-lab/fridge-magnet/v1/prototype
POST /openapi/creative-lab/fridge-magnet/v1/build

POST/openapi/creative-lab/fridge-magnet/v1/prototype

Créer une tâche de prototype d'aimant de frigo

Générer une image conceptuelle colorisée à partir de la photo source. L'ID de tâche retourné est ce que vous passez comme input_task_id au point de terminaison de construction. Référez-vous à L'objet de la tâche de prototype d'aimant de frigo pour la forme de la réponse.

Paramètres

Name
image_url
Type
string
Requis
Description
Photo source pour que Meshy la colorise en une image conceptuelle prête pour un aimant de frigo. Nous supportons actuellement les formats .jpg, .jpeg, .png, et .webp.
Il y a deux façons de fournir l'image :
- URL accessible publiquement : Une URL accessible depuis l'internet public.
- Data URI : Un Data URI encodé en base64 de l'image. Exemple de Data URI : data:image/jpeg;base64,<your base64-encoded image data>.
Name
name
Type
string
Description
Nom de tâche optionnel à des fins d'affichage. Maximum 100 caractères.
Name
remove_background
Type
boolean
défaut false
Description
Lorsqu'il est réglé sur true, l'image prototype est retournée en tant que PNG RGBA transparent avec le fond supprimé, vous permettant de composer le sujet sur n'importe quel fond.
Cela ne contrôle que l'image que ce point de terminaison retourne. C'est séparé de l'option de construction du même nom (par défaut true), qui contrôle la suppression de fond avant le relief.

Retours

La propriété result de la réponse contient l'ID de tâche de la nouvelle tâche de prototype d'aimant de frigo créée. Interrogez le point de terminaison Obtenir une tâche ou abonnez-vous au flux jusqu'à ce que la tâche atteigne SUCCEEDED, puis passez cet ID au point de terminaison de construction comme input_task_id.

Modes d'échec

Name
400 - Bad Request
Description
La requête était inacceptable. Causes courantes :
- Paramètre manquant : image_url est requis.
- Format d'image invalide : Le image_url fourni n'est pas un format supporté (.jpg, .jpeg, .png, .webp).
- Dimensions de l'image hors limites : L'image est trop petite, dépasse la taille maximale de fichier, ou dépasse le nombre maximal de pixels.
- URL inaccessible : Le image_url n'a pas pu être téléchargé (404 ou timeout).
- Data URI invalide : La chaîne base64 est mal formée.
- Contenu signalé : L'image d'entrée a été signalée par la moderation NSFW ou de propriété intellectuelle.
Name
401 - Unauthorized
Description
L'authentification a échoué. Veuillez vérifier votre clé API.
Name
402 - Payment Required
Description
Crédits insuffisants pour effectuer cette tâche.
Name
429 - Too Many Requests
Description
Vous avez dépassé votre limite de débit.

Requête

POST

/openapi/creative-lab/fridge-magnet/v1/prototype

# Stage 1: generate a colorized fridge magnet concept image
curl https://api.meshy.ai/openapi/creative-lab/fridge-magnet/v1/prototype \
  -X POST \
  -H "Authorization: Bearer ${YOUR_API_KEY}" \
  -H 'Content-Type: application/json' \
  -d '{
    "image_url": "<your publicly accessible image url or base64-encoded data URI>"
  }'

Réponse

{
  "result": "01a3d8f1-8c2e-7d04-b223-3f3776a1c8c9"
}

Exemple de prototype

Commencez avec une photo source, puis générez l'image prototype utilisée par l'étape de construction de l'aimant de frigo.

Photo de paysage source utilisée comme entrée pour l'aimant de frigo Creative Lab — Entrée du prototype

Sortie prototype d'aimant de frigo Creative Lab générée à partir de la photo source — Sortie du prototype

POST/openapi/creative-lab/fridge-magnet/v1/build

Créer une Tâche de Construction d'Aimant de Frigo

Générer l'aimant de frigo final imprimable en 3D à partir d'une tâche de prototype réussie. La construction exécute un pipeline de relief de carte de profondeur sur l'image conceptuelle colorisée du prototype et livre un seul artefact de maillage dans le format que vous demandez. Référez-vous à L'Objet de Tâche de Construction d'Aimant de Frigo pour la forme de la réponse.

Paramètres

Name
input_task_id
Type
string
Requis
Description
L'ID de tâche d'un prototype créé via ce même point de terminaison OpenAPI. Le prototype doit avoir été créé avec la même clé API, doit avoir atteint SUCCEEDED, et doit avoir produit exactement une image candidate.
Les tâches de prototype créées via l'application web ne sont pas acceptées — le point de terminaison de construction accepte uniquement les tâches de prototype produites par POST /openapi/creative-lab/fridge-magnet/v1/prototype et refuse toute autre source avec 404.
Name
name
Type
string
Description
Nom de tâche optionnel à des fins d'affichage. Maximum 100 caractères.

`options`

Paramètres de réglage optionnels pour la géométrie de relief. Chaque champ a une valeur par défaut raisonnable — envoyez uniquement ceux que vous souhaitez remplacer.

Name
badge_shape
Type
string
défaut rounded-rect
Description
Silhouette de contour de l'aimant de frigo. Valeurs disponibles :
- circle
- rounded-rect (par défaut)
- hexagon
- shield
- star
Name
size_mm
Type
number
défaut 60
Description
Longueur du bord du carré englobant de l'aimant de frigo, en millimètres. Plage : (0, 400].
Name
relief_height_mm
Type
number
défaut 3.3
Description
Hauteur maximale du relief au-dessus de la base, en millimètres. Plage : [0, 20].
Name
relief_offset_mm
Type
number
défaut 0
Description
Décalage vertical appliqué au relief avant extrusion, en millimètres. Plage : [0, 20].
Name
base_thickness_mm
Type
number
défaut 2.0
Description
Épaisseur de la plaque de base plate derrière le relief, en millimètres. L'épaisseur par défaut de l'aimant de frigo est de 2 mm — cela donne à l'aimant suffisamment de corps pour adhérer au frigo sans que le relief ne paraisse fragile. Plage : [0, 20].
Name
has_closed_back
Type
boolean
défaut true
Description
Si l'arrière de l'aimant de frigo est scellé comme une surface fermée (le côté auquel vous collez l'aimant). Réglez sur false pour une coque ouverte.
Name
relief_curve
Type
string
défaut linear
Description
Courbe de transfert mappant les valeurs de la carte de profondeur à la hauteur du relief. Valeurs disponibles :
- linear (par défaut)
- gamma
- s-curve
Name
curve_param
Type
number
défaut 1.0
Description
Paramètre de forme pour la courbe de transfert (significatif uniquement lorsque relief_curve est gamma). Plage : (0, 10].
Name
invert_depth
Type
boolean
défaut false
Description
Inverser l'interprétation de la carte de profondeur pour que les régions plus sombres deviennent des reliefs plus élevés.
Name
smoothing
Type
number
défaut 0.24
Description
Force de lissage appliquée à la carte de profondeur avant extraction du relief. Plage : [0, 10].
Name
relief_scale
Type
number
défaut 1.0
Description
Multiplicateur d'échelle verticale appliqué en plus de relief_height_mm. Plage : (0, 10].
Name
depth_threshold
Type
number
défaut 0.1
Description
Seuil passe-bas pour les valeurs de la carte de profondeur ; tout ce qui est en dessous est limité à zéro. Plage : [0, 1].
Name
remove_background
Type
boolean
défaut true
Description
Supprimer automatiquement l'arrière-plan de l'image conceptuelle du prototype avant le relief.
Séparé du paramètre prototype du même nom (par défaut false), qui contrôle si l'image prototype elle-même est retournée avec transparence.
Name
export_resolution
Type
integer
défaut 512
Description
Résolution du maillage utilisée pour l'exportation. Plage : [64, 2048].

`output`

Sélecteur de format de fil optionnel. Par défaut glb.

Name
format
Type
string
défaut glb
Description
Ensemble d'artefacts retourné par la construction. Valeurs disponibles :
- glb (par défaut) — retourne un seul model.glb sous model_urls.glb.
- obj — compresse model.obj + model.mtl + texture.png et retourne l'ensemble sous model_urls.obj.
- zip — compresse chaque artefact émis par le générateur et retourne l'ensemble sous model_urls.bundle_zip.

Retours

La propriété result de la réponse contient l'id de tâche de la nouvelle tâche de construction d'aimant de frigo créée. Interrogez le point de terminaison Obtenir une Tâche ou abonnez-vous au flux jusqu'à ce que la tâche atteigne SUCCEEDED, puis téléchargez l'artefact à partir de l'entrée unique dans model_urls.

Modes d'Échec

Name
400 - Bad Request
Description
La requête était inacceptable. Causes courantes :
- Paramètre manquant : input_task_id est requis.
- UUID invalide : Le input_task_id n'est pas un UUID valide.
- Parent non réussi : La tâche de prototype référencée n'a pas encore atteint SUCCEEDED.
- Pas de candidat : La tâche de prototype a réussi mais n'a produit aucune image candidate.
- Options hors plage : Un des champs options est en dehors de sa plage autorisée ou de son ensemble d'énumération.
Name
401 - Unauthorized
Description
L'authentification a échoué. Veuillez vérifier votre clé API.
Name
402 - Payment Required
Description
Crédits insuffisants pour effectuer cette tâche.
Name
404 - Not Found
Description
La tâche de prototype référencée n'existe pas, appartient à un utilisateur différent, ou a été créée via l'application web (seules les tâches de prototype en mode API se chaînent dans la construction).
Name
429 - Too Many Requests
Description
Vous avez dépassé votre limite de débit.

Request

POST

/openapi/creative-lab/fridge-magnet/v1/build

# Stage 2: chain build off a succeeded prototype task
curl https://api.meshy.ai/openapi/creative-lab/fridge-magnet/v1/build \
  -X POST \
  -H "Authorization: Bearer ${YOUR_API_KEY}" \
  -H 'Content-Type: application/json' \
  -d '{
    "input_task_id": "01a3d8f1-8c2e-7d04-b223-3f3776a1c8c9",
    "options": {
      "badge_shape": "rounded-rect",
      "size_mm": 60,
      "relief_height_mm": 3.3
    },
    "output": {
      "format": "glb"
    }
  }'

Response

{
  "result": "01b4e9a2-9d3f-8e15-c334-4f4887b2d9d0"
}

Exemple de construction

La tâche de construction transforme l'image prototype sélectionnée en un modèle d'aimant de frigo imprimable en 3D.

Aperçu du modèle de construction d'aimant de frigo Creative Lab — Aperçu du modèle de construction

GET/openapi/creative-lab/fridge-magnet/v1/(prototype|build)/:id

Récupérer une tâche d'aimant de frigo

Récupérer une tâche de prototype ou de construction donnée un id de tâche valide. Le chemin URL doit correspondre à l'étape de la tâche — une tâche de construction récupérée via /prototype/:id renvoie 404, et vice versa.

Référez-vous à L'objet de tâche de prototype d'aimant de frigo et L'objet de tâche de construction d'aimant de frigo pour les formes de réponse.

Paramètres

Name
id
Type
path
Description
Identifiant unique pour la tâche d'aimant de frigo à récupérer.

Retours

La réponse contient l'objet de la tâche d'aimant de frigo. La forme dépend de l'étape demandée.

Requête

GET

/openapi/creative-lab/fridge-magnet/v1/prototype/01a3d8f1-8c2e-7d04-b223-3f3776a1c8c9

# Prototype
curl https://api.meshy.ai/openapi/creative-lab/fridge-magnet/v1/prototype/01a3d8f1-8c2e-7d04-b223-3f3776a1c8c9 \
  -H "Authorization: Bearer ${YOUR_API_KEY}"

# Build
curl https://api.meshy.ai/openapi/creative-lab/fridge-magnet/v1/build/01b4e9a2-9d3f-8e15-c334-4f4887b2d9d0 \
  -H "Authorization: Bearer ${YOUR_API_KEY}"

Réponse Prototype

{
  "id": "01a3d8f1-8c2e-7d04-b223-3f3776a1c8c9",
  "type": "creative-lab-fridge-magnet-prototype",
  "name": "",
  "status": "SUCCEEDED",
  "progress": 100,
  "created_at": 1729543210000,
  "started_at": 1729543215000,
  "finished_at": 1729543242000,
  "expires_at": 1729802442000,
  "preceding_tasks": 0,
  "task_error": null,
  "consumed_credits": 6,
  "image_urls": [
    "https://assets.meshy.ai/***/concept.png?Expires=***"
  ]
}

Réponse Construction

{
  "id": "01b4e9a2-9d3f-8e15-c334-4f4887b2d9d0",
  "type": "creative-lab-fridge-magnet-build",
  "name": "",
  "status": "SUCCEEDED",
  "progress": 100,
  "created_at": 1729543250000,
  "started_at": 1729543258000,
  "finished_at": 1729543285000,
  "expires_at": 1729802485000,
  "preceding_tasks": 0,
  "task_error": null,
  "consumed_credits": 20,
  "model_urls": {
    "glb": "https://assets.meshy.ai/***/tasks/01b4e9a2-9d3f-8e15-c334-4f4887b2d9d0/output/model.glb?Expires=***"
  }
}

DELETE/openapi/creative-lab/fridge-magnet/v1/(prototype|build)/:id

Supprimer une tâche d'aimant de frigo

Annuler une tâche d'aimant de frigo. Si la tâche est encore PENDING, les crédits consommés lors de la création sont remboursés. Les tâches qui sont déjà IN_PROGRESS sont annulées sans remboursement (le travailleur peut déjà être en train de consommer des ressources). Les tâches qui ont déjà atteint un état terminal (SUCCEEDED, FAILED, CANCELED) ne peuvent pas être annulées.

Le chemin URL doit correspondre à l'étape de la tâche — DELETE sur /prototype/:buildId renvoie 404.

Paramètres de chemin

Name
id
Type
path
Description
Identifiant unique de la tâche d'aimant de frigo à annuler.

Retours

Retourne 204 No Content en cas de succès avec un corps vide.

Modes d'échec

Name
400 - Bad Request
Description
La tâche est déjà dans un état terminal et ne peut pas être annulée.
Name
404 - Not Found
Description
La tâche n'existe pas, appartient à un autre utilisateur, ou son étape ne correspond pas au chemin URL.

Request

DELETE

/openapi/creative-lab/fridge-magnet/v1/prototype/01a3d8f1-8c2e-7d04-b223-3f3776a1c8c9

curl --request DELETE \
  --url https://api.meshy.ai/openapi/creative-lab/fridge-magnet/v1/prototype/01a3d8f1-8c2e-7d04-b223-3f3776a1c8c9 \
  -H "Authorization: Bearer ${YOUR_API_KEY}"

Response

// Returns 204 No Content on success (empty body).

GET/openapi/creative-lab/fridge-magnet/v1/(prototype|build)/:id/stream

Diffuser une tâche d'aimant de frigo

Diffusez des mises à jour en temps réel pour une tâche d'aimant de frigo via Server-Sent Events (SSE). Le chemin URL doit correspondre à l'étape de la tâche — ouvrir un flux à /prototype/:buildId/stream émet une seule charge utile event: error avec status_code: 404 et ferme le flux.

Paramètres

Name
id
Type
path
Description
Identifiant unique pour la tâche d'aimant de frigo à diffuser.

Retours

Retourne un flux d'objets de tâche Prototype d'aimant de frigo ou Construction d'aimant de frigo en tant que Server-Sent Events. Pour les tâches PENDING ou IN_PROGRESS, le flux de réponse inclura uniquement les champs nécessaires progress et status.

Request

GET

/openapi/creative-lab/fridge-magnet/v1/build/01b4e9a2-9d3f-8e15-c334-4f4887b2d9d0/stream

curl -N https://api.meshy.ai/openapi/creative-lab/fridge-magnet/v1/build/01b4e9a2-9d3f-8e15-c334-4f4887b2d9d0/stream \
-H "Authorization: Bearer ${YOUR_API_KEY}"

Response Stream

// Error event example (wrong stage or task not found)
event: error
data: {
  "status_code": 404,
  "message": "Task not found"
}

// Message event examples illustrate task progress.
// For PENDING or IN_PROGRESS tasks, the response stream will not include all fields.
event: message
data: {
  "id": "01b4e9a2-9d3f-8e15-c334-4f4887b2d9d0",
  "progress": 0,
  "status": "PENDING"
}

event: message
data: {
  "id": "01b4e9a2-9d3f-8e15-c334-4f4887b2d9d0",
  "type": "creative-lab-fridge-magnet-build",
  "status": "SUCCEEDED",
  "progress": 100,
  "created_at": 1729543250000,
  "started_at": 1729543258000,
  "finished_at": 1729543285000,
  "expires_at": 1729802485000,
  "task_error": null,
  "consumed_credits": 20,
  "model_urls": {
    "glb": "https://assets.meshy.ai/***/tasks/01b4e9a2-9d3f-8e15-c334-4f4887b2d9d0/output/model.glb?Expires=***"
  }
}

GET/openapi/creative-lab/fridge-magnet/v1/(prototype|build)

Lister les tâches d'aimant de frigo

Récupérez une liste paginée de vos tâches d'aimant de frigo pour une seule étape. Le chemin URL sélectionne l'étape — /prototype renvoie les tâches de prototype ; /build renvoie les tâches de construction. Les tâches de l'autre étape ne sont pas incluses dans l'une ou l'autre réponse.

Paramètres de chemin

Name
stage
Type
path
Requis
Description
Soit prototype soit build. La collection renvoie uniquement les tâches dont l'étape correspond à l'URL — récupérer /prototype ne renvoie jamais les tâches de construction et vice versa.

Paramètres de requête

Name
page_num
Type
integer
défaut 1
Description
Numéro de page pour la pagination.
Name
page_size
Type
integer
défaut 10
Description
Limite de taille de page. Le maximum autorisé est de 50 éléments.
Name
sort_by
Type
string
défaut -created_at
Description
Champ à trier. Valeurs disponibles :
- +created_at: Trier par heure de création par ordre croissant.
- -created_at: Trier par heure de création par ordre décroissant.

Retours

Renvoie une liste paginée de l'objet tâche par étape — soit l'objet tâche de prototype d'aimant de frigo lors de la liste /prototype ou l'objet tâche de construction d'aimant de frigo lors de la liste /build.

Request

GET

/openapi/creative-lab/fridge-magnet/v1/prototype

# List prototype tasks
curl https://api.meshy.ai/openapi/creative-lab/fridge-magnet/v1/prototype?page_size=10 \
  -H "Authorization: Bearer ${YOUR_API_KEY}"

# List build tasks
curl https://api.meshy.ai/openapi/creative-lab/fridge-magnet/v1/build?page_size=10 \
  -H "Authorization: Bearer ${YOUR_API_KEY}"

Response (List Prototype Tasks)

[
  {
    "id": "01a3d8f1-8c2e-7d04-b223-3f3776a1c8c9",
    "type": "creative-lab-fridge-magnet-prototype",
    "name": "",
    "status": "SUCCEEDED",
    "progress": 100,
    "created_at": 1729543210000,
    "started_at": 1729543215000,
    "finished_at": 1729543242000,
    "expires_at": 1729802442000,
    "preceding_tasks": 0,
    "task_error": null,
    "consumed_credits": 6,
    "image_urls": [
      "https://assets.meshy.ai/***/concept.png?Expires=***"
    ]
  }
]

L'objet de tâche du prototype d'aimant de frigo

L'objet de tâche du prototype d'aimant de frigo est une unité de travail que Meshy suit pour générer une image conceptuelle colorisée à partir d'une photo source. La sortie de cette étape est enchaînée dans l'étape de construction via input_task_id.

Propriétés

Name
id
Type
string
Description
Identifiant unique pour la tâche. Bien que nous utilisions un UUID triable par k pour les identifiants de tâche comme détail d'implémentation, vous ne devez pas faire d'hypothèses sur le format de l'identifiant.
Name
type
Type
string
Description
Type de la tâche. La valeur est creative-lab-fridge-magnet-prototype.
Name
name
Type
string
Description
Le nom de la tâche fourni lors de la création de la tâche. Chaîne vide si aucun nom n'a été fourni.
Name
status
Type
string
Description
Statut de la tâche. Les valeurs possibles sont PENDING, IN_PROGRESS, SUCCEEDED, FAILED, CANCELED.
Name
progress
Type
integer
Description
Progression de la tâche. Si la tâche n'est pas encore commencée, cette propriété sera 0. Une fois la tâche réussie, cela deviendra 100.
Name
created_at
Type
timestamp
Description
Horodatage de la création de la tâche, en millisecondes.
Un horodatage représente le nombre de millisecondes écoulées depuis le 1er janvier 1970 UTC, conformément à la norme RFC 3339. Par exemple, vendredi 1er septembre 2023 à 12:00:00 GMT est représenté par 1693569600000. Cela s'applique à tous les horodatages dans Meshy API.
Name
started_at
Type
timestamp
Description
Horodatage du début de la tâche, en millisecondes. Si la tâche n'est pas encore commencée, cette propriété sera 0.
Name
finished_at
Type
timestamp
Description
Horodatage de la fin de la tâche, en millisecondes. Si la tâche n'est pas encore terminée, cette propriété sera 0.
Name
expires_at
Type
timestamp
Description
Horodatage de l'expiration du résultat de la tâche, en millisecondes.
Name
preceding_tasks
Type
integer
Description
Le nombre de tâches précédentes.
La valeur de ce champ est significative uniquement si le statut de la tâche est PENDING.
Name
task_error
Type
object
Description
Détails des erreurs pour les tâches échouées. Voir Erreurs pour la référence complète de l'objet task_error.
Name
consumed_credits
Type
integer
Description
Le nombre de crédits consommés par cette tâche. Présent lorsque le statut de la tâche est PENDING, IN_PROGRESS, ou SUCCEEDED. Retourne 0 pour les tâches FAILED (les crédits sont remboursés en cas d'échec).
Name
image_urls
Type
array of strings
Description
URLs téléchargeables pour les candidats d'image conceptuelle générés par cette tâche prototype. Actuellement, l'API retourne toujours exactement un candidat ; le champ est un tableau afin que les révisions futures puissent présenter plusieurs candidats sans changement majeur.

Exemple d'objet de tâche du prototype d'aimant de frigo

{
  "id": "01a3d8f1-8c2e-7d04-b223-3f3776a1c8c9",
  "type": "creative-lab-fridge-magnet-prototype",
  "name": "",
  "status": "SUCCEEDED",
  "progress": 100,
  "created_at": 1729543210000,
  "started_at": 1729543215000,
  "finished_at": 1729543242000,
  "expires_at": 1729802442000,
  "preceding_tasks": 0,
  "task_error": null,
  "consumed_credits": 6,
  "image_urls": [
    "https://assets.meshy.ai/***/concept.png?Expires=***"
  ]
}

L'objet de tâche de construction d'aimant de frigo

L'objet de tâche de construction d'aimant de frigo est une unité de travail que Meshy suit pour générer le maillage final de l'aimant de frigo 3D à partir d'une tâche prototype réussie. La construction exécute un pipeline de relief de carte de profondeur sur l'image conceptuelle du prototype et publie un artefact de maillage unique dans le format demandé par l'appelant.

Propriétés

Name
id
Type
string
Description
Identifiant unique pour la tâche.
Name
type
Type
string
Description
Type de la tâche. La valeur est creative-lab-fridge-magnet-build.
Name
name
Type
string
Description
Le nom de la tâche fourni lors de la création de la tâche. Chaîne vide si aucun nom n'a été fourni.
Name
status
Type
string
Description
Statut de la tâche. Les valeurs possibles sont PENDING, IN_PROGRESS, SUCCEEDED, FAILED, CANCELED.
Name
progress
Type
integer
Description
Progression de la tâche. Si la tâche n'a pas encore commencé, cette propriété sera 0. Une fois la tâche réussie, elle deviendra 100.
Name
created_at
Type
timestamp
Description
Horodatage de la création de la tâche, en millisecondes.
Name
started_at
Type
timestamp
Description
Horodatage du début de la tâche, en millisecondes.
Name
finished_at
Type
timestamp
Description
Horodatage de la fin de la tâche, en millisecondes.
Name
expires_at
Type
timestamp
Description
Horodatage de l'expiration du résultat de la tâche, en millisecondes.
Name
preceding_tasks
Type
integer
Description
Le nombre de tâches précédentes. Significatif uniquement lorsque le statut est PENDING.
Name
task_error
Type
object
Description
Détails de l'erreur pour les tâches échouées. Voir Erreurs pour la référence complète de l'objet task_error.
Name
consumed_credits
Type
integer
Description
Le nombre de crédits consommés par cette tâche. Retourne 0 pour les tâches FAILED (les crédits sont remboursés en cas d'échec).
Name
model_urls
Type
object
Description
URL téléchargeables pour l'artefact généré, indexées par nom d'artefact. Contient toujours exactement une entrée — le format demandé via le output.format de la demande de construction. La clé correspond au format demandé :
- Name
  glb
  Type
  string
  Description
  URL téléchargeable vers le fichier GLB. Présent lorsque output.format était glb (le défaut).
- Name
  obj
  Type
  string
  Description
  URL téléchargeable vers un bundle zip contenant model.obj, model.mtl, et texture.png. Présent lorsque output.format était obj.
- Name
  bundle_zip
  Type
  string
  Description
  URL téléchargeable vers un bundle zip de chaque artefact émis par le générateur. Présent lorsque output.format était zip.

Example Fridge Magnet Build Task Object

{
  "id": "01b4e9a2-9d3f-8e15-c334-4f4887b2d9d0",
  "type": "creative-lab-fridge-magnet-build",
  "name": "",
  "status": "SUCCEEDED",
  "progress": 100,
  "created_at": 1729543250000,
  "started_at": 1729543258000,
  "finished_at": 1729543285000,
  "expires_at": 1729802485000,
  "preceding_tasks": 0,
  "task_error": null,
  "consumed_credits": 20,
  "model_urls": {
    "glb": "https://assets.meshy.ai/***/tasks/01b4e9a2-9d3f-8e15-c334-4f4887b2d9d0/output/model.glb?Expires=***"
  }
}