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 anzugeben:

• Öffentlich zugängliche URL: Eine URL, die aus dem öffentlichen Internet zugänglich ist.
• Data URI: Eine base64-codierte Data URI des Bildes. Beispiel einer Data URI: data:image/jpeg;base64,<your base64-encoded image data>.

Hinweis auf die Themenkategorie, der den Stylization-prompt auswählt. Verfügbare Werte:

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

Optionaler Aufgabenname für Anzeigezwecke. Maximal 100 Zeichen.

Wenn auf true gesetzt, wird das Prototypbild als transparentes RGBA-PNG mit entferntem Hintergrund zurückgegeben, sodass Sie das Motiv auf einem 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 liegt nicht in einem unterstützten Format vor (.jpg, .jpeg, .png, .webp).
• Bildabmessungen außerhalb des Bereichs: Das Bild ist zu klein, überschreitet die maximale Dateigröße oder überschreitet die maximale Pixelanzahl.
• Nicht erreichbare URL: Die image_url konnte nicht herunterladen werden (404 oder timeout).
• Ungültige Data URI: Die base64-Zeichenkette ist fehlerhaft.
• Inhalt gekennzeichnet: Das Eingabebild wurde durch NSFW- oder Moderation für geistiges Eigentum gekennzeichnet.
• Ungültiges image_subject: Nicht character / landscape.

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

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

Sie haben Ihre Ratenbegrenzung überschritten.

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

Prototyp-Aufgaben, die über die Webapp erstellt wurden, 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 Lampenschirm-Begrenzungsrahmens, in Millimetern. Das Netz wird gleichmäßig skaliert, um sich einzupassen. Bereich: [50, 400].

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

Prozentsatz der Modellhöhe, der am Boden flach abgeschnitten wird, sodass der Lampenschirm auf dem Druckbett aufliegt und eine Öffnung für das Fixture hat. Bereich: [1, 100].

Lichtquellen-Fixture-Preset, das bestimmt, wie der Boden konstruiert wird. Verfügbare Werte:

• bambu_mh001_60mm (Standard) — offener Lampenschirmboden plus eine Grundplatte mit einem 60-mm-Fixture-Loch, beide in model_urls.lamp_stl, sowie die Fixture-Halterung als model_urls.base_stl.
• none — ein einzelner geschlossener Lampenschirm in model_urls.lamp_stl; model_urls.base_stl wird ausgelassen.

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

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

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

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

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

Wenn true und output.format gleich zip ist, wird die result.json des Lampen-Prozessors (Pipeline-Name, Warnungen und Artefaktpfade) im Bundle enthalten. 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 Fixture-Preset gesetzt ist), plus model_urls.base_stl, wenn light_source_preset ≠ none.
• zip — verpackt jedes vom Prozessor erzeugte Artefakt (lamp.stl, optional base.stl, optional result.json) in eine einzige 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 den Status SUCCEEDED noch nicht erreicht.
• Kein Modell: Die Prototyp-Aufgabe war erfolgreich, hat aber kein 3D-Modell erzeugt.
• Optionen außerhalb des gültigen Bereichs: Eines der options-Felder lag außerhalb des zulässigen Bereichs oder Enum-Wertesatzes.

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

Unzureichende 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 in einen Build verkettet werden).

Sie haben Ihre Ratenbegrenzung überschritten.

Eindeutige Kennung des abzurufenden Lampen-Tasks.

Eindeutige Kennung der abzubrechenden Lampe-Aufgabe.

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

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

Eindeutige Kennung für den zu streamenden Lampen-Task.

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

Seitennummer für die Paginierung.

Begrenzung der Seitengröße. Maximal erlaubt sind 100 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.

Eindeutige Kennung für den Task. Auch wenn 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 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 diese Eigenschaft 0. Sobald der Task erfolgreich war, wird sie 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 ist, ist diese Eigenschaft 0.

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

Die Anzahl der vorausgehenden 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 zurückerstattet).

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

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

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

Eindeutige Kennung für den Task.

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

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 dieser Wert 0. Sobald der Task erfolgreich war, wird er auf 100 gesetzt.

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 geordnet. Die Menge der Schlüssel hängt von output.format und options.light_source_preset ab: