Creative Lab — Lampe-API

Quellfoto, das Meshy als visuelle Referenz für den Lampenschirm verwendet. Wir unterstützen derzeit die Formate .jpg, .jpeg, .png und .webp.

Es gibt zwei Möglichkeiten, das Bild bereitzustellen:

• Öffentlich zugängliche URL: Eine URL, die aus dem öffentlichen Internet erreichbar ist.
• Data URI: Eine base64-kodierte Data URI des Bildes. Beispiel für eine Data URI: data:image/jpeg;base64,<Ihre base64-kodierten Bilddaten>.

Hinweis zur Themenkategorie, der den Stilisierungs-Prompt auswählt. Verfügbare Werte:

• character (Standard) — einzelnes Charakter-/Objekt-Thema (Figur, Tier, Maskottchen usw.).
• landscape — Außenszene/Panorama-Thema (Berg, Stadtlandschaft, Wald usw.).

Optionaler Task-Name für Anzeigezwecke. Maximal 100 Zeichen.

Wenn auf true gesetzt, wird das Prototyp-Bild als transparentes RGBA-PNG mit entferntem Hintergrund zurückgegeben, sodass Sie das Motiv auf einen beliebigen Hintergrund zusammensetzen können.

Die Anfrage war nicht akzeptabel. Häufige Ursachen:

• Fehlender Parameter: image_url ist erforderlich.
• Ungültiges Bildformat: Die angegebene image_url hat kein unterstütztes Format (.jpg, .jpeg, .png, .webp).
• Bildabmessungen außerhalb des zulässigen Bereichs: Das Bild ist zu klein, überschreitet die maximale Dateigröße oder überschreitet die maximale Pixelanzahl.
• Nicht erreichbare URL: Die image_url konnte nicht heruntergeladen werden (404 oder timeout).
• Ungültige Data URI: Die base64-Zeichenkette ist fehlerhaft.
• Inhalt markiert: Das Eingabebild wurde durch die NSFW- oder Urheberrechts-moderation markiert.
• Ungültiges image_subject: Nicht character / landscape.

Authentifizierung fehlgeschlagen. Bitte überprüfen Sie Ihren API-Schlüssel.

Unzureichende Credits, um diese Aufgabe auszuführen.

Sie haben Ihre Ratenbegrenzung überschritten.

Die Aufgaben-ID einer über denselben OpenAPI-Endpunkt erstellten Prototyp-Aufgabe. Der Prototyp muss mit demselben API-Schlüssel erstellt worden sein, muss SUCCEEDED erreicht haben und muss ein 3D-Modell erzeugt haben.

Über die Webapp erstellte Prototyp-Aufgaben werden nicht akzeptiert — der Build-Endpunkt akzeptiert nur Prototyp-Aufgaben, die von POST /openapi/creative-lab/lamp/v1/prototype erzeugt wurden, und lehnt jede andere Quelle mit 404 ab.

Optionaler Aufgabenname zu Anzeigezwecken. Maximal 100 Zeichen.

Angestrebte maximale Abmessung des Begrenzungsrahmens des Lampenschirms, in Millimetern. Das Netz wird gleichmäßig skaliert, um hineinzupassen. Bereich: [50, 400].

Wandstärke des hohlen Lampenschirms, in Millimetern. Bereich: (0, 10].

Prozentualer Anteil der Modellhöhe, der am Boden flach abgeschnitten wird, damit der Lampenschirm auf dem Druckbett aufliegt und eine Öffnung für die Fassung hat. Bereich: [1, 100].

Voreinstellung für die Lichtquellenfassung, die bestimmt, wie der Boden gebaut wird. Verfügbare Werte:

• bambu_mh001_60mm (Standard) — offener Lampenschirm plus eine Grundplatte mit einem 60-mm-Fassungsloch, beide in model_urls.lamp_stl, sowie die Fassungshalterung als model_urls.base_stl.
• none — ein einzelner geschlossener Lampenschirm in model_urls.lamp_stl; model_urls.base_stl entfällt.

