Creative Lab — Lampa-API

Källfoto som Meshy använder som visuell referens för lampskärmen. Vi stöder för närvarande formaten .jpg, .jpeg, .png och .webp.

Det finns två sätt att tillhandahålla bilden:

• Offentligt tillgänglig URL: En URL som är tillgänglig från det öppna internet.
• Data URI: En base64-kodad data URI av bilden. Exempel på en data URI: data:image/jpeg;base64,<your base64-encoded image data>.

Kategorihint för ämnet som väljer stylization-prompten. Tillgängliga värden:

• character (standard) — enskild karaktär/objekt-motiv (figur, djur, maskot, etc.).
• landscape — utomhusscen/panorama-motiv (berg, stadsbild, skog, etc.).

Valfritt uppgiftsnamn för visningsändamål. Maximalt 100 tecken.

När det är satt till true returneras prototypbilden som en transparent RGBA-PNG med bakgrunden borttagen, så att du kan komponera motivet mot vilken bakgrund som helst.

Förfrågan var oacceptabel. Vanliga orsaker:

• Saknad parameter: image_url krävs.
• Ogiltigt bildformat: Den angivna image_url har inte ett format som stöds (.jpg, .jpeg, .png, .webp).
• Bilddimensioner utanför intervallet: Bilden är för liten, överskrider den maximala filstorleken, eller överskrider det maximala antalet pixlar.
• Onåbar URL: image_url kunde inte hämtas (404 eller timeout).
• Ogiltig Data URI: Base64-strängen är felaktigt formaterad.
• Innehåll flaggat: Den inmatade bilden flaggades av moderation för NSFW eller immateriella rättigheter.
• Ogiltig image_subject: Inte en av character / landscape.

Autentiseringen misslyckades. Kontrollera din API-nyckel.

Otillräckliga credits för att utföra denna uppgift.

Du har överskridit din hastighetsgräns.

Jobb-ID för ett prototypjobb skapat via samma OpenAPI-endpoint. Prototypen måste ha skapats med samma API-nyckel, måste ha nått SUCCEEDED och måste ha genererat en 3D-modell.

Prototypjobb skapade via webbappen accepteras inte — byggendpointen accepterar endast prototypjobb som skapats av POST /openapi/creative-lab/lamp/v1/prototype och avvisar alla andra källor med 404.

Valfritt jobbnamn för visningsändamål. Max 100 tecken.

Målvärde för lampskärmens begränsningsrutas maximala dimension, i millimeter. Nätet skalas jämnt för att passa. Intervall: [50, 400].

Väggtjocklek för den ihåliga lampskärmen, i millimeter. Intervall: (0, 10].

Procentandel av modellens höjd som kapas plant vid botten, så att lampskärmen står stadigt på utskriftsbädden och har en öppning för fixturen. Intervall: [1, 100].

Förinställning för ljuskällans fixtur som avgör hur botten byggs. Tillgängliga värden:

• bambu_mh001_60mm (standard) — öppen botten på lampskärmen plus en basplatta med ett 60 mm fixturhål, båda i model_urls.lamp_stl, samt fixturfästet som model_urls.base_stl.
• none — en enda förseglad lampskärm i model_urls.lamp_stl; model_urls.base_stl utelämnas.

X-axelförskjutning för fixturhålet på basplattan, relativt lampskärmens centrum, i millimeter. Endast relevant när light_source_preset ≠ none. Intervall: [-80, 80].

Z-axelförskjutning (djup) för fixturhålet på basplattan, relativt lampskärmens centrum, i millimeter. Endast relevant när light_source_preset ≠ none. Intervall: [-80, 80].

Rotation kring X-axeln som tillämpas på modellen före bearbetning, i grader. De tre rotationerna tillämpas som XYZ Euler-vinklar kring modellens centrum. Intervall: [-360, 360].

Rotation kring Y-axeln som tillämpas på det importerade nätet före bearbetning, i grader. Intervall: [-360, 360].

Rotation kring Z-axeln som tillämpas på det importerade nätet före bearbetning, i grader. Intervall: [-360, 360].

När true och output.format är zip, inkluderas lampprocessorns result.json (pipelinenamn, varningar och sökvägar till artefakter) i paketet. Ignoreras när output.format är stl.

Artefaktpaket som returneras av byggjobbet. Tillgängliga värden:

• stl (standard) — returnerar model_urls.lamp_stl (lampskärmen, tillsammans med basplattan när en fixture-förinställning är satt), plus model_urls.base_stl när light_source_preset ≠ none.
• zip — paketerar varje artefakt som processorn genererar (lamp.stl, valfri base.stl, valfri result.json) i en enda zip-fil och returnerar den under model_urls.bundle_zip.

Begäran var oacceptabel. Vanliga orsaker:

