Creative Lab lamp-API

De foto waarop de lampenkap wordt gebaseerd, als een openbare URL of een Data URI (data:image/jpeg;base64,<your base64-encoded image data>).

De afbeelding moet een JPG-, JPEG-, PNG- of WebP-bestand zijn van maximaal 20 MB.

Het soort onderwerp in de foto, dat bepaalt hoe Meshy het stileert.

Beschikbare waarden:

• character: een enkel personage of object, zoals een figuurtje, een dier of een mascotte
• landscape: een buitenscène of panorama, zoals een berg, een stadsgezicht of een bos

Een naam voor de taak, van maximaal 100 tekens. Deze komt terug in het name-veld van de taak. Een langere naam geeft 400 terug.

Of de achtergrond uit de prototypeafbeelding moet worden verwijderd. true geeft een transparante RGBA-PNG terug, zodat u het onderwerp op elke achtergrond kunt plaatsen. Meshy bouwt het 3D-model ook op basis van de afbeelding zonder achtergrond. Als Meshy de achtergrond niet kan verwijderen, gebruikt het de afbeelding met achtergrond, en slaagt de taak alsnog.

De aanvraag kan niet worden uitgevoerd. Bijvoorbeeld:

• image_url ontbreekt.
• De afbeelding is geen JPG-, JPEG-, PNG- of WebP-bestand.
• De afbeelding is te klein, groter dan 20 MB, of overschrijdt het maximale aantal pixels.
• Meshy kan de afbeelding niet downloaden, bijvoorbeeld omdat de URL 404 teruggeeft of time-out geeft.
• De Data URI is geen geldige base64.
• De afbeelding is gemarkeerd als NSFW.
• image_subject is niet character of landscape.

Het foutbericht geeft aan welk probleem is gevonden. Los de aanvraag op en verstuur deze opnieuw.

De API-sleutel ontbreekt of is ongeldig. Controleer de Authorization-header.

Een van het volgende is van toepassing:

• Het account heeft onvoldoende credits.
• De API-sleutel, werkruimte of lid heeft de creditlimiet bereikt.
• Het account heeft een gratis abonnement.

Controleer uw credits en abonnement en probeer het opnieuw.

Uw team heeft IP Filtering ingeschakeld, en Meshy heeft de afbeelding gemarkeerd wegens intellectueel eigendom van derden. Stuur een afbeelding waarvoor u het gebruiksrecht hebt.

Een van deze limieten is bereikt:

• U hebt meer aanvragen verstuurd dan uw rate limit toestaat. Wacht een paar seconden en probeer het opnieuw. Zie Rate limits.
• Te veel van uw taken staan in de wachtrij of lopen al. Wacht tot enkele zijn voltooid en probeer het opnieuw.
• Bij een onbeperkt abonnement zonder resterende credits hebt u het aantal taken bereikt dat zonder credits kan worden uitgevoerd. Wacht tot een taak is voltooid, of voeg credits toe.

Meshy heeft een serverfout ondervonden, bijvoorbeeld omdat de controle op intellectueel eigendom van de afbeelding niet kon worden uitgevoerd. Meshy maakt de taak niet aan en betaalt eventueel in rekening gebrachte credits terug. Probeer de aanvraag opnieuw.

De ID van de te bouwen prototype-taak. Dit moet een taak zijn die uw account heeft aangemaakt met POST /openapi/creative-lab/lamp/v1/prototype, met de status SUCCEEDED.

Een ID die niet een van uw Lamp-prototype-taken uit de API is, geeft 404 terug, inclusief een prototype gemaakt in de web-app.

Een naam voor de taak, tot 100 tekens. Deze komt terug in het name-veld van de taak. Een langere naam geeft 400 terug.

De grootte van de grootste afmeting van de lampenkap, in millimeters, van 50 tot 400. Meshy schaalt het model gelijkmatig zodat het past. 0 gebruikt de standaardwaarde, en elke andere waarde buiten het bereik geeft 400 terug.

De wanddikte van de lampenkap, in millimeters, tot 10. 0 gebruikt de standaardwaarde, en een negatieve waarde of een waarde boven 10 geeft 400 terug.

Het percentage van de hoogte van het model dat plat wordt afgesneden aan de onderkant, van 1 tot 100. De platte onderkant zorgt ervoor dat de lampenkap op het printbed kan staan en laat ruimte voor de fixture. Een waarde buiten het bereik geeft 400 terug.

De lichtarmatuur-voorinstelling, die bepaalt hoe Meshy de onderkant bouwt.

Beschikbare waarden:

• bambu_mh001_60mm: een lampenkap met open onderkant met een bodemplaat met een bevestigingsgat van 60 mm, beide in model_urls.lamp_stl, en de bevestigingshouder in model_urls.base_stl
• none: een enkele verzegelde lampenkap in model_urls.lamp_stl, zonder model_urls.base_stl

