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 offentliga internet.
• Data URI: En base64-kodad data URI av bilden. Exempel på en data URI: data:image/jpeg;base64,<your base64-encoded image data>.

Ledtråd för ämneskategori som väljer stylization-prompten. Tillgängliga värden:

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

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

När detta är satt till true returneras prototypbilden som en transparent RGBA-PNG med bakgrunden borttagen, så att du kan sammanfoga ämnet mot valfri bakgrund.

Begäran 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 tillåtet intervall: Bilden är för liten, överskrider maximal filstorlek eller överskrider maximalt antal pixlar.
• Onåbar URL: image_url kunde inte laddas ner (404 eller timeout).
• Ogiltig Data URI: Base64-strängen är felaktigt formaterad.
• Innehåll flaggat: Inbildens innehåll flaggades av NSFW- eller immaterialrätts-moderation.
• Ogiltig image_subject: Inte en av character / landscape.

Autentiseringen misslyckades. Kontrollera din API-nyckel.

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

Du har överskridit din hastighetsgräns.

Task-ID för en prototyp-task skapad via samma OpenAPI-endpoint. Prototypen måste ha skapats med samma API-nyckel, måste ha nått SUCCEEDED och måste ha producerat en 3D-modell.

Prototyp-tasks skapade via webbappen accepteras inte — build-endpointen accepterar endast prototyp-tasks som producerats av POST /openapi/creative-lab/lamp/v1/prototype och avvisar alla andra källor med 404.

Valfritt task-namn för visningsändamål. Maximalt 100 tecken.

Måldimension (maximal) för lampskärmens begränsningsruta, 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 skärs plant vid botten, så att lampskärmen står på utskriftsbädden och har en öppning för fixturen. Intervall: [1, 100].

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

• bambu_mh001_60mm (standard) — öppen-botten lampskärm plus en bottenplatta med ett 60 mm fixture-hål, båda i model_urls.lamp_stl, och fixture-monteringen 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 fixture-hålet på bottenplattan, i förhållande till lampskärmens centrum, i millimeter. Endast meningsfullt när light_source_preset ≠ none. Intervall: [-80, 80].

Z-axelförskjutning (djup) för fixture-hålet på bottenplattan, i förhållande till lampskärmens centrum, i millimeter. Endast meningsfullt när light_source_preset ≠ none. Intervall: [-80, 80].

Rotation kring X-axeln som tillämpas på modellen innan 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 innan bearbetning, i grader. Intervall: [-360, 360].

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

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

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

• stl (standard) — returnerar model_urls.lamp_stl (lampskärmen, tillsammans med bottenplattan när en fixture-förinställning har angetts), 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.

Förfrågan var inte godtagbar. Vanliga orsaker:

• Saknad parameter: input_task_id krävs.
• Ogiltig UUID: input_task_id är inte en giltig UUID.
• Överordnad task inte lyckad: Den refererade prototyp-tasken har ännu inte nått SUCCEEDED.
• Ingen modell: Prototyp-tasken lyckades men producerade ingen 3D-modell.
• Alternativ utanför intervall: Ett av fälten i options låg utanför sitt tillåtna intervall eller uppräkningsvärde.

Autentiseringen misslyckades. Kontrollera din API-nyckel.

Otillräckligt med credits för att utföra denna task.

Den refererade prototyp-tasken finns inte, tillhör en annan användare eller skapades via webbappen (endast prototyp-tasks i API-mode kan kedjas till build).

Du har överskridit din hastighetsgräns.

Unik identifierare för lampuppgiften som ska hämtas.

Unik identifierare för lamp-uppgiften som ska avbrytas.

Uppgiften befinner sig redan i ett slutgiltigt tillstånd och kan inte avbrytas.

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

Unik identifierare för den lamp-uppgift 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.

Sidstorleksgräns. Maximalt tillåtet är 100 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:n som implementationsdetalj, bör du inte göra några antaganden om formatet på id:t.

Uppgiftens typ. 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 startats 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 startades, i millisekunder. Om uppgiften ännu inte har startats 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 för 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 uppgifter med status FAILED (credits återbetalas vid fel).

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 prototyp-uppgift. 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 brytande ändring.

Unik identifierare för uppgiften.

Typ av uppgiften. Värdet är creative-lab-lamp-build.

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 ä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. Meningsfullt endast 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, nycklade efter artefaktnamn. Uppsättningen nycklar beror på output.format och options.light_source_preset: