Creative Lab — lampa-API

Text-prompt som beskriver det önskade motivet för lampskärmen. Obligatorisk när image_url utelämnas. Högst 800 tecken.

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

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

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

Tips om motivkategori för bild-till-3D-flödet. Tillgängliga värden:

• character (standard) — enskilt karaktärs-/objektmotiv (figur, djur, maskot osv.).
• landscape — utomhusscen-/panoramamotiv (berg, stadsbild, skog osv.).

Ignoreras i text-till-3D-flödet.

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

Begäran var ogiltig. Vanliga orsaker:

• Saknad parameter: Exakt en av text eller image_url krävs.
• Båda angivna: Att skicka både text och image_url avvisas — de är ömsesidigt uteslutande.
• Ogiltigt bildformat: Den angivna image_url har inte ett format som stöds (.jpg, .jpeg, .png, .webp).
• Bildmått utanför intervallet: Bilden är för liten, överskrider den maximala filstorleken eller överskrider det maximala antalet pixlar.
• Oåtkomlig URL: image_url kunde inte laddas ner (404 eller timeout).
• Ogiltig Data URI: Base64-strängen är felaktigt formaterad.
• Innehåll flaggat: Indatabilden flaggades av NSFW- eller immaterialrätts-moderation.
• Texten är för lång: text överskrider 800 tecken.
• Ogiltigt image_subject: Inte en av character / landscape.

Autentisering misslyckades. Kontrollera din API-nyckel.

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

Du har överskridit din hastighetsgräns.

Uppgifts-ID:t för en prototypuppgift som skapats via samma OpenAPI-endpoint. Prototypen måste ha skapats med samma API-nyckel, måste ha nått SUCCEEDED och måste ha producerat exakt en kandidatbild.

Prototypuppgifter som skapats via webbappen accepteras inte — bygg-endpointen accepterar endast prototypuppgifter som producerats av POST /openapi/creative-lab/lamp/v1/prototype och avvisar alla andra källor med 404.

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

Målinställd maximal dimension för lampskärmens begränsningsruta, i millimeter. Nätet (mesh) skalas enhetligt för att passa. Intervall: [50, 400].

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

Procentandel av lampskärmens höjd som ska planas ut upptill så att utskriften kan stå på bädden. Intervall: [1, 100].

Förinställning för ljuskälleanslutning som avgör om (och vilken) basskiva som ska skapas tillsammans med lampskärmen. Tillgängliga värden:

• bambu_mh001_60mm (standard) — skapar en 60 mm basskiva dimensionerad för en kompatibel ljuskälleanslutning. Resultatet inkluderar model_urls.base_stl.
• none — ingen anslutning, ingen basskiva. model_urls.base_stl utelämnas.

Horisontell X-axelförskjutning för anslutningsurtaget relativt lampskärmens centrum, i millimeter. Endast meningsfullt när light_source_preset ≠ none. Intervall: [-80, 80].

Vertikal Z-axelförskjutning för anslutningsurtaget relativt lampskärmens botten, i millimeter. Intervall: [-80, 80].

Rotation runt X-axeln som tillämpas på det importerade nätet (mesh) före bearbetning, i grader. Intervall: [-360, 360].

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

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

När true och output.format är zip inkluderas lampprocessorns result.json (som innehåller uppmätta nätmått + den upplösta uppsättningen alternativ) i paketet. Ignoreras när output.format är stl.

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

• stl (standard) — returnerar lampskärmen som model_urls.lamp_stl, plus model_urls.base_stl när light_source_preset ≠ none.
• zip — paketerar varje artefakt som processorn skapar (lamp.stl, valfri base.stl, valfri result.json) i en enda zip och returnerar den under model_urls.bundle_zip.

Begäran var oacceptabel. Vanliga orsaker:

• Saknad parameter: input_task_id krävs.
• Ogiltigt UUID: input_task_id är inte ett giltigt UUID.
• Överordnad inte slutförd: Den refererade prototypuppgiften har inte nått SUCCEEDED ännu.
• Ingen kandidat: Prototypuppgiften lyckades men producerade ingen kandidatbild.
• Alternativ utanför intervall: Ett av fälten i options låg utanför sitt tillåtna intervall eller sin enum-uppsättning.

Autentisering misslyckades. Kontrollera din API-nyckel.

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

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

Du har överskridit din hastighetsgräns.

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

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

Uppgiften är redan i ett sluttillstå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 lampa-uppgiften som ska strömmas.

Antingen prototype eller build. Samlingen returnerar endast uppgifter vars steg matchar URL:en — hämtning av /prototype returnerar aldrig bygguppgifter och vice versa.

Sidnummer för paginering.

Gräns för sidstorlek. Högsta tillåtna ä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 ett k-sorterbart UUID för uppgifts-id:n som implementeringsdetalj, bör du inte göra några antaganden om id:ts format.

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

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 startats ännu kommer den här egenskapen att vara 0. När uppgiften har slutförts blir detta 100.

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

Tidsstämpel för när uppgiften startades, i millisekunder. Om uppgiften inte har startats ännu kommer den här egenskapen att vara 0.

Tidsstämpel för när uppgiften slutfördes, i millisekunder. Om uppgiften inte är slutförd ännu kommer den här egenskapen att vara 0.

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

Antalet föregående uppgifter.

Feldetaljer för misslyckade uppgifter. Se Fel för den fullständiga objektreferensen för task_error.

Antalet credits som förbrukas av den här uppgiften. Finns när uppgiftens status är PENDING, IN_PROGRESS eller SUCCEEDED. Returnerar 0 för FAILED-uppgifter (credits återbetalas vid fel).

Nedladdningsbara URL:er för konceptbildskandidaterna som genereras av den här prototypuppgiften. För närvarande returnerar API:t alltid exakt en kandidat; fältet är en array så att framtida revisioner kan exponera flera kandidater utan en brytande ändring.

Unik identifierare för uppgiften.

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

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

Status för uppgiften. Möjliga värden är ett av PENDING, IN_PROGRESS, SUCCEEDED, FAILED, CANCELED.

Progress för uppgiften. Om uppgiften inte har startats än kommer den här egenskapen att vara 0. När uppgiften har slutförts framgångsrikt blir den 100.

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

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

En tidsstämpel för när uppgiften slutfördes, i millisekunder.

En tidsstämpel för när uppgiftsresultatet upphör att gälla, i millisekunder.

Antalet föregående uppgifter. Meningsfullt endast när status är PENDING.

Felinformation för misslyckade uppgifter. Se Fel för den fullständiga objektreferensen för task_error.

Antalet credits som förbrukas av den här uppgiften. Returnerar 0 för FAILED-uppgifter (credits återbetalas vid fel).

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