• Saknad parameter: input_task_id krävs.
• Ogiltig UUID: input_task_id är inte ett giltigt UUID.
• Överordnat jobb ej lyckat: Det refererade prototypjobbet har ännu inte nått SUCCEEDED.
• Ingen modell: Prototypjobbet lyckades men genererade ingen 3D-modell.
• Alternativ utanför intervall: Ett av fälten i options låg utanför sitt tillåtna intervall eller enum-uppsättning.

Autentisering misslyckades. Kontrollera din API-nyckel.

Otillräckligt med credits för att utföra detta jobb.

Det refererade prototypjobbet finns inte, tillhör en annan användare eller skapades via webbappen (endast prototypjobb i API-läge kan kedjas till ett byggjobb).

Du har överskridit din hastighetsgräns.

Unik identifierare för den lampa-uppgift som ska hämtas.

Unikt identifierare för lampuppgiften att avbryta.

Uppgiften är redan i ett slutligt tillstånd och kan inte avbrytas.

Uppgiften existerar inte, tillhör en annan användare, eller dess steg matchar inte URL-sökvägen.

Unik identifierare för lampuppgiften som ska streamas.

Antingen prototype eller build. Samlingen returnerar endast uppgifter vars steg matchar URL:en — att hämta /prototype returnerar aldrig byggnadsuppgifter och vice versa.

Sidnummer för paginering.

Gräns för sidstorlek. Maximalt tillåtet är 50 objekt.

Fält att sortera efter. Tillgängliga värden:

• +created_at: Sortera efter skapandetid i stigande ordning.
• -created_at: Sortera efter skapandetid i fallande ordning.

Unik identifierare för uppgiften. Även om vi använder en k-sorterbar UUID för uppgifts-id som implementationsdetalj, bör du inte göra några antaganden om id:ts format.

Typ av uppgift. Värdet är creative-lab-lamp-prototype.

Uppgiftens namn som angavs när uppgiften skapades. Tom sträng om inget namn angavs.

Uppgiftens status. Möjliga värden är ett av PENDING, IN_PROGRESS, SUCCEEDED, FAILED, CANCELED.

Uppgiftens progress. Om uppgiften ännu inte har startat kommer denna egenskap att vara 0. När uppgiften har lyckats blir den 100.

Tidsstämpel för när uppgiften skapades, i millisekunder.

Tidsstämpel för när uppgiften startade, i millisekunder. Om uppgiften ännu inte har startat kommer denna egenskap att vara 0.

Tidsstämpel för när uppgiften avslutades, i millisekunder. Om uppgiften ännu inte är avslutad kommer denna egenskap att vara 0.

Tidsstämpel för när uppgiftens resultat upphör att gälla, i millisekunder.

Antalet föregående uppgifter.

Felinformation för misslyckade uppgifter. Se Fel för den fullständiga referensen till objektet task_error.

Antalet credits som förbrukats av denna uppgift. Finns när uppgiftens status är PENDING, IN_PROGRESS eller SUCCEEDED. Returnerar 0 för FAILED-uppgifter (credits återbetalas vid misslyckande).

Nedladdningsbara URL:er för 3D-modellen som genererats från konceptbilden. Finns när uppgiften har lyckats; {} innan dess.

Nedladdningsbar URL till en renderad förhandsvisning av 3D-modellen. Tom sträng tills uppgiften har lyckats.

Nedladdningsbara URL:er för de konceptbildkandidater som genererats av denna prototypuppgift. För närvarande returnerar API:et alltid exakt en kandidat; fältet är en array så att framtida revisioner kan visa flera kandidater utan en bakåtkompatibilitetsbrytande ändring.

Unik identifierare för uppgiften.

Uppgiftens typ. Värdet är creative-lab-lamp-build.

Uppgiftsnamnet som angavs när uppgiften skapades. Tom sträng om inget namn angavs.

Uppgiftens status. Möjliga värden är ett av PENDING, IN_PROGRESS, SUCCEEDED, FAILED, CANCELED.

Uppgiftens progress. Om uppgiften inte har startat ännu är denna egenskap 0. När uppgiften har lyckats blir den 100.

Tidsstämpel för när uppgiften skapades, i millisekunder.

Tidsstämpel för när uppgiften startades, i millisekunder.

Tidsstämpel för när uppgiften avslutades, i millisekunder.

Tidsstämpel för när uppgiftens resultat upphör att gälla, i millisekunder.

Antalet föregående uppgifter. Endast relevant när status är PENDING.

Feldetaljer för misslyckade uppgifter. Se Fel för den fullständiga referensen för task_error-objektet.

Antalet credits som förbrukats av denna uppgift. Returnerar 0 för FAILED-uppgifter (credits återbetalas vid misslyckande).

Nedladdningsbara URL:er för de genererade artefakterna, nyckelindelade efter artefaktnamn. Uppsättningen av nycklar beror på output.format och options.light_source_preset: