Creative Lab — Lamp API

Bronfoto die Meshy gebruikt als visuele referentie voor de lampenkap. We ondersteunen momenteel de formaten .jpg, .jpeg, .png en .webp.

Er zijn twee manieren om de afbeelding aan te leveren:

• Openbaar toegankelijke URL: Een URL die toegankelijk is vanaf het openbare internet.
• Data URI: Een base64-gecodeerde data-URI van de afbeelding. Voorbeeld van een data-URI: data:image/jpeg;base64,<uw base64-gecodeerde afbeeldingsdata>.

Onderwerpcategorie-hint die de stylization-prompt bepaalt. Beschikbare waarden:

• character (standaard) — enkel personage/object-onderwerp (figuurtje, dier, mascotte, enz.).
• landscape — buitenscène/panorama-onderwerp (berg, stadsgezicht, bos, enz.).

Optionele taaknaam voor weergavedoeleinden. Maximaal 100 tekens.

Wanneer ingesteld op true, wordt de prototypeafbeelding geretourneerd als een transparante RGBA-PNG met de achtergrond verwijderd, zodat u het onderwerp op elke gewenste achtergrond kunt plaatsen.

Het verzoek was onaanvaardbaar. Veelvoorkomende oorzaken:

• Ontbrekende parameter: image_url is verplicht.
• Ongeldig afbeeldingsformaat: De opgegeven image_url heeft geen ondersteund formaat (.jpg, .jpeg, .png, .webp).
• Afbeeldingsafmetingen buiten bereik: De afbeelding is te klein, overschrijdt de maximale bestandsgrootte, of overschrijdt het maximale aantal pixels.
• Onbereikbare URL: De image_url kon niet worden gedownload (404 of timeout).
• Ongeldige Data URI: De base64-string is onjuist opgemaakt.
• Content gemarkeerd: De invoerafbeelding werd gemarkeerd door NSFW- of intellectuele-eigendom-moderation.
• Ongeldige image_subject: Niet een van character / landscape.

Authenticatie mislukt. Controleer uw API-sleutel.

Onvoldoende credits om deze taak uit te voeren.

U heeft uw rate limit overschreden.

De task-ID van een prototype-taak die is aangemaakt via dezelfde OpenAPI-endpoint. Het prototype moet zijn aangemaakt met dezelfde API-sleutel, moet SUCCEEDED hebben bereikt en moet een 3D-model hebben opgeleverd.

Prototype-taken die via de webapp zijn aangemaakt worden niet geaccepteerd — de build-endpoint accepteert alleen prototype-taken die zijn aangemaakt via POST /openapi/creative-lab/lamp/v1/prototype en weigert elke andere bron met 404.

Optionele taaknaam voor weergavedoeleinden. Maximaal 100 tekens.

Beoogde maximale afmeting van de bounding box van de lampenkap, in millimeters. De mesh wordt uniform geschaald om te passen. Bereik: [50, 400].

Wanddikte van de holle lampenkap, in millimeters. Bereik: (0, 10].

Percentage van de modelhoogte dat plat wordt afgesneden aan de onderkant, zodat de lampenkap op het printbed rust en een opening heeft voor de fixture. Bereik: [1, 100].

Lichtbron-fixture-preset die bepaalt hoe de onderkant wordt opgebouwd. Beschikbare waarden:

• bambu_mh001_60mm (standaard) — lampenkap met open onderkant plus een bodemplaat met een gat van 60 mm voor de fixture, beide in model_urls.lamp_stl, en de fixture-montage als model_urls.base_stl.
• none — één afgesloten lampenkap in model_urls.lamp_stl; model_urls.base_stl wordt weggelaten.

X-asverschuiving van het fixture-gat op de bodemplaat, ten opzichte van het midden van de lampenkap, in millimeters. Alleen relevant wanneer light_source_preset ≠ none. Bereik: [-80, 80].

Z-asverschuiving (diepte) van het fixture-gat op de bodemplaat, ten opzichte van het midden van de lampenkap, in millimeters. Alleen relevant wanneer light_source_preset ≠ none. Bereik: [-80, 80].

Rotatie rond de X-as die vóór verwerking op het model wordt toegepast, in graden. De drie rotaties worden toegepast als XYZ-Euler-hoeken rond het middelpunt van het model. Bereik: [-360, 360].

Rotatie rond de Y-as die vóór verwerking op de geïmporteerde mesh wordt toegepast, in graden. Bereik: [-360, 360].

Rotatie rond de Z-as die vóór verwerking op de geïmporteerde mesh wordt toegepast, in graden. Bereik: [-360, 360].

Wanneer true en output.format gelijk is aan zip, wordt het result.json-bestand van de lamp-processor (pipelinenaam, waarschuwingen en artefactpaden) in de bundel opgenomen. Wordt genegeerd wanneer output.format gelijk is aan stl.

Artefactbundel die door de build wordt geretourneerd. Beschikbare waarden:

• stl (standaard) — retourneert model_urls.lamp_stl (de lampenkap, samen met de bodemplaat wanneer een fixture-preset is ingesteld), plus model_urls.base_stl wanneer light_source_preset ≠ none.
• zip — verpakt elk artefact dat de processor genereert (lamp.stl, optioneel base.stl, optioneel result.json) in één zip-bestand en retourneert dit onder model_urls.bundle_zip.

