Von deinem Bild
zum nächsten Objekt.

Ein Ablauf direkt in Ihrem Produkt.

Erstellen Sie einen Schlüssel auf dieser Seite und verwenden Sie es auf Ihrem Anwendungsserver. Definieren THINGBLOOM_API_KEY mit Ihrem Schlüssel. Platzieren Sie den Schlüssel niemals auf öffentlichen Seiten oder verteilten Anwendungen.

Generierungen erfordern ein aktives Abonnement und nutzen dasselbe Studio-Guthaben. Die Kosten pro Modell stehen auf der Tarifseite. Die Kosten für den physischen Druck fallen separat an.

1. Laden Sie ein Bild hoch.

Verwenden Sie ein sauberes Bild des Objekts mit der Form und den Farben, die Sie beibehalten möchten. Die API empfängt die hochgeladene Datei und gibt ihre Kennung zurück; Eine Veröffentlichung des Bildes ist nicht erforderlich. Verwenden Sie eine einzelne PNG-, JPG-, WebP- oder HEIC-Datei mit bis zu 10 MB.

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

2. Generierung starten.

Senden Sie die Bildkennung und die Objekteigenschaften. Die Antwort bestätigt den Empfang und enthält eine Kennung zur Nachverfolgung der Arbeit. Die Verarbeitung läuft im Hintergrund weiter.

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. Ansehen und herunterladen.

Fragen Sie die empfangene Kennung ab, bis die Verarbeitung abgeschlossen ist. Download-Adressen stehen im Ergebnis zur Verfügung, wenn die jeweilige Datei fertig ist.

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

Laden Sie die Dateien mit demselben API-Schlüssel herunter. Mit GLB können Sie das Modell in 3D visualisieren. STL enthält die Geometrie; 3MF behält die in diesem Ergebnis verfügbaren druckfertigen Daten bei.

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

Ersetzen Sie 3mf durch glb oder stl um ein anderes Format zu erhalten. Farbe und Vorbereitung ersetzen nicht die Kompatibilität mit den in der Fertigung verwendeten Geräten und Materialien.

Sichere Wiederholungen.

Verwenden Sie einen eindeutigen Idempotency-Key mit 16 bis 160 Zeichen für jede Generierung. Wenn die Verbindung abbricht, wiederholen Sie dieselbe Anfrage mit demselben Schlüssel und denselben Parametern. Erstellen Sie einen neuen Schlüssel nur für eine neue Generierung.

• Der Status kann queued, running, succeeded oder paused sein. Bei paused erlaubt retryable:true, denselben POST mit demselben Schlüssel zu wiederholen, um die gespeicherte Arbeit fortzusetzen. retryable:false bedeutet, dass Sie die bestehende Anfrage weiter verfolgen; eine unsichere Zahlungsbestätigung löst nie automatisch eine weitere Generierung aus.
• Überprüfen Sie den Fortschritt anhand der Intervalle zwischen den Anfragen. Erstellen Sie keine weitere Generation, um den Status der vorherigen zu überprüfen.
• Beachten Sie bei einer vorübergehenden Limit-Antwort Retry-After bevor Sie es erneut versuchen.
• Ein Schlüssel hat nur Zugriff auf die Bilder, Jobs und Dateien des Kontos, zu dem er gehört.
• Speichern Sie die Job-ID zusammen mit dem Auftrag Ihrer Anwendung, um die Nachverfolgung nach einer Unterbrechung fortzusetzen.

Deine API-Schlüssel.

Erstelle einen Schlüssel für deinen Server. Er wird nur einmal vollständig angezeigt; bewahre ihn sicher auf.