Creative Lab — Lampen-API

Text-prompt, der das gewünschte Lampenschirmmotiv beschreibt. Erforderlich, wenn image_url weggelassen wird. Maximal 800 Zeichen.

Quellfoto, das Meshy als visuelle Referenz für den Lampenschirm verwendet. Erforderlich, wenn text weggelassen wird. 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 zugänglich ist.
• Data URI: Eine base64-kodierte Data URI des Bildes. Beispiel einer Data URI: data:image/jpeg;base64,<your base64-encoded image data>.

Hinweis auf die Motivkategorie für den Bild-zu-3D-Pfad. Verfügbare Werte:

• character (Standard) — Einzelcharakter- / Objektmotiv (Figur, Tier, Maskottchen, etc.).
• landscape — Außenmotiv / Panoramamotiv (Berg, Stadtansicht, Wald, etc.).

Wird im Text-zu-3D-Pfad ignoriert.

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 jeden Hintergrund setzen können.

Die Anfrage war nicht akzeptabel. Häufige Ursachen:

• Fehlender Parameter: Genau eines von text oder image_url ist erforderlich.
• Beide angegeben: Die Angabe von sowohl text als auch image_url wird abgelehnt — sie schließen sich gegenseitig aus.
• Ungültiges Bildformat: Das bereitgestellte image_url ist kein unterstütztes Format (.jpg, .jpeg, .png, .webp).
• Bildabmessungen außerhalb des Bereichs: Das Bild ist zu klein, überschreitet die maximale Dateigröße oder die maximale Pixelanzahl.
• Nicht erreichbare URL: Die image_url konnte nicht heruntergeladen werden (404 oder timeout).
• Ungültige Data URI: Der base64-String ist fehlerhaft.
• Inhalt markiert: Das Eingabebild wurde von NSFW oder Moderation des geistigen Eigentums markiert.
• Text zu lang: text überschreitet 800 Zeichen.
• Ungültiges image_subject: Nicht eines von 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 Prototypaufgabe, die über diesen OpenAPI-Endpunkt erstellt wurde. Der Prototyp muss mit dem gleichen API-Schlüssel erstellt worden sein, muss SUCCEEDED erreicht haben und muss genau ein Kandidatenbild produziert haben.

Prototypaufgaben, die über die Webanwendung erstellt wurden, werden nicht akzeptiert — der Build-Endpunkt akzeptiert nur Prototypaufgaben, die durch POST /openapi/creative-lab/lamp/v1/prototype produziert wurden und lehnt jede andere Quelle mit 404 ab.

Optionaler Aufgabenname für Anzeigezwecke. Maximal 100 Zeichen.

Zielmaximaldimension des Lampenschirm-Begrenzungsrahmens in Millimetern. Das Netz wird gleichmäßig skaliert, um zu passen. Bereich: [50, 400].

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

Prozentsatz der Lampenschirmhöhe, die oben abgeflacht wird, damit der Druck auf dem Bett stehen kann. Bereich: [1, 100].

Voreinstellung der Lichtquellenbefestigung, die bestimmt, ob (und welche) Basisplatte neben dem Lampenschirm ausgegeben wird. Verfügbare Werte:

• bambu_mh001_60mm (Standard) — gibt eine 60 mm Basisplatte aus, die für eine kompatible Lichtquellenbefestigung dimensioniert ist. Das Ergebnis enthält model_urls.base_stl.
• none — keine Befestigung, keine Basisplatte. model_urls.base_stl wird weggelassen.

Horizontaler X-Achsen-Versatz der Befestigungsaussparung relativ zur Lampenschirmmitte in Millimetern. Nur sinnvoll, wenn light_source_preset ≠ none. Bereich: [-80, 80].

Vertikaler Z-Achsen-Versatz der Befestigungsaussparung relativ zum Lampenschirmboden in Millimetern. Bereich: [-80, 80].

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

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

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

Wenn true und output.format zip ist, wird das result.json des Lampenprozessors (das gemessene Netzmetriken + das aufgelöste Optionsset enthält) in das Paket aufgenommen. Wird ignoriert, wenn output.format stl ist.

Artefaktpaket, das vom Build zurückgegeben wird. Verfügbare Werte:

• stl (Standard) — gibt den Lampenschirm als model_urls.lamp_stl zurück, plus model_urls.base_stl, wenn light_source_preset ≠ none.
• zip — verpackt jedes vom Prozessor ausgegebene Artefakt (lamp.stl, optional base.stl, optional result.json) in eine einzige Zip-Datei und gibt es 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: Die input_task_id ist keine gültige UUID.
• Elternteil nicht erfolgreich: Die referenzierte Prototypaufgabe hat SUCCEEDED noch nicht erreicht.
• Kein Kandidat: Die Prototypaufgabe war erfolgreich, hat aber kein Kandidatenbild produziert.
• Optionen außerhalb des Bereichs: Eines der options-Felder fiel außerhalb des erlaubten Bereichs oder der Enum-Menge.

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