Het verzoek was onaanvaardbaar. Veelvoorkomende oorzaken:

• Ontbrekende parameter: input_task_id is verplicht.
• Ongeldige UUID: De input_task_id is geen geldige UUID.
• Bovenliggende taak niet geslaagd: De referentie prototype-taak heeft SUCCEEDED nog niet bereikt.
• Geen model: De prototype-taak is geslaagd, maar heeft geen 3D-model opgeleverd.
• Opties buiten bereik: Een van de options-velden viel buiten het toegestane bereik of de toegestane enum-set.

Authenticatie is mislukt. Controleer je API-sleutel.

Onvoldoende credits om deze taak uit te voeren.

De referentie prototype-taak bestaat niet, behoort toe aan een andere gebruiker, of is aangemaakt via de webapp (alleen prototype-taken in API-mode kunnen worden doorgeschakeld naar build).

Je hebt je rate limit overschreden.

Unieke identifier van de op te halen lamp-taak.

Unieke identificatie voor de lamp taak om te annuleren.

De taak bevindt zich al in een eindstatus en kan niet worden geannuleerd.

De taak bestaat niet, behoort tot een andere gebruiker, of de fase komt niet overeen met het URL-pad.

Unieke identifier voor de te streamen lamp-taak.

Ofwel prototype of build. De collectie geeft alleen taken terug waarvan de fase overeenkomt met de URL — het ophalen van /prototype geeft nooit buildtaken terug en omgekeerd.

Paginanummer voor paginering.

Paginagrootte-limiet. Maximaal toegestaan is 50 items.

Veld om op te sorteren. Beschikbare waarden:

• +created_at: Sorteer op aanmaaktijd in oplopende volgorde.
• -created_at: Sorteer op aanmaaktijd in aflopende volgorde.

Unieke identifier voor de taak. Hoewel we als implementatiedetail een k-sorteerbare UUID gebruiken voor taak-id's, mag je geen aannames doen over de opmaak van de id.

Type van de taak. De waarde is creative-lab-lamp-prototype.

De taaknaam die is opgegeven bij het aanmaken van de taak. Lege string als er geen naam is opgegeven.

Status van de taak. Mogelijke waarden zijn PENDING, IN_PROGRESS, SUCCEEDED, FAILED, CANCELED.

Progress van de taak. Als de taak nog niet is gestart, is deze eigenschap 0. Zodra de taak is geslaagd, wordt dit 100.

Tijdstempel van het moment waarop de taak is aangemaakt, in milliseconden.

Tijdstempel van het moment waarop de taak is gestart, in milliseconden. Als de taak nog niet is gestart, is deze eigenschap 0.

Tijdstempel van het moment waarop de taak is voltooid, in milliseconden. Als de taak nog niet is voltooid, is deze eigenschap 0.

Tijdstempel van het moment waarop het taakresultaat verloopt, in milliseconden.

Het aantal voorafgaande taken.

Foutdetails voor mislukte taken. Zie Fouten voor de volledige referentie van het task_error-object.

Het aantal credits dat door deze taak is verbruikt. Aanwezig wanneer de taakstatus PENDING, IN_PROGRESS of SUCCEEDED is. Geeft 0 terug voor FAILED-taken (credits worden terugbetaald bij een mislukking).

Downloadbare URL's voor het 3D-model dat is gegenereerd op basis van het conceptbeeld. Aanwezig zodra de taak is geslaagd; {} daarvoor.

Downloadbare URL naar een gerenderde preview van het 3D-model. Lege string totdat de taak is geslaagd.

Downloadbare URL's voor de conceptbeeldkandidaten die door deze prototype-taak zijn gegenereerd. Momenteel geeft de API altijd precies één kandidaat terug; het veld is een array zodat toekomstige revisies meerdere kandidaten kunnen tonen zonder een breaking change.

Unieke identificatie voor de taak.

Type van de taak. De waarde is creative-lab-lamp-build.

De taaknaam die is opgegeven bij het aanmaken van de taak. Lege string als er geen naam is opgegeven.

Status van de taak. Mogelijke waarden zijn een van PENDING, IN_PROGRESS, SUCCEEDED, FAILED, CANCELED.

Voortgang van de taak. Als de taak nog niet is gestart, is deze eigenschap 0. Zodra de taak is geslaagd, wordt dit 100.

Tijdstempel van het moment waarop de taak is aangemaakt, in milliseconden.

Tijdstempel van het moment waarop de taak is gestart, in milliseconden.

Tijdstempel van het moment waarop de taak is voltooid, in milliseconden.

Tijdstempel van het moment waarop het taakresultaat verloopt, in milliseconden.

Het aantal voorafgaande taken. Alleen relevant wanneer de status PENDING is.

Foutdetails voor mislukte taken. Zie Fouten voor de volledige task_error-objectreferentie.

Het aantal credits dat door deze taak is verbruikt. Retourneert 0 voor FAILED-taken (credits worden terugbetaald bij een mislukking).

Downloadbare URL's voor de gegenereerde artefacten, gesleuteld op artefactnaam. De set sleutels hangt af van output.format en options.light_source_preset: