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,<your base64-encoded image data>.

Hint voor de onderwerpcategorie die de stylization-prompt selecteert. Beschikbare waarden:

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

Optionele tasknaam voor weergavedoeleinden. Maximaal 100 tekens.

Wanneer ingesteld op true, wordt de prototype-afbeelding geretourneerd als een transparante RGBA-PNG met de achtergrond verwijderd, zodat je het onderwerp op elke achtergrond kunt samenstellen.

Het verzoek was onacceptabel. 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 gevormd.
• Inhoud gemarkeerd: De inputafbeelding is gemarkeerd door NSFW- of intellectuele-eigendom-moderation.
• Ongeldige image_subject: Niet character / landscape.

Authenticatie mislukt. Controleer je API-sleutel.

Onvoldoende credits om deze task uit te voeren.

Je hebt je rate limit overschreden.

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

Prototypetaken die via de webapp zijn aangemaakt, worden niet geaccepteerd — de build-endpoint accepteert alleen prototypetaken die zijn geproduceerd door POST /openapi/creative-lab/lamp/v1/prototype en wijst elke andere bron af met 404.

Optionele taaknaam voor weergavedoeleinden. Maximaal 100 tekens.

Doelwaarde voor de 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 aan de onderkant vlak wordt afgesneden, zodat de lampenkap op het printbed rust en een opening heeft voor de fixture. Bereik: [1, 100].

Fixture-preset voor de lichtbron die bepaalt hoe de onderkant wordt opgebouwd. Beschikbare waarden:

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

X-as-offset van het fixture-gat op de basisplaat, ten opzichte van het middelpunt van de lampenkap, in millimeters. Alleen relevant wanneer light_source_preset ≠ none. Bereik: [-80, 80].

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

Rotatie rond de X-as die vóór de 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 de verwerking op de geïmporteerde mesh wordt toegepast, in graden. Bereik: [-360, 360].

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

Indien true en output.format is zip, wordt het result.json-bestand van de lampprocessor (pipelinenaam, waarschuwingen en artifactpaden) in het bundle opgenomen. Wordt genegeerd wanneer output.format stl is.

Artifact-bundel die door de build wordt geretourneerd. Beschikbare waarden:

• stl (standaard) — retourneert model_urls.lamp_stl (de lampenkap, samen met de basisplaat wanneer een fixture-preset is ingesteld), plus model_urls.base_stl wanneer light_source_preset ≠ none.
• zip — verpakt elk artifact dat de processor produceert (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 verwezen prototypetaak heeft SUCCEEDED nog niet bereikt.
• Geen model: De prototypetaak is geslaagd, maar heeft geen 3D-model opgeleverd.
• Options buiten bereik: Een van de options-velden viel buiten het toegestane bereik of de toegestane enum-set.

Authenticatie is mislukt. Controleer uw API-sleutel.

Onvoldoende credits om deze taak uit te voeren.

De verwezen prototypetaak bestaat niet, hoort bij een andere gebruiker, of is aangemaakt via de webapp (alleen prototypetaken in API-mode kunnen worden doorgeschakeld naar build).

U heeft uw rate limit overschreden.

Unieke identificatie voor de op te halen lamp-taak.

Unieke identifier voor de te annuleren lamp-taak.

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

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

Unieke identifier voor de te streamen lamp-taak.

Ofwel prototype ofwel build. De verzameling retourneert alleen taken waarvan de fase overeenkomt met de URL — het ophalen van /prototype levert nooit buildtaken op en omgekeerd.

Paginanummer voor paginering.

Limiet van paginagrootte. Maximaal toegestaan is 100 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 het formaat 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 wanneer de taak is aangemaakt, in milliseconden.

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

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

Tijdstempel van wanneer 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 mislukking).

Downloadbare URL's voor het 3D-model dat is gegenereerd op basis van de conceptafbeelding. 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 kandidaat-conceptafbeeldingen 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 identifier 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.

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.

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

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

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

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

Het aantal credits dat door deze taak is verbruikt. Geeft 0 terug 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: