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 l'internet public.
• Data URI : une donnée URI de l'image encodée en base64. 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 stylisation. Valeurs disponibles :

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

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

Lorsque 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 : 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 maximal de pixels.
• URL inaccessible : 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 modération NSFW ou de propriété intellectuelle.
• image_subject invalide : n'est ni character ni landscape.

Échec de l'authentification. 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. Maximum 100 caractères.

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'y 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 en bas, 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 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 comportant un trou de fixation de 60 mm, les deux dans model_urls.lamp_stl, et le support de fixation dans model_urls.base_stl.
• none — un seul 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. N'a de sens que 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. N'a de sens que lorsque light_source_preset ≠ none. Plage : [-80, 80].

Rotation autour de l'axe X appliquée au modèle avant 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 traitement, en degrés. Plage : [-360, 360].

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

Lorsque true et que output.format vaut zip, inclut le result.json du processeur de lampe (nom du pipeline, avertissements et chemins des artefacts) dans le paquet. Ignoré lorsque output.format vaut stl.

Paquet 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 chaque artefact émis par le processeur (lamp.stl, base.stl optionnel, result.json optionnel) dans un seul fichier 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 : 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 limites : l'un des champs de options se situe en dehors 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 être enchaînées avec 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 de 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 utilisateur différent, ou son étape ne correspond pas au chemin URL.

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

prototype ou 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 construction, et inversement.

Numéro de page pour la pagination.

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

Champ selon lequel trier. Valeurs disponibles :

• +created_at : trier par date de création par ordre croissant.
• -created_at : trier par date 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 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. 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 d'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. Retourne 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 exposer 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 d'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 :