Creative Lab — API lampe

Photo source que Meshy utilise comme référence visuelle pour l'abat-jour. Nous prenons actuellement en charge les formats .jpg, .jpeg, .png et .webp.

Il existe deux façons de fournir l'image :

• URL accessible publiquement : une URL accessible depuis Internet public.
• Data URI : une Data URI encodée en base64 de l'image. Exemple de Data URI : data:image/jpeg;base64,<vos données d'image encodées en base64>.

Indice de catégorie de sujet qui sélectionne le prompt de stylization. Valeurs disponibles :

• character (par défaut) — sujet unique de personnage / objet (figurine, animal, mascotte, etc.).
• landscape — sujet de scène extérieure / panorama (montagne, paysage urbain, forêt, etc.).

Nom de tâche optionnel à des fins d'affichage. Maximum 100 caractères.

Lorsqu'il est défini sur true, l'image de prototype est renvoyée sous forme de PNG RGBA transparent avec l'arrière-plan supprimé, afin que vous puissiez composer le sujet sur n'importe quel arrière-plan.

La requête était inacceptable. Causes courantes :

• Paramètre manquant : image_url est requis.
• Format d'image invalide : l'image_url fourni n'est pas dans un format pris en charge (.jpg, .jpeg, .png, .webp).
• Dimensions d'image hors limites : l'image est trop petite, dépasse la taille de fichier maximale ou dépasse le nombre de pixels maximal.
• URL inaccessible : l'image_url n'a pas pu être téléchargée (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.
• image_subject invalide : ne correspond pas à character / landscape.

L'authentification a échoué. Veuillez vérifier votre clé API.

Crédits insuffisants pour effectuer cette tâche.

Vous avez dépassé votre limite de débit.

L'ID de tâche d'une tâche de prototype créée 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 un modèle 3D.

Les tâches de prototype créées via l'application web ne sont pas acceptées — le point de terminaison de build n'accepte que les tâches de prototype produites par POST /openapi/creative-lab/lamp/v1/prototype et refuse toute autre source avec 404.

Nom de tâche optionnel à des fins d'affichage. 100 caractères maximum.

Dimension maximale cible de la boîte englobante de l'abat-jour, en millimètres. Le maillage est mis à l'échelle uniformément pour s'adapter. Plage : [50, 400].

Épaisseur de paroi de l'abat-jour creux, en millimètres. Plage : (0, 10].

Pourcentage de la hauteur du modèle coupé à plat au fond, afin que l'abat-jour repose sur le plateau d'impression et dispose d'une ouverture pour la fixation. Plage : [1, 100].

Préréglage de fixation de la source lumineuse qui détermine comment le fond est construit. Valeurs disponibles :

• bambu_mh001_60mm (par défaut) — abat-jour à fond ouvert plus une plaque de base portant un trou de fixation de 60 mm, les deux dans model_urls.lamp_stl, et le support de fixation en tant que model_urls.base_stl.
• none — un unique abat-jour scellé dans model_urls.lamp_stl ; model_urls.base_stl est omis.

Décalage sur l'axe X du trou de fixation sur la plaque de base, par rapport au centre de l'abat-jour, en millimètres. Uniquement significatif lorsque light_source_preset ≠ none. Plage : [-80, 80].

Décalage sur l'axe Z (profondeur) du trou de fixation sur la plaque de base, par rapport au centre de l'abat-jour, en millimètres. Uniquement significatif lorsque light_source_preset ≠ none. Plage : [-80, 80].

Rotation autour de l'axe X appliquée au modèle avant le traitement, en degrés. Les trois rotations sont appliquées comme des angles d'Euler XYZ autour du centre du modèle. Plage : [-360, 360].

Rotation autour de l'axe Y appliquée au maillage importé avant le traitement, en degrés. Plage : [-360, 360].

Rotation autour de l'axe Z appliquée au maillage importé avant le traitement, en degrés. Plage : [-360, 360].

Lorsque true et que output.format est zip, inclut le result.json du processeur de lampe (nom du pipeline, avertissements et chemins des artefacts) à l'intérieur du bundle. Ignoré lorsque output.format est stl.

Bundle d'artefacts renvoyé par le build. Valeurs disponibles :

• stl (par défaut) — renvoie model_urls.lamp_stl (l'abat-jour, avec la plaque de base lorsqu'un préréglage de fixation est défini), plus model_urls.base_stl lorsque light_source_preset ≠ none.
• zip — regroupe tous les artefacts émis par le processeur (lamp.stl, base.stl optionnel, result.json optionnel) dans un seul zip et le renvoie sous model_urls.bundle_zip.

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.
• Aucun modèle : la tâche de prototype a réussi mais n'a produit aucun modèle 3D.
• Options hors plage : l'un des champs options sortait de sa plage autorisée ou de son ensemble d'énumération.

L'authentification a échoué. Veuillez vérifier votre clé API.

Crédits insuffisants pour effectuer cette tâche.

La tâche de prototype référencée n'existe pas, appartient à un autre utilisateur, ou a été créée via l'application web (seules les tâches de prototype en mode API peuvent s'enchaîner vers un build).

Vous avez dépassé votre limite de débit.

Identifiant unique de la tâche de lampe à récupérer.

Identifiant unique de la tâche lampe à annuler.

La tâche est déjà dans un état terminal et ne peut pas être annulée.

La tâche n'existe pas, appartient à un autre utilisateur, ou son étape ne correspond pas au chemin de l'URL.

Identifiant unique de la tâche de lampe à diffuser.

Soit prototype, soit build. La collection ne renvoie que les tâches dont l'étape correspond à l'URL — récupérer /prototype ne renvoie jamais de tâches de génération, et inversement.

Numéro de page pour la pagination.

Limite de taille de page. Le maximum autorisé est de 100 éléments.

Champ selon lequel 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.

Identifiant unique de la tâche. Bien que nous utilisions un UUID triable en k comme détail d'implémentation pour les identifiants de tâche, vous ne devez pas faire d'hypothèses sur le format de l'id.

Type de la tâche. La valeur est creative-lab-lamp-prototype.

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.

Statut de la tâche. Les valeurs possibles sont PENDING, IN_PROGRESS, SUCCEEDED, FAILED, CANCELED.

Progression de la tâche. Si la tâche n'a pas encore démarré, cette propriété sera 0. Une fois que la tâche a réussi, elle deviendra 100.

Horodatage de la création de la tâche, en millisecondes.

Horodatage du démarrage de la tâche, en millisecondes. Si la tâche n'a pas encore démarré, cette propriété sera 0.

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.

Horodatage de l'expiration du résultat de la tâche, en millisecondes.

Le nombre de tâches précédentes.

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.

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. Renvoie 0 pour les tâches FAILED (les crédits sont remboursés en cas d'échec).

URLs téléchargeables pour le modèle 3D généré à partir de l'image conceptuelle. Présent une fois que la tâche a réussi ; {} avant cela.

URL téléchargeable vers un aperçu rendu du modèle 3D. Chaîne vide jusqu'à ce que la tâche ait réussi.

URLs téléchargeables pour les candidats d'image conceptuelle générés par cette tâche de prototype. Actuellement, l'API renvoie toujours exactement un candidat ; le champ est un tableau afin que de futures révisions puissent proposer plusieurs candidats sans rupture de compatibilité.

Identifiant unique de la tâche.

Type de la tâche. La valeur est creative-lab-lamp-build.

Le nom de la tâche fourni lors de sa création. Chaîne vide si aucun nom n'a été fourni.

Statut de la tâche. Les valeurs possibles sont PENDING, IN_PROGRESS, SUCCEEDED, FAILED, CANCELED.

Progression de la tâche. Si la tâche n'a pas encore démarré, cette propriété sera 0. Une fois la tâche réussie, elle deviendra 100.

Horodatage de la création de la tâche, en millisecondes.

Horodatage du démarrage de la tâche, en millisecondes.

Horodatage de la fin de la tâche, en millisecondes.

Horodatage de l'expiration du résultat de la tâche, en millisecondes.

Le nombre de tâches précédentes. Pertinent uniquement lorsque le statut est PENDING.

Détails de l'erreur pour les tâches échouées. Consultez Erreurs pour la référence complète de l'objet task_error.

Le nombre de crédits consommés par cette tâche. Renvoie 0 pour les tâches FAILED (les crédits sont remboursés en cas d'échec).

URLs téléchargeables pour les artefacts générés, indexées par nom d'artefact. L'ensemble des clés dépend de output.format et de options.light_source_preset :