Unzureichende Credits, um diese Aufgabe auszuführen.

Die referenzierte Prototypaufgabe existiert nicht, gehört einem anderen Benutzer oder wurde über die Webanwendung erstellt (nur API-Modus-Prototypaufgaben werden in den Build übernommen).

Sie haben Ihre Ratenbegrenzung überschritten.

Eindeutiger Bezeichner für die abzurufende Lampenaufgabe.

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.

Eindeutiger Bezeichner für die zu streamende Lampe-Aufgabe.

Entweder prototype oder build. Die Sammlung gibt nur Aufgaben zurück, deren Phase mit der URL übereinstimmt — das Abrufen von /prototype gibt niemals Bauaufgaben zurück und umgekehrt.

Seitennummer für die Paginierung.

Seitengrößenlimit. Maximal erlaubt sind 50 Elemente.

Feld zum Sortieren. Verfügbare Werte:

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

Eindeutiger Bezeichner für die Aufgabe. Obwohl wir eine k-sortierbare UUID für Aufgaben-IDs als Implementierungsdetail verwenden, sollten Sie keine Annahmen über das Format der ID machen.

Typ der Aufgabe. Der Wert ist creative-lab-lamp-prototype.

Der bei der Erstellung der Aufgabe angegebene Aufgabenname. Leerer String, wenn kein Name angegeben wurde.

Status der Aufgabe. Mögliche Werte sind einer von PENDING, IN_PROGRESS, SUCCEEDED, FAILED, CANCELED.

Fortschritt der Aufgabe. Wenn die Aufgabe noch nicht begonnen hat, wird diese Eigenschaft 0 sein. Sobald die Aufgabe erfolgreich abgeschlossen ist, wird dies 100 sein.

Zeitstempel, wann die Aufgabe erstellt wurde, in Millisekunden.

Zeitstempel, wann die Aufgabe gestartet wurde, in Millisekunden. Wenn die Aufgabe noch nicht begonnen hat, wird diese Eigenschaft 0 sein.

Zeitstempel, wann die Aufgabe abgeschlossen wurde, in Millisekunden. Wenn die Aufgabe noch nicht abgeschlossen ist, wird diese Eigenschaft 0 sein.

Zeitstempel, wann das Ergebnis der Aufgabe abläuft, in Millisekunden.

Die Anzahl der vorhergehenden Aufgaben.

Fehlerdetails für fehlgeschlagene Aufgaben. Siehe Fehler für die vollständige task_error Objektreferenz.

Die Anzahl der Credits, die von dieser Aufgabe verbraucht wurden. Vorhanden, wenn der Aufgabenstatus PENDING, IN_PROGRESS oder SUCCEEDED ist. Gibt 0 für FAILED Aufgaben zurück (Credits werden bei einem Fehler zurückerstattet).

Herunterladbare URLs für die von dieser Prototyp-Aufgabe 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 eine Breaking-Änderung anzeigen können.

Eindeutiger Bezeichner für die Aufgabe.

Typ der Aufgabe. Der Wert ist creative-lab-lamp-build.

Der bei der Erstellung der Aufgabe angegebene Aufgabenname. Leerer String, wenn kein Name angegeben wurde.

Status der Aufgabe. Mögliche Werte sind einer von PENDING, IN_PROGRESS, SUCCEEDED, FAILED, CANCELED.

Fortschritt der Aufgabe. Wenn die Aufgabe noch nicht gestartet wurde, ist diese Eigenschaft 0. Sobald die Aufgabe erfolgreich abgeschlossen ist, wird dies 100.

Zeitstempel, wann die Aufgabe erstellt wurde, in Millisekunden.

Zeitstempel, wann die Aufgabe gestartet wurde, in Millisekunden.

Zeitstempel, wann die Aufgabe abgeschlossen wurde, in Millisekunden.

Zeitstempel, wann das Aufgabenergebnis abläuft, in Millisekunden.

Die Anzahl der vorhergehenden Aufgaben. Bedeutend nur, wenn der Status PENDING ist.

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

Die Anzahl der von dieser Aufgabe verbrauchten Credits. Gibt 0 für FAILED Aufgaben zurück (Credits werden bei einem Fehler zurückerstattet).

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