Hoe ver het bevestigingsgat langs de X-as wordt verplaatst vanaf het midden van de lampenkap, in millimeters, van -80 tot 80. Geldt alleen wanneer light_source_preset niet none is.

Hoe ver het bevestigingsgat langs de Z-as (diepte) wordt verplaatst vanaf het midden van de lampenkap, in millimeters, van -80 tot 80. Geldt alleen wanneer light_source_preset niet none is.

De rotatie rond de X-as die op het model wordt toegepast voordat Meshy het verwerkt, in graden, van -360 tot 360. Meshy past de drie rotaties toe als XYZ Euler-hoeken rond het midden van het model.

De rotatie rond de Y-as die op het model wordt toegepast voordat Meshy het verwerkt, in graden, van -360 tot 360.

De rotatie rond de Z-as die op het model wordt toegepast voordat Meshy het verwerkt, in graden, van -360 tot 360.

Of er een result.json-bestand moet worden toegevoegd aan de zip-bundel, met de naam van de pipeline die is uitgevoerd, waarschuwingen en bestandspaden. Vereist dat output.format is ingesteld op zip. true met stl geeft 400 terug.

De bestanden die de build teruggeeft.

Beschikbare waarden:

• stl: model_urls.lamp_stl, de lampenkap met bodemplaat wanneer er een fixture-voorinstelling is, en model_urls.base_stl wanneer light_source_preset niet none is
• zip: één zip-bestand in model_urls.bundle_zip, met lamp.stl, en base.stl en result.json wanneer deze van toepassing zijn

Het verzoek kan niet worden uitgevoerd. Bijvoorbeeld:

• input_task_id ontbreekt of is geen geldige taak-ID.
• De status van de prototype-taak is niet SUCCEEDED. Als deze nog wordt uitgevoerd, wacht dan en probeer het opnieuw. Als de taak is mislukt of geannuleerd, maak dan een nieuwe prototype-taak aan.
• De prototype-taak is geslaagd maar heeft geen 3D-model. Maak een nieuwe prototype-taak aan.
• Een options-veld valt buiten het bereik of is geen beschikbare waarde.
• output.format is niet stl of zip, of include_result_json is true zonder zip.

Het foutbericht geeft aan welk probleem er is gevonden.

De API-sleutel ontbreekt of is ongeldig. Controleer de Authorization-header.

Een van het volgende is van toepassing:

• Het account heeft onvoldoende credits.
• De API-sleutel, werkruimte of het lid heeft de creditlimiet bereikt.
• Het account heeft het gratis abonnement.

Controleer uw credits en abonnement en probeer het opnieuw.

input_task_id komt niet overeen met een Lamp-prototype-taak die uw account met de API heeft aangemaakt. Een prototype gemaakt in de web-app geeft ook 404 terug. Stuur de result-ID uit een prototype-aanmaakrespons.

Een van deze limieten is bereikt:

• U hebt meer verzoeken verstuurd dan uw rate limit toestaat. Wacht een paar seconden en probeer het opnieuw. Zie Rate limits.
• Er staan te veel van uw taken in de wachtrij of lopen er te veel. Wacht tot er een paar zijn afgerond en probeer het opnieuw.
• Bij een onbeperkt abonnement zonder resterende credits hebt u het aantal taken bereikt dat zonder credits kan worden uitgevoerd. Wacht tot een taak is afgerond, of voeg credits toe.

De taak-ID uit de create-respons.

id is geen geldige taak-ID. Stuur de result-ID uit de create-respons.

Je team heeft IP Filtering ingeschakeld, en Meshy heeft de afbeelding van de prototype-taak gemarkeerd wegens intellectueel eigendom van derden. Build-taken en teams op het Enterprise-abonnement krijgen deze fout niet. Maak een prototype-taak aan met een afbeelding waarvoor je de rechten hebt.

Er bestaat geen Lamp-taak met deze ID voor jouw account, of de fase van de taak komt niet overeen met het pad. Controleer de ID en gebruik /prototype of /build om overeen te komen met de taak.

Meshy kon de controle op intellectueel eigendom niet uitvoeren. Probeer het verzoek opnieuw.

De ID van de taak die moet worden geannuleerd.

Een van de volgende is van toepassing:

• id is geen geldige taak-ID. Stuur de result-ID uit het aanmaakantwoord.
• De taak heeft al een definitieve status (SUCCEEDED, FAILED of CANCELED), dus kan niet worden geannuleerd.

Er bestaat geen lamp-taak met deze ID voor uw account, of de fase van de taak komt niet overeen met het pad. Controleer de ID en gebruik /prototype of /build om overeen te komen met de taak.

De taak-ID uit het create-antwoord.

De weer te geven fase, prototype of build.

De terug te geven pagina, van 1 tot 255. 0 geeft de eerste pagina terug. Een waarde buiten 0 tot 255 geeft 400 terug.

Aantal taken per pagina, tot 100. Een waarde van 101 tot 255 geeft 100 taken terug, en 0 gebruikt de standaardwaarde. Een waarde buiten 0 tot 255 geeft 400 terug.

De sorteervolgorde.

Beschikbare waarden:

• -created_at: nieuwste eerst
• +created_at: oudste eerst

De taak-ID. Ga niet uit van een vast formaat.

Het taaktype, altijd creative-lab-lamp-prototype.

De name die je meestuurde toen je de taak aanmaakte, of "" als je er geen hebt meegestuurd.

De status van de taak.

Beschikbare waarden:

• PENDING: wacht in de wachtrij
• IN_PROGRESS: resultaat wordt gegenereerd
• SUCCEEDED: definitief, met het resultaat
• FAILED: definitief, met de reden in task_error
• CANCELED: definitief, zonder resultaat

Percentage van het voltooide werk, van 0 tot 100. Dit is 0 totdat de taak start en 100 wanneer deze slaagt.

Tijdstip waarop de taak is aangemaakt, in Unix-milliseconden.

Tijdstip waarop een worker de taak startte, in Unix-milliseconden. null tot dat moment.

Tijdstip waarop de taak een definitieve status bereikte, in Unix-milliseconden. null tot dat moment.

Tijdstip waarop het resultaat van de taak verloopt, in Unix-milliseconden. Dit is 3 dagen na finished_at, of 3 dagen na created_at totdat de taak voltooid is. Voor Enterprise-accounts, die API-resultaten voor onbepaalde tijd bewaren, ligt dit ongeveer 100 jaar later. Zie Asset-retentie.

De positie van de taak in de wachtrij terwijl deze PENDING is. 1 betekent dat deze als volgende start. 0 nadat de taak de wachtrij verlaat, en altijd 0 in lijstresultaten.

Waarom de taak mislukte. null tenzij status gelijk is aan FAILED. Zie Fouten.

Aantal credits dat voor de taak in rekening is gebracht, na eventuele terugbetaling. Voor een verzoek dat een fout retourneert, worden geen credits in rekening gebracht. Een mislukte taak heeft 0, omdat Meshy deze terugbetaalt. Annuleren betaalt een taak alleen terug terwijl deze PENDING is. Als Meshy de kosten niet kan uitlezen, laat een get- of streamrespons het veld weg, en retourneert een lijstverzoek 500. Probeer het verzoek in dat geval opnieuw.

Download-URL's voor het 3D-model dat is gegenereerd op basis van de conceptafbeelding. {} totdat de taak slaagt.

Download-URL voor een voorbeeldafbeelding van het 3D-model. "" totdat de taak slaagt.

Download-URL's voor de conceptafbeelding. De array bevat één URL nadat de taak is geslaagd, en is leeg tot dat moment.

De taak-ID. Vertrouw niet op het formaat ervan.

Het taaktype, altijd creative-lab-lamp-build.

De name die je verstuurde toen je de taak aanmaakte, of "" als je er geen hebt meegestuurd.

De status van de taak.

Beschikbare waarden:

• PENDING: wacht in de wachtrij
• IN_PROGRESS: genereert het resultaat
• SUCCEEDED: definitief, met het resultaat
• FAILED: definitief, met de reden in task_error
• CANCELED: definitief, zonder resultaat

Percentage van het voltooide werk, van 0 tot 100. Het is 0 tot de taak begint en 100 wanneer deze slaagt.

Tijdstip waarop de taak werd aangemaakt, in Unix-milliseconden.

Tijdstip waarop een worker de taak startte, in Unix-milliseconden. null tot dat moment.

Tijdstip waarop de taak een definitieve status bereikte, in Unix-milliseconden. null tot dat moment.

Tijdstip waarop het resultaat van de taak verloopt, in Unix-milliseconden. Dit is 3 dagen na finished_at, of 3 dagen na created_at tot de taak voltooid is. Voor Enterprise-accounts, die API-resultaten onbeperkt bewaren, ligt dit ongeveer 100 jaar later. Zie Asset-retentie.

De positie van de taak in de wachtrij terwijl deze PENDING is. 1 betekent dat deze als volgende start. 0 nadat de taak de wachtrij verlaat, en altijd 0 in lijstresultaten.

Waarom de taak mislukte. null tenzij status FAILED is. Zie Fouten.

Aantal credits dat voor de taak in rekening is gebracht, na eventuele terugbetaling. Een verzoek dat een fout retourneert, wordt niet in rekening gebracht. Een mislukte taak is 0, omdat Meshy deze terugbetaalt. Annuleren betaalt een taak alleen terug terwijl deze PENDING is. Als Meshy de kosten niet kan lezen, laat een get- of streamrespons het veld weg, en een lijstverzoek geeft 500 terug. Probeer het verzoek in dat geval opnieuw.

Downloadlinks voor de afdrukbare bestanden. Welke sleutels verschijnen, hangt af van output.format en options.light_source_preset.