X-Achsen-Versatz des Fassungslochs auf der Grundplatte relativ zur Mitte des Lampenschirms, in Millimetern. Nur relevant, wenn light_source_preset ≠ none. Bereich: [-80, 80].

Z-Achsen-Versatz (Tiefe) des Fassungslochs auf der Grundplatte relativ zur Mitte des Lampenschirms, in Millimetern. Nur relevant, wenn light_source_preset ≠ none. Bereich: [-80, 80].

Vor der Verarbeitung auf das Modell angewendete Rotation um die X-Achse, in Grad. Die drei Rotationen werden als XYZ-Euler-Winkel um die Mitte des Modells angewendet. Bereich: [-360, 360].

Vor der Verarbeitung auf das importierte Netz angewendete Rotation um die Y-Achse, in Grad. Bereich: [-360, 360].

Vor der Verarbeitung auf das importierte Netz angewendete Rotation um die Z-Achse, in Grad. Bereich: [-360, 360].

Wenn true und output.format gleich zip ist, wird die result.json des Lampenprozessors (Pipeline-Name, Warnungen und Pfade der Artefakte) im Bundle enthalten sein. Wird ignoriert, wenn output.format gleich stl ist.

Vom Build zurückgegebenes Artefakt-Bundle. Verfügbare Werte:

• stl (Standard) — gibt model_urls.lamp_stl zurück (den Lampenschirm, zusammen mit der Grundplatte, wenn ein Fassungs-Preset gesetzt ist), sowie model_urls.base_stl, wenn light_source_preset ≠ none.
• zip — verpackt alle vom Prozessor erzeugten Artefakte (lamp.stl, optional base.stl, optional result.json) in einer einzigen ZIP-Datei und gibt sie unter model_urls.bundle_zip zurück.

Die Anfrage war nicht akzeptabel. Häufige Ursachen:

• Fehlender Parameter: input_task_id ist erforderlich.
• Ungültige UUID: input_task_id ist keine gültige UUID.
• Übergeordnete Aufgabe nicht erfolgreich: Die referenzierte Prototyp-Aufgabe hat SUCCEEDED noch nicht erreicht.
• Kein Modell: Die Prototyp-Aufgabe war erfolgreich, hat aber kein 3D-Modell erzeugt.
• Optionen außerhalb des zulässigen Bereichs: Eines der options-Felder lag außerhalb seines zulässigen Bereichs oder Enum-Wertesatzes.

Die Authentifizierung ist fehlgeschlagen. Bitte überprüfen Sie Ihren API-Schlüssel.

Nicht genügend Credits, um diese Aufgabe auszuführen.

Die referenzierte Prototyp-Aufgabe existiert nicht, gehört einem anderen Benutzer oder wurde über die Webapp erstellt (nur Prototyp-Aufgaben im API-Modus können mit einem Build verkettet werden).

Sie haben Ihre Ratenbegrenzung überschritten.

Eindeutige Kennung der abzurufenden Lampen-Aufgabe.

Eindeutiger Bezeichner für die zu stornierende Lampenaufgabe.

Die Aufgabe befindet sich bereits in einem Endstatus und kann nicht abgebrochen werden.

Die Aufgabe existiert nicht, gehört einem anderen Benutzer oder ihre Phase stimmt nicht mit dem URL-Pfad überein.

Eindeutige Kennung des zu streamenden Lampen-Tasks.

Entweder prototype oder build. Die Sammlung liefert nur Aufgaben zurück, deren Stufe mit der URL übereinstimmt — das Abrufen von /prototype liefert niemals Build-Aufgaben zurück und umgekehrt.

Seitennummer für die Paginierung.

Maximale Seitengröße. Erlaubt sind maximal 50 Einträge.

Feld, nach dem sortiert werden soll. Verfügbare Werte:

