À partir de votre image
à l'objet suivant.

Un flux, au sein de votre produit.

Créer une clé sur cette page et utilisez-le sur votre serveur d'applications. Définir THINGBLOOM_API_KEY avec votre clé. Ne placez jamais la clé sur des pages publiques ou des applications distribuées.

Les générations nécessitent un abonnement actif et utilisent le même solde de crédits du studio. Le coût par modèle figure sur la page des offres. Le coût de l’impression physique est distinct.

1. Importez une image.

Utilisez une image nette de l'objet, avec la forme et les couleurs que vous souhaitez conserver. L'API reçoit le fichier téléchargé et renvoie son identifiant ; Il n'est pas nécessaire de rendre l'image publique. Utilisez un seul fichier PNG, JPG, WebP ou HEIC jusqu'à 10 Mo.

curl "https://thingbloom.com/api/v1/uploads" \
  -H "Authorization: Bearer $THINGBLOOM_API_KEY" \
  -F "file=@objeto.png"

2. Démarrez la génération.

Envoyez l'identifiant de l'image et les caractéristiques de l'objet. La réponse accuse réception et comprend un identifiant permettant de suivre l'œuvre. Le traitement se poursuit en arrière-plan.

curl "https://thingbloom.com/api/v1/generations" \
  -H "Authorization: Bearer $THINGBLOOM_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: exemplo-vaso-00000001" \
  -d '{
    "imageId": "ID_RETORNADO_PELO_UPLOAD",
    "title": "Meu vaso",
    "colorCount": 2,
    "material": "pla",
    "maxDimensionMm": 100,
    "purpose": "decorative",
    "palette": ["#F5F5F5", "#0086D6"],
    "rightsConfirmed": true
  }'

3. Visualisez et téléchargez.

Interrogez l’identifiant reçu jusqu’à la fin du traitement. Les adresses de téléchargement sont disponibles dans le résultat lorsque le fichier respectif est prêt.

curl "https://thingbloom.com/api/v1/generations/ID_DA_GERACAO" \
  -H "Authorization: Bearer $THINGBLOOM_API_KEY"

Téléchargez les fichiers en utilisant la même clé API. GLB permet de visualiser le modèle en 3D ; STL contient la géométrie ; 3MF préserve les données prêtes à imprimer disponibles dans ce résultat.

curl "https://thingbloom.com/api/v1/generations/ID_DA_GERACAO/files/3mf" \
  -H "Authorization: Bearer $THINGBLOOM_API_KEY" \
  --output modelo.3mf

Remplacez 3mf par glb ou stl pour obtenir un autre format. La couleur et la préparation ne remplacent pas la compatibilité avec l’équipement et le matériau utilisés pour la fabrication.

Relances sûres.

Utilisez une Idempotency-Key unique, de 16 à 160 caractères, pour chaque génération. Si la connexion est interrompue, répétez la même requête avec la même clé et les mêmes paramètres. Créez une autre clé uniquement pour une nouvelle génération.

• L’état peut être queued, running, succeeded ou paused. En paused, retryable:true permet de répéter le même POST avec la même clé pour reprendre le travail enregistré. retryable:false vous demande de suivre la requête existante ; une confirmation de facturation incertaine ne déclenche jamais une autre génération automatique.
• Vérifiez la progression avec des intervalles entre les demandes ; ne créez pas une autre génération pour vérifier l’état de la précédente.
• Après une réponse de limite temporaire, respectez Retry-After avant de réessayer.
• Une clé n'a accès qu'aux images, tâches et fichiers du compte auquel elle appartient.
• Conservez l’ID du travail avec la commande de votre application pour reprendre le suivi après une interruption.

Vos clés API.

Créez une clé pour votre serveur. Elle n’est affichée intégralement qu’une fois ; conservez-la en lieu sûr.