• +created_at: Sortierung nach Erstellungszeit in aufsteigender Reihenfolge.
• -created_at: Sortierung nach Erstellungszeit in absteigender Reihenfolge.

Eindeutiger Bezeichner für den Task. Obwohl wir als Implementierungsdetail eine k-sortierbare UUID für Task-IDs verwenden, solltest du keine Annahmen über das Format der ID treffen.

Typ des Tasks. Der Wert ist creative-lab-lamp-prototype.

Der Task-Name, der bei der Erstellung des Tasks angegeben wurde. Leerer String, wenn kein Name angegeben wurde.

Status des Tasks. Mögliche Werte sind PENDING, IN_PROGRESS, SUCCEEDED, FAILED, CANCELED.

Fortschritt des Tasks. Wenn der Task noch nicht gestartet wurde, ist diese Eigenschaft 0. Sobald der Task erfolgreich abgeschlossen wurde, wird sie zu 100.

Zeitstempel der Erstellung des Tasks, in Millisekunden.

Zeitstempel des Starts des Tasks, in Millisekunden. Wenn der Task noch nicht gestartet wurde, ist diese Eigenschaft 0.

Zeitstempel des Abschlusses des Tasks, in Millisekunden. Wenn der Task noch nicht abgeschlossen wurde, ist diese Eigenschaft 0.

Zeitstempel, zu dem das Task-Ergebnis abläuft, in Millisekunden.

Die Anzahl der vorangehenden Tasks.

Fehlerdetails für fehlgeschlagene Tasks. Siehe Fehler für die vollständige Referenz des task_error-Objekts.

Die Anzahl der von diesem Task verbrauchten Credits. Vorhanden, wenn der Task-Status PENDING, IN_PROGRESS oder SUCCEEDED ist. Gibt 0 für FAILED-Tasks zurück (Credits werden bei einem Fehlschlag erstattet).

Herunterladbare URLs für das aus dem Konzeptbild generierte 3D-Modell. Vorhanden, sobald der Task erfolgreich abgeschlossen wurde; davor {}.

Herunterladbare URL zu einer gerenderten Vorschau des 3D-Modells. Leerer String, bis der Task erfolgreich abgeschlossen wurde.

Herunterladbare URLs für die von diesem Prototyp-Task generierten Konzeptbild-Kandidaten. Derzeit gibt die API immer genau einen Kandidaten zurück; das Feld ist ein Array, damit zukünftige Überarbeitungen mehrere Kandidaten ohne Breaking Change bereitstellen können.

Eindeutige Kennung für den Task.

Typ des Tasks. Der Wert ist creative-lab-lamp-build.

Der beim Erstellen des Tasks angegebene Task-Name. Leerer String, wenn kein Name angegeben wurde.

Status des Tasks. Mögliche Werte sind PENDING, IN_PROGRESS, SUCCEEDED, FAILED, CANCELED.

Fortschritt des Tasks. Wenn der Task noch nicht gestartet wurde, ist dieser Wert 0. Sobald der Task erfolgreich abgeschlossen wurde, wird dieser Wert 100.

Zeitstempel der Erstellung des Tasks, in Millisekunden.

Zeitstempel des Starts des Tasks, in Millisekunden.

Zeitstempel des Abschlusses des Tasks, in Millisekunden.

Zeitstempel, wann das Ergebnis des Tasks abläuft, in Millisekunden.

Die Anzahl der vorausgehenden Tasks. Nur relevant, wenn der Status PENDING ist.

Fehlerdetails für fehlgeschlagene Tasks. Siehe Fehler für die vollständige Referenz des task_error-Objekts.

Die Anzahl der von diesem Task verbrauchten Credits. Gibt 0 für FAILED-Tasks zurück (Credits werden bei einem Fehlschlag zurückerstattet).

Herunterladbare URLs für die generierten Artefakte, nach Artefaktname geschlüsselt. Die Menge der Schlüssel hängt von output.format und options.light_source_preset ab: